Leo Stack

An opinionated Better-T-Stack fork for scaffolding type-safe TypeScript apps with local-first developer ergonomics, Portless dev URLs, and tweakcn-inspired themes.

Philosophy

• Opinionated defaults: Turborepo, Portless, Better Auth, Drizzle, and a polished default theme are ready out of the box.
• Local-first workflows: generated apps use stable named .localhost URLs through Portless instead of memorized port numbers.
• Themeable from creation: choose from the built-in tweakcn preset set during scaffolding.
• Free and open source: forever.

Quick Start

Recommended install:

npm config set @opencoredev:registry https://npm.pkg.github.com
npm install -g @opencoredev/leo-stack
leo-stack create my-app

When installed globally, leo-stack checks GitHub Packages for newer releases and asks before updating itself.

One-time command after the scope registry is configured:

npx @opencoredev/leo-stack@latest create my-app

Features

• Frontend: React (TanStack Router, React Router, TanStack Start), Next.js, Nuxt, Svelte, Solid, Astro, React Native (Bare, NativeWind, Unistyles), or none
• Backend: Hono, Express, Fastify, Elysia, Self (fullstack web app), Convex, or none
• API: tRPC or oRPC (or none)
• Runtime: Bun, Node.js, or Cloudflare Workers
• Databases: SQLite, PostgreSQL, MySQL, MongoDB (or none)
• ORMs: Drizzle, Prisma, Mongoose (or none)
• Auth: Better Auth or Clerk (optional)
• Addons: Portless, Turborepo, Nx, PWA, Tauri, Electrobun, Biome, Lefthook, Husky, Starlight, Fumadocs, Ultracite, Oxlint, MCP, OpenTUI, WXT, Skills
• Themes: Built-in tweakcn presets, saved in bts.jsonc and applied to the generated shared UI package
• Examples: Todo, AI
• DB Setup: Turso, Neon, Supabase, Prisma PostgreSQL, MongoDB Atlas, Cloudflare D1, Docker
• Web Deploy: Cloudflare Workers

Type safety end-to-end, clean monorepo layout, and opinionated defaults that still let you choose the pieces you need.

Repository Structure

This repository is organized as a monorepo containing:

• CLI: apps/cli - The scaffolding CLI tool
• Documentation: apps/web - Official website and documentation

Documentation

This fork tracks Better-T-Stack’s architecture while adding Leo Stack defaults for local URLs and theme selection.

Development

# Clone the repository
git clone <your-leo-stack-repo-url>

# Install dependencies
bun install

# Start CLI development
bun dev:cli

# Start website development
bun dev:web

# Publish the Leo Stack CLI to GitHub Packages
bun run publish:github

Want to contribute?

Please read the Contribution Guide first and open an issue before starting new features to ensure alignment with project goals.

• Docs: ./apps/web/content/docs/contributing.mdx
• Repo guide: ./.github/CONTRIBUTING.md