create-hono-inertia

Scaffold a Hono + Inertia.js project with hono/jsx, SSR + hydration, and Cloudflare Workers ready out of the box.

Usage

npm create hono-inertia@latest
# or
pnpm create hono-inertia
# or
yarn create hono-inertia
# or
bun create hono-inertia

You will be prompted for:

• Project name (or pass it as an argument: pnpm create hono-inertia my-app)
• Add Tailwind CSS? (v4 with @tailwindcss/vite)
• Add import alias? (@/* → ./src/*)
• Install dependencies? (auto-detects npm / pnpm / yarn / bun)
• Initialize a git repository?

Then:

cd my-app
pnpm dev

Non-interactive

Pass --yes (or -y) to accept all defaults. Combine with --skip-* flags to opt out:

pnpm create hono-inertia my-app --yes --skip-tailwind

Supported flags: --yes, --skip-install, --skip-git, --skip-tailwind, --skip-alias.

What you get

A minimal Hono + Inertia template (no opinions about folder structure, layouts, or feature splits — extend it however you like):

• Server: Hono on Cloudflare Workers, with @hono/inertia middleware
• Client: hono/jsx via @ts-76/inertia-hono-jsx adapter
• SSR + hydration: server-side rendering with browser-side hydration
• Type-safe pages: auto-generated pages.gen.ts for typed Inertia page props
• Build: Vite with the official @cloudflare/vite-plugin
• Optional: Tailwind CSS v4 + @/* import alias (opt-in via prompt)

Project layout

src/
├── index.tsx         # Hono app + routes (your sandbox)
├── inertia.tsx       # Inertia middleware + rootView + ssrRender (setup)
├── client.tsx        # hydration entry (rarely touched)
├── pages.gen.ts      # auto-generated by @hono/inertia/vite
├── Pages/Home.tsx    # add Inertia pages here
└── style.css

Next steps

• Add more pages under src/Pages/
• Add routes in src/index.tsx with c.Inertia.render('PageName', props)
• Deploy with pnpm deploy (uses wrangler deploy)

License

MIT