# Pixel Studio documentation

> Write a character, make it move and put it on a page: the spec, figures, runtime, stage, CLI and API.

| I want to… | read |
|---|---|
| get a character onto a page in five minutes | [getting-started.md](/docs/reference/getting-started/) |
| understand what this is and try it | [the project README](https://github.com/pavelpascari/pixel-studio/blob/main/packages/pixel-studio/README.md), and the [guide](https://pixel-studio.sh/docs/guide/): every feature as a live example next to its code, with characters you can edit |
| write a character (or brief an agent to) | [SPEC.md](/docs/reference/spec/): the spec format. It is also the agent brief (`pixel brief`) |
| make characters move realistically | [figures.md](/docs/reference/figures/): figure library, motion models, follow-through, writing a figure |
| put a character on a web page | [runtime.md](/docs/reference/runtime/): `<pixel-sprite>`, bundles, events, attachment points, state machines, skins, moving sprites at the right speed |
| let characters walk, climb and hide on a page | [stage.md](/docs/reference/stage/): `<pixel-stage>` and the `data-pixel-*` attributes |
| use characters in a game engine | [cli.md](/docs/reference/cli/#export): `pixel export` writes Aseprite-format JSON that Phaser and PixiJS load |
| use the command line | [cli.md](/docs/reference/cli/): every `pixel` command and flag |
| call the engine from JavaScript | [api.md](/docs/reference/api/): every export, data shapes, examples |
| set up a character by URL, or let a browser agent try looks | [playground.md](/docs/reference/playground/) |
| change or extend the engine | [architecture.md](/docs/reference/architecture/): pipeline, module map, rendering internals, extension recipes |
| know why it is designed this way | [DESIGN.md](/docs/reference/design/): working backwards from the web page |
| see what's next | [research/](https://github.com/pavelpascari/pixel-studio/tree/main/docs/research): surveys of other animation tools, web playback on devices, page interactions |

Contributing: [CONTRIBUTING.md](/docs/project/contributing/). License: [MIT](https://github.com/pavelpascari/pixel-studio/blob/main/packages/pixel-studio/LICENSE).
