create-narro

Scaffold a new Narro presentation

getnarro.com · Documentation · Ecosystem

npm create narro@latest

Or with a template chosen up front:

npm create narro@latest my-deck -- --template minimal

pnpm create narro, yarn create narro, and bun create narro work too.

Templates

Markdown

| Template | What it is | Notes | | --- | --- | --- | | markdown-minimal | One deck.md and a pinned CLI. Nothing to build. | start here | | markdown-app | The same deck inside a Vite project, for React components and custom CSS. | — | | markdown-docs | Documentation-shaped deck: long code samples, wide tables. | ships an example deck |

React

| Template | What it is | Notes | | --- | --- | --- | | minimal | Three slides and nothing else. Start here to write your own. | start here | | corporate | Restrained business deck, dark theme. | ships an example deck | | developer | Code-heavy technical talk with terminal chrome. | ships an example deck | | creative | Bold colour and large type. | ships an example deck | | bold-statement | One idea per slide, very large type. | ships an example deck | | visual-story | Full-bleed imagery with overlay text. | ships an example deck | | data-narrative | Charts and figures, light theme. | ships an example deck | | startup-pitch | Ten-slide investor pitch, filled in. | ships an example deck | | tech-conference | Conference talk with a title card and code slides. | ships an example deck | | template0 | Reference deck exercising every component. Read it, do not start from it. | ships an example deck |

Pass --mode markdown to be prompted with only the markdown templates.

Options

| Option | Description | | ------------------------- | ----------------------------------------------- | | -t, --template <name> | Template to use; skips the template prompt | | -m, --mode <mode> | react (default) or markdown | | --skip-install | Skip installing dependencies |

Why this is a separate package

npm create narro resolves the create-narro package, so scaffolding cannot live inside @getnarro/cli — the whole point is to run it before anything is installed. Keeping it standalone also keeps the download small: the scaffolder needs four small dependencies, while @getnarro/cli pulls in Vite, React, Playwright, sharp, and the Google APIs client.

@getnarro/cli depends on this package so that narro create and create-narro share one implementation and one copy of the templates.

The Narro ecosystem

| Package | What it is | | --- | --- | | @getnarro/cli | CLI tools for creating and managing Narro presentations | | @getnarro/core | The React runtime for Narro presentations — Presentation, Slide, navigation, transitions, and speaker notes | | @getnarro/docs | Narro's documentation as data — markdown pages, a generated component API reference, and llms.txt | | @getnarro/markdown | Markdown & MDX authoring for Narro presentations | | @getnarro/marketplace | Themes, colour schemes, and templates for Narro presentations | | @getnarro/mcp-server | MCP (Model Context Protocol) server for AI-assisted Narro presentation creation | | @getnarro/shared-ui | Slide components for Narro presentations — headings, text, lists, code, media, charts, and layouts | | create-narro | Scaffold a new Narro presentation ← you are here |

All eight ship from one repository and release together.

The npm package named narro is unrelated to this project. Narro's packages are all under the @getnarro/ scope; the CLI binary narro comes from @getnarro/cli.

Website · Documentation · llms.txt · GitHub · Issues · Changelog

Released under the MIT License.