# WebAssembly Music — documentation

Guides for making music and visuals in the app. For building/running the app
itself see the [app README](../README.md); for the monorepo overview see the
[top-level README](../../README.md).

## Making music with the AI agent

- [Agentic Composition](agenticcomposition.md) — a track made by talking to an
  in-browser AI agent: it writes the sequence, builds Faust instruments, edits
  the arrangement, and even its conversation is saved into the repo. (The
  finished example lives at
  [petersalomonsen/wasm-music-2026](https://github.com/petersalomonsen/wasm-music-2026).)

## Talks & performances

- [Agentic Composition, Live](presentation/is2-2026-performance-plan.md) — plan
  for the 12-minute set proposed to IEEE IS² 2026 (Cannes, October 2026): a
  track built from silence by talking to the agent, with the music never
  stopping, and the finished piece pushed to a repo the audience can open.

## Authoring a song

- [Writing songs in JavaScript](writing-songs.md) — **start here.** A song is a
  readable sequence of actions you follow top to bottom — do this, wait, do the
  next thing — with loops to repeat a section and functions to name and reuse
  one. Written for people who don't code, and it doubles as a genuine
  programming tutorial: sequence, iteration, abstraction and concurrency, each
  one something you can *hear*.
- [Song API reference](song-api.md) — complete reference for writing songs in
  JavaScript: tracks, patterns, notes, timing, instruments, audio & video.
- [Animating images & text](animations.md) — frame-by-frame animation, text
  overlays, letterboxing and fades in the visualizer.
- [Developing & testing visualizer shaders](shaders.md) — the fragment-shader
  uniform contract and a headless compile + render harness
  ([tools/shadertest](../../tools/shadertest/render.mjs)).
- [Faust effects: channel & master](effects.md) — adding a per-instrument
  effect (`effect =`) or a whole-mix master effect (`postprocess()`), with a
  chorus and a Tapiir-echo worked example.

## Sharing & hosting

- [Hosting a song project in a NEAR-backed git repo](git-hosting.md) — create
  your own `?gitrepo=` repo and push a project to it (on-chain git storage).

## Other docs in the repo

- [faust2as transpiler](../../tools/faust2as/README.md) — Faust → AssemblyScript.
- [DX7 FM synth example](../../examples/dx7/README.md) — Yamaha DX7 algorithms as transpiled instruments, and porting real ROM (`.syx`) patches into a channel.
- [Beach Drive example](../../examples/beachdrive/README.md) — an OutRun-style pseudo-3D road turned into a MIDI-controllable driving game whose logic lives entirely in the song (via the generic synth→shader `synthState` channel).
- [claude-bridge](../../tools/claude-bridge/README.md) — connect Claude Code to
  the app's editors.
- [DAW plugin](../../dawplugin/README.md) — load exported wasm instruments in a DAW.
- [Roadmap](../../ROADMAP.md)