Files
create-better-t-stack/apps/cli
github-actions[bot] b2feac3f8d v0.15.0
2025-03-22 13:09:47 +05:30
..
2025-03-22 13:05:45 +05:30
2025-03-22 13:09:47 +05:30
2025-03-22 13:09:47 +05:30
2025-03-20 23:32:40 +05:30

Create Better-T-Stack CLI

Note: This CLI is currently a work in progress (WIP).

An interactive CLI tool to quickly scaffold full-stack TypeScript applications using the Better-T-Stack framework.

Quick Start

Run without installing globally:

npx create-better-t-stack@latest
# OR
bunx create-better-t-stack

Follow the prompts to configure your project.

Features

  • Monorepo: Turborepo for optimized build system and workspace management
  • Frontend: React, TanStack Router, TanStack Query, Tailwind CSS with shadcn/ui components
  • Backend: Hono, tRPC
  • Database Options: SQLite (via Turso), PostgreSQL, or no database
  • ORM Selection: Choose between Drizzle ORM or Prisma
  • Authentication: Optional auth setup with Better-Auth
  • Developer Experience: Git initialization, various package manager support (npm, pnpm, yarn, bun)
  • Deployment: Optional Docker configuration
  • CI/CD: Optional GitHub Actions workflows

Usage

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

Options:
  -V, --version         Output the version number
  -y, --yes             Use default configuration
  --no-database         Skip database setup
  --sqlite              Use SQLite database
  --postgres            Use PostgreSQL database
  --auth                Include authentication
  --no-auth             Disable authentication
  --docker              Include Docker setup
  --git                 Initialize a new git repo (default)
  --no-git              Skip git initialization
  --npm                 Use npm as package manager
  --pnpm                Use pnpm as package manager
  --yarn                Use yarn as package manager
  --bun                 Use bun as package manager
  --drizzle             Use Drizzle ORM
  --prisma              Use Prisma ORM
  --install             Install dependencies (default)
  --no-install          Skip installing dependencies
  --turso               Set up Turso for SQLite database (default with sqlite)
  --no-turso            Skip Turso setup for SQLite database
  -h, --help            Display help

Examples

Create a project with default configuration:

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

Create a project with specific options:

npx create-better-t-stack my-app --postgres --prisma --auth --docker

Project Structure

The generated project follows a Turborepo monorepo structure:

my-app/
├── packages/
│   ├── client/         # Frontend application (React, TanStack Router)
│   └── server/         # Backend API (Hono, tRPC)
├── package.json        # Root package.json with Turborepo configuration
└── README.md           # Project documentation

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT

Created by Nitish Singh & Aman Varshney