llms.txt
Compare with other sites' llms.txt files →# Wado
> Type-safe like Rust, familiar like TypeScript, compiled to clean Wasm.
Wado is a statically-typed, garbage-collected language that targets exactly one platform: WebAssembly. It compiles to a Wasm component (Wasm 3.0 with GC), speaks the Component Model and WASI 0.3, and replaces the borrow checker with value semantics plus an effect system. Most of the syntax is Rust-compatible by design.
Every link to a page points at Markdown; the same page is published as HTML at the same path, with `.html` in place of `.md`. The two links to a directory (`/docs/`, `/playground/`) are HTML. Two families are large enough to be left out of this index and are addressed by slug instead: the Wado Evolution Proposals, one per language feature, at `/docs/wep-<date>-<name>.md`, and the research notes behind them at `/docs/research-<name>.md`. The documentation index linked under `## Optional` lists both.
## Start here
- [Cheatsheet](https://wado-lang.org/docs/cheatsheet.md): the whole syntax in one page — enough to write Wado without reading anything else
- [Language specification](https://wado-lang.org/docs/spec-overview.md): the normative reference, one page per area of the language; this overview says what it promises, and the chapters follow under Specification
- [Design philosophy](https://wado-lang.org/docs/design-philosophy.md): why Wado is shaped the way it is
- [Playground](https://wado-lang.org/playground/): compiler, language server, and the program itself, all running in the browser
## Specification
- [Lexical Structure](https://wado-lang.org/docs/spec-lexical.md): This chapter covers how source text splits into tokens: whitespace, comments, the shebang and the data section, identifiers, and keywords.
- [Literals](https://wado-lang.org/docs/spec-literals.md): This chapter covers the values a program writes directly: booleans, `null`, characters, numbers, strings and byte strings, template strings and their format specifiers, tuple, list and object…
- [Statements and Expressions](https://wado-lang.org/docs/spec-expressions.md): A function body is a sequence of statements.
- [Types](https://wado-lang.org/docs/spec-types.md): This chapter covers the types a program declares values of: the primitives, strings, tuples, lists, the never type, newtypes, structs, enums, variants and flags, and how type arguments are inferred.
- [Patterns](https://wado-lang.org/docs/spec-patterns.md): A pattern tests a value's shape and binds names to its parts.
- [Control Flow](https://wado-lang.org/docs/spec-control-flow.md): This chapter covers what decides which code runs next: conditionals, loops, `break` and `continue`, labeled blocks, `match` and `matches`, branch hints, and error handling.
- [Assertions](https://wado-lang.org/docs/spec-assertions.md): `assert` checks a condition while a program runs.
- [Functions](https://wado-lang.org/docs/spec-functions.md): This chapter covers functions and what calls them: declarations and calls, methods, generic functions, closures and function values, and default arguments.
- [Memory Model](https://wado-lang.org/docs/spec-memory.md): This chapter covers how values are copied and shared: value semantics, references, and how parameters and receivers hold their arguments.
- [Traits](https://wado-lang.org/docs/spec-traits.md): A trait names methods that types implement.
- [Standard Traits](https://wado-lang.org/docs/spec-standard-traits.md): The prelude declares the traits below, and the language gives each a role: `for-of` reads `IntoIterator`, `==` and `<` read `Eq` and `Ord`, `a + b` reads `Add`, and `xi` reads the indexing traits.
- [Static Reflection](https://wado-lang.org/docs/spec-reflection.md): Reflection lets library code read a type's name and structure.
- [Effect System](https://wado-lang.org/docs/spec-effects.md): An effect is a capability a function uses, such as writing to standard output.
- [Module System](https://wado-lang.org/docs/spec-modules.md): A module is one Wado file.
- [Packages](https://wado-lang.org/docs/spec-packages.md): A package is a set of modules that is built, versioned and depended on as one unit.
- [Kiln Generators](https://wado-lang.org/docs/spec-kiln.md): Kiln is Wado's compiler plugin mechanism for generated imports.
- [Worlds and Entry Points](https://wado-lang.org/docs/spec-worlds.md): A Wado program targets one world.
- [Components](https://wado-lang.org/docs/spec-components.md): A Wado program compiles to a Component Model component.
- [Serialization](https://wado-lang.org/docs/spec-serialization.md): `core:serde` is a format-agnostic serialization framework.
- [Compiler Attributes](https://wado-lang.org/docs/spec-attributes.md): An attribute `#...` applies to the item it precedes, and an inner attribute `#!...` to the whole module.
- [Diagnostics](https://wado-lang.org/docs/spec-diagnostics.md): A diagnostic is a message the compiler reports about a program.
- [Testing](https://wado-lang.org/docs/spec-testing.md): Tests are first-class syntax: a `test` block declares one, and `wado test` finds and runs them.
## Standard library
- [core:args](https://wado-lang.org/docs/stdlib-core-args.md): Command-line argument parsing (WEP `wep-2026-06-22-core-args.md`).
- [core:base64](https://wado-lang.org/docs/stdlib-core-base64.md): Base64 encoding and decoding (RFC 4648): standard and URL-safe alphabets, configurable padding via `Encoding` flags, and two decoders.
- [core:benchmark](https://wado-lang.org/docs/stdlib-core-benchmark.md): Benchmark utilities: lazy headers, timed phases, throughput reports.
- [core:cbor](https://wado-lang.org/docs/stdlib-core-cbor.md): CBOR serialization and deserialization (RFC 8949, STD 94).
- [core:cli](https://wado-lang.org/docs/stdlib-core-cli.md): CLI helpers: `println`, `eprintln`, `args`, `env`, `exit`, etc.
- [core:collections](https://wado-lang.org/docs/stdlib-core-collections.md): Maps and sets that iterate in insertion order.
- [core:digest](https://wado-lang.org/docs/stdlib-core-digest.md): Cryptographic hash functions, and `hmac` to key one.
- [core:eval](https://wado-lang.org/docs/stdlib-core-eval.md): Compile and run a Wado program from a test.
- [core:fs](https://wado-lang.org/docs/stdlib-core-fs.md): Whole-file I/O against the preopened directory tree.
- [core:icu](https://wado-lang.org/docs/stdlib-core-icu.md): Unicode character properties, from the ICU4X component bundled with the toolchain.
- [core:json](https://wado-lang.org/docs/stdlib-core-json.md): JSON serialization and deserialization (self-describing format).
- [core:jsonc](https://wado-lang.org/docs/stdlib-core-jsonc.md): JSONC (JSON with Comments): reading it, and editing it in place.
- [core:jwt](https://wado-lang.org/docs/stdlib-core-jwt.md): JSON Web Tokens (RFC 7519) in the JWS Compact Serialization (RFC 7515), with HMAC-SHA256 (`HS256`, RFC 7518 §3.2) built in.
- [core:kiln](https://wado-lang.org/docs/stdlib-core-kiln.md): Kiln stdlib entry point.
- [core:log](https://wado-lang.org/docs/stdlib-core-log.md): Structured logging and tracing (`docs/wep-2026-06-25-core-log.md`).
- [core:prelude](https://wado-lang.org/docs/stdlib-core-prelude.md): Auto-imported in every module.
- [core:prng](https://wado-lang.org/docs/stdlib-core-prng.md): Seedable, reproducible pseudo-randomness for simulation, sampling, procedural generation, randomized algorithms and tests.
- [core:router](https://wado-lang.org/docs/stdlib-core-router.md): HTTP path router (`core:router`).
- [core:secure_random](https://wado-lang.org/docs/stdlib-core-secure_random.md): Randomness no one can predict, drawn from `wasi:random`.
- [core:serde](https://wado-lang.org/docs/stdlib-core-serde.md): Serialization and deserialization framework.
- [core:simd](https://wado-lang.org/docs/stdlib-core-simd.md): Type-safe wrappers over the WebAssembly 128-bit SIMD instruction set.
- [core:temporal](https://wado-lang.org/docs/stdlib-core-temporal.md): Date and time, a port of ECMA-262 Temporal under the ISO 8601 calendar.
- [core:url](https://wado-lang.org/docs/stdlib-core-url.md): URL parsing and construction for special schemes (WHATWG URL Standard).
- [core:uuid](https://wado-lang.org/docs/stdlib-core-uuid.md): UUID generation and parsing (RFC 9562).
- [core:value](https://wado-lang.org/docs/stdlib-core-value.md): Dynamically-typed, format-agnostic value type.
- [core:zlib](https://wado-lang.org/docs/stdlib-core-zlib.md): zlib compression and decompression.
- [WASI Standard Library](https://wado-lang.org/docs/stdlib-wasi.md)
- [WASI WebGPU Standard Library](https://wado-lang.org/docs/stdlib-wasi-webgpu.md)
## Blog
- [GPT-2 in a Browser Tab, Compiled Ahead of Time](https://wado-lang.org/blog/loam-gpt2.md): Loam turns an ONNX model into ordinary Wado source at build time, with tensor shapes checked like TypeScript types. GPT-2 now runs that way in the browser. An introduction for programmers who have never touched machine learning or Wado.
- [The Untrodden Path: Building a Language with Coding Agents](https://wado-lang.org/blog/agentic-coding.md): In January 2026 I started building a programming language with 100% agentic coding. Six months and ~1,450 pull requests later, the largest program written in it beats ANTLR4, in a language no model was ever trained on.
- [A Tour of Wado Through an HTTP Service](https://wado-lang.org/blog/http-service-tour.md): Walking through example/http_bin.wado — a single-file httpbin clone on the Component Model's wasi:http/service world — to see what Wado actually feels like to write.
- [Running in Lockstep: Wado, WASI 0.3, and the Road to Component Model 1.0](https://wado-lang.org/blog/running-in-lockstep.md): WASI 0.3 just shipped and the road to Component Model 1.0 is drawn. For a language built for exactly this platform, here's what changed — and why Wado's syntax is just WIT's vocabulary.
- [Hello, Wado!](https://wado-lang.org/blog/hello.md): Wado is a statically-typed, GC'd language built for one platform: WebAssembly's Component Model and WASI 0.3. A first look at what that means — and where the stack still falls short.
## Optional
- [Documentation index](https://wado-lang.org/docs/): every published page, including the Wado Evolution Proposals and the research notes
- [Wado Compiler](https://wado-lang.org/docs/compiler.md): The Wado compiler (`wado-compiler/`) translates `.wado` source into a Wasm component.
- [DWARF Metadata for Wado](https://wado-lang.org/docs/dwarf.md): This document describes the plan for adding DWARF debug metadata to the Wado compiler output, enabling source-level location mapping (file paths, line numbers) for Wado programs.
- [Wado Formatter](https://wado-lang.org/docs/formatter.md): `wado format` re-prints a source file in canonical form.
- [JitDump Profiling with Wasmtime](https://wado-lang.org/docs/jitdump-profiling.md): Date: 2026-03-21
- [Wado Optimizer](https://wado-lang.org/docs/optimizer.md): The optimizer rewrites NIR (WEP: NIR), then a smaller set of passes rewrites WIR before emission.
- [The Wasm Loader (Security Model for external plugins)](https://wado-lang.org/docs/wasm-loader.md): Effect declaration = Wasm import = WASI capability