WASM-TOOLS(1)

📦 version 1.239.0, in ubuntu stonking

💅 WASM-TOOLS(1) — bestie edition 💅

okay so this is the manual for wasm-tools compose, living in the User Commands section of your local wasm-tools docs, and it's literally about smushing WebAssembly components together. no cap. let's get into it 🫶

✨ NAME ✨

wasm-tools compose — the WebAssembly component composer. that's it, that's the name, iconic behavior 🌸

🎀 SYNOPSIS 🎀

wasm-tools compose [OPTIONS] <COMPONENT>

🦋 DESCRIPTION 🦋

WebAssembly component composer. 💖

so basically: a tool for composing WebAssembly components together. it's giving matchmaker energy for your .wasm files — you bring the parts, it makes them one. lowkey the whole point of the command ✨

🌈 Arguments:

  • <COMPONENT> — the path to the root component you wanna compose. that's your main character component, the one everything else gets built around 👑

🔥 OPTIONS 🔥

  • -v, --verbose... — use verbose output. yes bestie, you can stack it: -v = info, -vv = debug, -vvv = trace. go off, add as many as you want 📢
  • --color <COLOR> — controls whether terminal colors show up in the output.

it takes one of exactly these: auto|never|always|always-ansi. the default is auto, which means it peeks at your terminal environment to figure out what to do — for example, by using isatty. so it checks the vibe before committing 🌈

[default: auto]

  • -o, --output <OUTPUT> — where to place the output. if you don't give it one, stdout is used. no file, no problem, straight to the screen 💅
  • -c, --config <CONFIG> — the path to the configuration file to use.
  • -d, --definitions <DEFS> — definition components whose exports define import dependencies to fulfill from. (yes, that's the whole sentence. it's a mouthful but it's important, fr fr.)
  • -p, --search-path <PATH> — a path to search for imports. hunting szn 🔍
  • --skip-validation — skip validation of the composed output component.
bestie, heads up: this one turns OFF the safety check on what you just built. skipping validation means nobody's verifying your output component is chill. use with care 🚨
  • --no-imports — do not allow instance imports in the composed output component. strict queen energy 👑
  • -t, --wat — output the text format of WebAssembly instead of the binary format. same component, but readable by humans 🧚
  • -h, --help — print help. (and pssst — it'll show you a summary with -h, so there's a shorter and a longer version depending on what you ask for.)
  • -V, --version — print version. ⭐

that's the whole thing bestie, every flag accounted for, nothing skipped, we ate and left no crumbs 💖

and for the cute sign-off: this page is for wasm-tools compose version 1.239.0+ds, dated August 2026, and it's filed under WASM-TOOLS(1). periodt ✨🎀

📦 where this page comes from