Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/amanvarshney01/create-better-t-stack/llms.txt

Use this file to discover all available pages before exploring further.

General Options

Basic Flags

--yes
boolean
default:false
Skip all interactive prompts and use default configuration.
create-better-t-stack my-app --yes
--verbose
boolean
default:false
Show detailed result information as JSON after project creation.
create-better-t-stack my-app --verbose
--yolo
boolean
default:false
Bypass validations and compatibility checks. Warning: Not recommended - may create invalid configurations.
create-better-t-stack --yolo
--manual-db
boolean
default:false
Skip automatic database setup prompt and use manual setup.
create-better-t-stack --manual-db
--disable-analytics
boolean
default:false
Disable analytics and telemetry data collection.
create-better-t-stack --disable-analytics
--render-title
boolean
default:true
Control whether ASCII art title is shown.
# Hide title (useful in CI)
create-better-t-stack --no-render-title
--directory-conflict
enum
How to handle existing non-empty target directories:
  • merge - Keep existing files and merge new ones
  • overwrite - Clear directory before scaffolding
  • increment - Create suffixed directory (e.g., my-app-1)
  • error - Fail instead of prompting
create-better-t-stack my-app --directory-conflict increment

Project Configuration

--template
enum
Use a predefined project template:
  • none - No template (default)
  • mern - MongoDB, Express, React, Node.js
  • pern - PostgreSQL, Express, React, Node.js
  • t3 - T3 stack configuration
  • uniwind - UniWind React Native template
create-better-t-stack --template t3
--package-manager
enum
Choose package manager:
  • npm - Node Package Manager
  • pnpm - Fast, disk space efficient
  • bun - All-in-one JavaScript runtime
create-better-t-stack --package-manager bun
--install
boolean
Install dependencies after project creation.
# Skip installation
create-better-t-stack --no-install

# Install dependencies
create-better-t-stack --install
--git
boolean
Initialize Git repository.
# Skip Git initialization
create-better-t-stack --no-git

# Initialize Git
create-better-t-stack --git

Frontend Options

--frontend
array
Frontend framework(s) to use. You can specify one web framework and/or one native framework.Web Frameworks:
  • tanstack-router - React with TanStack Router
  • react-router - React with React Router
  • tanstack-start - React with TanStack Start (SSR)
  • next - Next.js
  • nuxt - Nuxt (Vue)
  • svelte - SvelteKit
  • solid - SolidJS
  • astro - Astro
Native Frameworks:
  • native-bare - React Native (bare setup)
  • native-uniwind - React Native with UniWind
  • native-unistyles - React Native with Unistyles
No Frontend:
  • none - Backend-only project
# Single web frontend
create-better-t-stack --frontend tanstack-router

# Web + native
create-better-t-stack --frontend next native-uniwind

# Backend only
create-better-t-stack --frontend none
You cannot select multiple web frameworks or multiple native frameworks. One of each maximum.

Backend Options

--backend
enum
Backend framework to use:
  • hono - Fast, lightweight web framework
  • express - Popular Node.js framework
  • fastify - Fast, plugin-based framework
  • elysia - Bun-native framework
  • convex - Convex backend-as-a-service
  • self - Use frontend’s built-in API routes (Next.js, TanStack Start, Nuxt, Astro)
  • none - No backend
create-better-t-stack --backend hono
--runtime
enum
Runtime environment:
  • bun - Bun runtime
  • node - Node.js runtime
  • workers - Cloudflare Workers
  • none - No runtime (only with convex, none, or self backend)
create-better-t-stack --backend hono --runtime bun
--api
enum
API layer type:
  • trpc - tRPC (type-safe RPC)
  • orpc - oRPC (OpenAPI-compatible RPC)
  • none - No API layer
create-better-t-stack --api trpc
Cloudflare Workers requires --backend hono. tRPC is not supported with Nuxt, Svelte, Solid, or Astro - use oRPC instead.

Database Options

