Kat-Stack CLI

A command-line interface tool for generating and managing full-stack TypeScript monorepos with an opinionated stack based on Next.js, Hono, and Turborepo.

Installation

npm install -g kat-stack
# or
pnpm add -g kat-stack
# or
bun install -g kat-stack

Or use with npx (no installation required):

npx kat-stack init

Quick Start

Initialize a New Project

kat-stack init

This will prompt you for:

• Project name
• Backend service names (one or more)
• Whether to include a database with each service
• Frontend application names (one or more)

Add a New Service

After initializing a project, you can add additional services:

# Add a backend service
kat-stack add backend

# Add a frontend app
kat-stack add frontend

Commands

kat-stack init

Creates a new Kat-Stack monorepo with:

• Turborepo structure
• Backend service(s) with Hono, TypeScript, and optional SQLite database
• Frontend app(s) with Next.js 15 App Router and Tailwind CSS
• Shared packages (eslint-config, typescript-config, ui)
• Pre-configured authentication with better-auth
• Cursor rules for consistent code conventions

kat-stack add <type>

Adds a new service or app to an existing Kat-Stack monorepo.

• kat-stack add backend - Adds a new backend service
• kat-stack add frontend - Adds a new frontend application

Project Structure

your-project/
├── apps/
│   ├── web/          # Frontend applications
│   └── admin/
├── services/
│   ├── api/          # Backend services
│   └── auth-service/
├── packages/
│   ├── eslint-config/
│   ├── typescript-config/
│   └── ui/
├── turbo.json
├── package.json
└── tsconfig.json

Features

• Opinionated Stack: Fixed, high-quality stack based on proven patterns
• Type Safety: Full TypeScript support with strict mode
• Monorepo: Turborepo for efficient builds and development
• Authentication: Pre-configured with better-auth
• Database: SQLite with Drizzle ORM (optional per service)
• UI Components: Shadcn UI components pre-configured
• Cursor Rules: Auto-generated rules for consistent code style
• Package Manager Support: Automatically detects and uses npm, pnpm, or bun

Requirements

• Node.js >= 18
• npm, pnpm, or bun

Development

To contribute to Kat-Stack CLI:

cd packages/kat-stack-cli
pnpm install
pnpm dev

Extracting Templates

To update the templates from the base project:

cd packages/kat-stack-cli
pnpm extract-templates

Publishing

To publish a new version:

cd packages/kat-stack-cli
pnpm build
npm publish

License

MIT