Getting Started

Create a project

bunx @campfire-deck/cli init my-deck
cd my-deck
bun install

This scaffolds a clean Bun + React + Tailwind v4 workspace:

my-deck/
├── slides/
│   └── 01-welcome.mdx
├── components/
│   └── mdx.tsx            # base markdown rendering — yours to edit
├── theme.css              # Tailwind v4, CSS-first (no tailwind.config)
├── campfire.config.ts     # optional: deck title, canvas size
├── components.json        # shadcn-compatible registry config
└── AGENTS.md              # instructions for coding agents

layouts/ and assets/ are created on demand — the first camp add or asset you drop in brings them to life.

No starter layouts or blocks are installed by default — the repository starts clean and becomes registry-driven.

Start the shell

bun dev   # runs `camp`

The shell opens at http://localhost:3030 with a deck overview. Edit any slide, layout, component, or theme.css and the browser updates.

Keyboard

Slides deep-link: #/3 selects slide 3 in the overview and #/present/3 presents it.

Add primitives

camp add metric-card
camp add problem-solution

Registry items are copied straight into components/ and layouts/ — edit them like any other file.