create-indiepub

Scaffold a new IndiePub site in seconds. Clones an official theme from Codeberg, wires up your config, and gets you ready to deploy on Cloudflare.

Usage

npm create indiepub

Or with pnpm / yarn:

pnpm create indiepub
yarn create indiepub

The interactive CLI will walk you through:

1. Project directory — where to create your site
2. Template — choose a theme:
   • Default — dev-focused IndieWeb site with all post types
   • Byline — writer-focused blog with TipTap editor and /write dashboard
   • Timeline — feed-based social profile with unified timeline
   • Minimal — bare config, bring your own pages
3. Site details — title, author name, URL
4. License token — your IndiePub license key (from indiepub.dev/account)
5. Email subscriptions — optionally enable newsletter support
6. D1 database — optionally create your Cloudflare D1 database on the spot (requires wrangler login)
7. R2 bucket — optionally create your Cloudflare R2 bucket for media uploads (requires wrangler login)

What you get

A ready-to-deploy Astro project configured for Cloudflare Pages with:

• Pre-configured .npmrc pointing at the IndiePub package registry
• wrangler.toml with D1 and R2 bindings (auto-filled if you create resources during setup)
• .dev.vars.example with the secrets you'll need
• Optional GitHub Actions deploy workflow

After scaffolding

cd my-site
cp .dev.vars.example .dev.vars    # add your secrets

# If you didn't create D1 during setup:
npx wrangler d1 create my-site-db
# Copy the database_id and database_name into wrangler.toml

# If you didn't create R2 during setup:
npx wrangler r2 bucket create my-site-media
# Update bucket_name in wrangler.toml

pnpm install
pnpm db:migrate
pnpm dev

Then visit /admin/onboarding to finish setup. Connect Bluesky and Mastodon accounts from /admin/accounts.

Requirements

• Node.js >= 20
• A Cloudflare account (free tier works)
• An IndiePub license token

Links

• IndiePub — project homepage
• Documentation — full guides and API reference
• Themes — theme source code
• Source — this package

License

MIT