# niiro

> Explainer videos generated from your frontend code. Push your code, niiro rebuilds your interface as a scene and narrates it with voice, chapters and captions. When your platform changes, the videos follow.

## How it works

- `npx niiro init` detects your framework and styling and writes `niiro.yml`.
- `include` in `niiro.yml` is an allowlist. What is not listed never leaves the machine.
- `npx niiro push` runs a secret scan, uploads only files niiro does not have yet, and reports which videos the change affects.
- Code is never built and never executed. Project tokens are write-only.

## Docs

- [Setup and CLI](https://niiro.io/en/docs): commands, `niiro.yml`, what is always excluded
- [MCP server](https://niiro.io/en/docs/mcp): tools for coding agents
- [Trust](https://niiro.io/en/trust): storage, separation, subprocessors
- [Pricing](https://niiro.io/en/pricing)

Every page exists in English, Spanish and German under /en, /es and /de.

## Setting niiro up for a repository

1. Run `npx niiro init` in the repository root.
2. Review the generated `niiro.yml` and restrict `include` to frontend source, styles and theme configuration.
3. Run `npx niiro push`.
4. Open the report URL printed by the push.