Create Better-T-Stack CLI

A modern CLI tool for scaffolding end-to-end type-safe TypeScript projects with best practices and customizable configurations

Sponsors

Quick Start

Run without installing globally:

# Using bun (recommended)
bun create better-t-stack@latest

# Using pnpm
pnpm create better-t-stack@latest

# Using npm
npx create-better-t-stack@latest

Follow the prompts to configure your project or use the --yes flag for defaults.

Features

| Category | Options | | ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | TypeScript | End-to-end type safety across all parts of your application | | Frontend | • React with TanStack Router• React with React Router• React with TanStack Start (SSR)• Next.js• SvelteKit• Nuxt (Vue)• SolidJS• React Native with NativeWind (via Expo)• React Native with Unistyles (via Expo)• None | | Backend | • Hono• Express• Elysia• Next.js API routes• Convex• Fastify• None | | API Layer | • tRPC (type-safe APIs)• oRPC (OpenAPI-compatible type-safe APIs)• None | | Runtime | • Bun• Node.js• Cloudflare Workers• None | | Database | • SQLite• PostgreSQL• MySQL• MongoDB• None | | ORM | • Drizzle (TypeScript-first)• Prisma (feature-rich)• Mongoose (for MongoDB)• None | | Database Setup | • Turso (SQLite)• Cloudflare D1 (SQLite)• Neon (PostgreSQL)• Supabase (PostgreSQL)• Prisma Postgres (via Prisma Accelerate)• MongoDB Atlas• None (manual setup) | | Authentication | Better-Auth (email/password, with more options coming soon) | | Styling | Tailwind CSS with shadcn/ui components | | Addons | • PWA support• Tauri (desktop applications)• Starlight (documentation site)• Biome (linting and formatting)• Husky (Git hooks)• Turborepo (optimized builds) | | Examples | • Todo app• AI Chat interface (using Vercel AI SDK) | | Developer Experience | • Automatic Git initialization• Package manager choice (npm, pnpm, bun)• Automatic dependency installation |

Usage

Usage: create-better-t-stack [project-directory] [options]

Options:
  -V, --version                   Output the version number
  -y, --yes                       Use default configuration
  --database <type>               Database type (none, sqlite, postgres, mysql, mongodb)
  --orm <type>                    ORM type (none, drizzle, prisma, mongoose)
  --auth                          Include authentication
  --no-auth                       Exclude authentication
  --frontend <types...>           Frontend types (tanstack-router, react-router, tanstack-start, next, nuxt, svelte, solid, native-nativewind, native-unistyles, none)
  --addons <types...>             Additional addons (pwa, tauri, starlight, biome, husky, turborepo, fumadocs, ultracite, oxlint, none)
  --examples <types...>           Examples to include (todo, ai, none)
  --git                           Initialize git repository
  --no-git                        Skip git initialization
  --package-manager <pm>          Package manager (npm, pnpm, bun)
  --install                       Install dependencies
  --no-install                    Skip installing dependencies
  --db-setup <setup>              Database setup (turso, d1, neon, supabase, prisma-postgres, mongodb-atlas, docker, none)
  --web-deploy <setup>            Web deployment (workers, alchemy, none)
  --server-deploy <setup>         Server deployment (workers, alchemy, none)
  --backend <framework>           Backend framework (hono, express, elysia, next, convex, fastify, none)
  --runtime <runtime>             Runtime (bun, node, workers, none)
  --api <type>                    API type (trpc, orpc, none)
  -h, --help                      Display help

Telemetry

This CLI collects anonymous usage data to help improve the tool. The data collected includes:

• Configuration options selected
• CLI version
• Node.js version
• Platform (OS)

Telemetry is enabled by default in published versions to help us understand usage patterns and improve the tool.

Disabling Telemetry

You can disable telemetry by setting the BTS_TELEMETRY_DISABLED environment variable:

# Disable telemetry for a single run
BTS_TELEMETRY_DISABLED=1 npx create-better-t-stack my-app

# Disable telemetry globally in your shell profile (.bashrc, .zshrc, etc.)
export BTS_TELEMETRY_DISABLED=1

Examples

Create a project with default configuration:

npx create-better-t-stack my-app --yes

Create a project with specific options:

npx create-better-t-stack my-app --database postgres --orm drizzle --auth --addons pwa biome

Create a project with Elysia backend and Node.js runtime:

npx create-better-t-stack my-app --backend elysia --runtime node

Create a project with multiple frontend options (one web + one native):

npx create-better-t-stack my-app --frontend tanstack-router native-nativewind

Create a project with examples:

npx create-better-t-stack my-app --examples todo ai

Create a project with Turso database setup:

npx create-better-t-stack my-app --database sqlite --orm drizzle --db-setup turso

Create a project with Supabase PostgreSQL setup:

npx create-better-t-stack my-app --database postgres --orm drizzle --db-setup supabase --auth

Create a project with Convex backend:

npx create-better-t-stack my-app --backend convex --frontend tanstack-router

Create a project with documentation site:

npx create-better-t-stack my-app --addons starlight

Create a minimal TypeScript project with no backend:

npx create-better-t-stack my-app --backend none --frontend tanstack-router

Create a backend-only project with no frontend:

npx create-better-t-stack my-app --frontend none --backend hono --database postgres --orm drizzle

Create a simple frontend-only project:

npx create-better-t-stack my-app --backend none --frontend next --addons none --examples none

Create a Cloudflare Workers project:

npx create-better-t-stack my-app --backend hono --runtime workers --database sqlite --orm drizzle --db-setup d1

Create a minimal API-only project:

npx create-better-t-stack my-app --frontend none --backend hono --api trpc --database none --addons none

Compatibility Notes

• Convex backend: Automatically disables authentication, database, ORM, and API options
• Backend 'none': If selected, this option will force related options like API, ORM, database, authentication, and runtime to 'none'. Examples will also be disabled (set to none/empty).
• Frontend 'none': Creates a backend-only project. When selected, PWA, Tauri, and certain examples may be disabled.
• API 'none': Disables tRPC/oRPC setup. Can be used with backend frameworks for REST APIs or custom API implementations.
• Database 'none': Disables database setup. Automatically sets ORM to 'none' and disables authentication.
• ORM 'none': Can be used when you want to handle database operations manually or use a different ORM.
• Runtime 'none': Only available with Convex backend or when backend is 'none'.
• Cloudflare Workers runtime: Only compatible with Hono backend, Drizzle ORM (or no ORM), and SQLite database (with D1 setup). Not compatible with MongoDB.
• Addons 'none': Skips all addons (PWA, Tauri, Starlight, Biome, Husky, Turborepo).
• Examples 'none': Skips all example implementations (todo, AI chat).
• SvelteKit, Nuxt, and SolidJS frontends are only compatible with oRPC API layer
• PWA support requires React with TanStack Router, React Router, or SolidJS
• Tauri desktop app requires React (TanStack Router/React Router), Nuxt, SvelteKit, or SolidJS
• AI example is not compatible with Elysia backend or SolidJS frontend

Project Structure

The created project follows a clean monorepo structure:

my-better-t-app/
├── apps/
│   ├── web/          # Frontend application
│   ├── server/       # Backend API
│   ├── native/       # (optional) Mobile application
│   └── docs/         # (optional) Documentation site
├── packages/         # Shared packages
└── README.md         # Auto-generated project documentation

After project creation, you'll receive detailed instructions for next steps and additional setup requirements.