create-dispatch-app

Scaffold a Next.js app with Dispatch CMS and an example blog already wired up.

Prerequisites

• Node.js 20.9 or later
• npm (or use pnpm/yarn in the generated app after scaffolding)

Usage

npx create-dispatch-app my-app

This creates a new directory my-app with:

• A Next.js 16 app (App Router)
• Dispatch provider and site key config
• Example blog: list page at /, post pages at /blog/[slug]
• TipTap for rendering post content
• .env.local.example with NEXT_PUBLIC_DISPATCH_SITE_KEY

Dependencies are installed automatically.

Next steps

1. Go into the app

   cd my-app

2. Add your site key

   • Copy .env.local.example to .env.local
   • Get your site key from Dispatch (Sites → your site)
   • Set NEXT_PUBLIC_DISPATCH_SITE_KEY in .env.local

3. Run the app

   npm run dev

4. Open http://localhost:3000. Create and publish a post in the Dispatch dashboard, then refresh the page.

For the full guide and manual setup, see the Quickstart.