Docs / Overview

Open documentation actions
Raw MDXOpen on GitHub

Better Fullstack Docs

Learn how Better Fullstack scaffolds typed projects across web, mobile, and language-native ecosystems.

Better Fullstack is a project generator for typed product stacks. Pick the frontend, backend, data layer, services, tooling, and target ecosystem; the CLI writes the matching files and records the stack in bts.jsonc.

Use the interactive CLI when you want a guided setup, the Stack Builder when you want to compare options visually, and explicit flags when you need a reproducible command for CI, docs, or another developer.

Requirements

The CLI runs on Node.js 20 or newer.

node --version

Generated projects may also need their ecosystem toolchain: Expo tooling for React Native, Cargo for Rust, uv for Python, Go, Java 21, or Elixir/Erlang for Phoenix projects.

Create your first project

Run the wizard and answer the prompts:

npm create better-fullstack@latest my-app

For npm, Better Fullstack flags go after the -- separator. The rendered package-manager tabs show the matching pnpm, Bun, and Yarn commands where the separator is not needed.

What the defaults create

Accepting defaults creates a TypeScript project with:

  • TanStack Router frontend and Hono backend.
  • Bun runtime, SQLite, Drizzle, Better Auth, and tRPC.
  • Tailwind CSS, shadcn/ui, Vitest, and Turborepo.
  • The package manager used to launch the CLI, stable dependency versions, Git, install enabled, and CLAUDE.md.

You can keep that stack, start from a template, or switch ecosystems entirely.

Ways to choose a stack

PathUse it when
CLI wizardYou want prompts and sensible defaults.
Stack BuilderYou want to explore compatible combinations before scaffolding.
Explicit flagsYou want repeatable output in scripts, docs, or issue reports.
Agent SkillYou want a coding agent to use the CLI workflow without hand-writing starter files.
MCP serverYou want an AI coding agent to inspect the schema, validate compatibility, and dry-run safely.

Generated project context

Every generated project includes:

  • bts.jsonc with the selected stack.
  • A reproducible command printed by the CLI.
  • Framework, package, and config files for the selected ecosystem.
  • Optional AI instruction files such as CLAUDE.md, Agents.md, or .cursorrules.

Next

  • Installation explains launchers and toolchains.
  • First Project walks through scaffold, dry-run, install, and inspection.
  • CLI Create lists flags and scripted examples.
  • Ecosystems compares TypeScript, React Native, Rust, Python, Go, Java, and Elixir.
  • Multi-Ecosystem shows how to combine web, backend, database, and mobile parts in one project.