Documentation

Find the page that matches your situation. Every row says which question it answers.

Start here

You are evaluating Narro or building your first deck.

Introduction What is Narro, and should I be writing markdown or React? Installation What do I install, and what does the project look like afterwards? First Deck What does a working React deck look like, end to end? Markdown Mode How do I split a slide, style one word, or reveal a line — without leaving the markdown file? Writing AI Prompts What do I tell an AI so the deck it writes actually builds? Rules for AI Agents What do I paste into my repo so an agent stops writing decks that build wrong?

Reference

You are writing a deck and need the exact name of something.

React API Which component or hook do I import, and what does it take? CLI Which command do I run, and what are its flags? Markdown API How do I read, edit, or validate a deck file from my own code instead of by hand? Component Reference What props does this component take, and which package do I import it from?

Guides

The deck works and you want it to do more, or to stop doing something.

Verifying a deck How do I know my deck is actually correct? Animation How do I reveal a list one line at a time, or move between slides with something other than a cut? Navigation How does the audience move through the deck, and how do I present it? Canvas & Positioning How do I put something at an exact position instead of in the flow? Images & Media How do I use an image as a background, tint it, or embed a video? Architecture Which package owns what, and why is the seam where it is? Zooming canvas How do I zoom and pan across one big canvas instead of cutting between slides? Transform Mode How do I zoom and pan across one big canvas instead of cutting between slides? Import & Export How do I get this deck out as PPTX, PDF, or one file I can email? Video How do I turn a story into a video, and keep it right when the words, the product or the source changes? Recording a web app How do I put a demo of my product in a deck or on a landing page without shipping a video of it? Embedding a replay How do I embed a recorded demo of my app in my React app, my Astro site, or any other page? Terminal How do I put a terminal demo in a deck, a README or a video, and find out when the tool it demonstrates stops saying what the demo says? AI Integration How do I wire an AI assistant up to Narro so it can write and build decks? Theming How do I change the colours, fonts, and overall look of a deck? Deck Templates How do I define one house style with named layouts my slides can reference, like a PowerPoint master? Troubleshooting Something is wrong with my deck. What is it, and how do I fix it? Limitations What can't Narro do, and what do I do instead?

Reading this as an AI agent?

Start with llms.txt. If you can only afford one fetch, take llms-full.txt instead — it is every page in one response.

/llms.txt — the index: install commands, the closed sets, and every page with the question it answers.
/llms-full.txt — all of the above with every page inlined. One fetch, no follow-ups.
/catalog.json — the closed sets. Every valid layout, theme, color scheme, transition, font preset, template, and component name. If a name is not in here it does not exist, and inventing one produces a deck that builds and renders wrong.
/components.json — every component's props, read out of the TypeScript types rather than transcribed.
Any page, as markdown: append .md to its URL — /docs/markdown-mode.md. Same content, a fraction of the tokens, no markup to parse back out.
deck-frontmatter.schema.json and slide-frontmatter.schema.json — the frontmatter contract, generated from the parser's own definitions.
No web access? npm i -D @getnarro/docs ships all of the above through the registry that already installed your packages.
Then check your work: npx @getnarro/cli check deck.md. Documentation tells you what is possible; the checker tells you whether what you wrote is correct. See Rules for AI agents.