--database
enum
Database type:
  • sqlite - Lightweight, file-based
  • postgres - PostgreSQL
  • mysql - MySQL
  • mongodb - MongoDB (not compatible with Workers)
  • none - No database
create-better-t-stack --database postgres
--orm
enum
ORM/ODM to use:
  • drizzle - TypeScript-first ORM
  • prisma - Feature-rich ORM
  • mongoose - MongoDB ODM (requires --database mongodb)
  • none - No ORM
create-better-t-stack --database postgres --orm drizzle
--db-setup
enum
Database hosting/setup provider:
  • turso - Turso (SQLite)
  • d1 - Cloudflare D1 (SQLite, requires Workers)
  • neon - Neon (PostgreSQL)
  • supabase - Supabase (PostgreSQL)
  • prisma-postgres - Prisma Postgres
  • planetscale - PlanetScale (MySQL/PostgreSQL)
  • mongodb-atlas - MongoDB Atlas
  • docker - Local Docker containers
  • none - Manual setup
create-better-t-stack --database postgres --db-setup neon
Database requires an ORM. If you choose a database, you must also choose an ORM. MongoDB only works with Mongoose or Prisma. Drizzle does not support MongoDB.

Authentication & Payments

--auth
enum
Authentication provider:
  • better-auth - Better-Auth (requires backend)
  • clerk - Clerk (only with Convex backend)
  • none - No authentication
create-better-t-stack --auth better-auth
--payments
enum
Payments integration:
  • polar - Polar payments (requires Better-Auth)
  • none - No payments
create-better-t-stack --payments polar --auth better-auth
Better-Auth requires a backend framework (cannot be none). Clerk is only available with Convex backend and compatible frontends. Polar payments requires Better-Auth.

Addons

--addons
array
Additional features to include:Tooling:
  • turborepo - Turborepo monorepo
  • biome - Biome linting/formatting
  • oxlint - Oxlint + Oxfmt
  • ultracite - Zero-config Biome preset
  • husky - Git hooks with Husky
  • lefthook - Git hooks with Lefthook
Documentation:
  • starlight - Starlight docs (Astro)
  • fumadocs - Fumadocs documentation
Extensions:
  • pwa - Progressive Web App
  • tauri - Desktop app support
  • opentui - Terminal UI components
  • wxt - Browser extension framework
AI:
  • ruler - AI rules manager
  • skills - AI coding agent skills
  • mcp - MCP servers via add-mcp
  • none - No addons
create-better-t-stack --addons pwa biome husky
Some addons require specific frontends. For example, PWA requires a web frontend, and Tauri cannot be combined with native frameworks.

Examples

--examples
array
Example implementations to include:
  • todo - Todo app example (requires database and API)
  • ai - AI chat interface (not compatible with Solid or Astro)
  • none - No examples
create-better-t-stack --examples todo ai
Todo example requires a database and API layer (or Convex backend). AI example is not compatible with Solid or Astro frontends.

Deployment

--web-deploy
enum
Web deployment configuration:
  • cloudflare - Cloudflare Workers deployment (via Alchemy IaC)
  • none - No deployment setup
create-better-t-stack --web-deploy cloudflare
--server-deploy
enum
Server deployment configuration:
  • cloudflare - Cloudflare Workers deployment (via Alchemy IaC)
  • none - No deployment setup
create-better-t-stack --server-deploy cloudflare
Alchemy uses TypeScript to define infrastructure programmatically. Web deployment requires a web frontend. Server deployment requires a backend.

Complete Example

Here’s a full-stack application with all major options specified:
create-better-t-stack my-fullstack-app \
  --database postgres \
  --orm drizzle \
  --backend hono \
  --runtime bun \
  --frontend tanstack-router \
  --api trpc \
  --auth better-auth \
  --payments polar \
  --addons pwa biome husky \
  --examples todo ai \
  --package-manager bun \
  --db-setup neon \
  --web-deploy cloudflare \
  --server-deploy cloudflare \
  --install \
  --git
For compatibility rules and restrictions, see the Compatibility Reference.

Build docs developers (and LLMs) love