TNTStack is a starting point for building cross-platform apps. It covers Web, Desktop (Windows, macOS, Linux), and Mobile (Android, iOS) from the same shared UI, themes, and logic. Run the CLI, scaffold your project, and start building.

💡 Philosophy

• Unified - One codebase, every platform. Web and native share the same pages, components, and state through packages/core and packages/ui.
• Ready - 40+ themes, 10 languages, CI/CD, and a scaffolding CLI out of the box.
• Portable - Run npm create @tntstack/app, brand your project, and own the code. No lock-in.
• Strict - End-to-end TypeScript, shared lint rules, and automated releases keep things solid.

✨ Features

• Cross-Platform - Single codebase deploys to web, desktop, and mobile
• Shared Architecture - Design system primitives in packages/ui, business logic and pages in packages/core
• 40+ Themes - Light and dark variants of 40+ color schemes, plus custom theming support
• 10 Languages - Type-safe i18n works with both SSR (web) and static export (native)
• PWA - Offline support, precaching, and runtime caching strategies for the web app
• Landing Page - Pre-built, SEO-optimized marketing pages designed to pitch your product
• Docs Page - Integrated, MDX-powered documentation architecture ready for your technical guides
• Scaffolding CLI - npm create @tntstack/app sets up a branded, configured project
• Turborepo - Dependency-aware builds and caching
• TypeScript - Strict, end-to-end type safety with shared configs
• CI/CD - GitHub Actions + Release Please for automated builds and versioning

🚀 Quick Start

Prerequisites

• Node.js v20 or higher
• pnpm v8 or higher
• Rust (latest stable, needed for native builds)

Create a New Project

npm create @tntstack/app@latest

pnpm create @tntstack/app@latest
yarn create @tntstack/app
npx @tntstack/create-app
bunx @tntstack/create-app

The CLI configures your project name, identifiers, and versions. It can also initialize git and install dependencies for you.

Start Developing

cd <your-project-name>

# Run this only if you skipped dependency installation during scaffolding
pnpm install

pnpm dev

This starts both the web app (http://localhost:3000) and the native desktop app in parallel.

📦 Overview

Monorepo Structure

apps/
  web/                → Next.js SSR — web app, landing page, docs, PWA
  native/             → Next.js (Static) + Tauri 2 — desktop & mobile

packages/
  core/               → Business logic: pages, stores, hooks, providers, config
  ui/                 → Design system: shadcn/ui primitives, themes, styles
  i18n/               → 10-language type-safe translations (SSR & static)
  cli/                → Scaffolding tool (npm create @tntstack/app)
  eslint-config/      → Shared ESLint rules (Flat Config)
  typescript-config/  → Shared TypeScript configs

Both web and native import pages, layouts, and state from packages/core, and design system primitives from packages/ui. The web app runs with SSR and PWA support. The native app uses a static HTML export served by Tauri's Rust backend.

Supported Platforms

🛠️ Tech Stack

⌨️ Core Commands

pnpm dev                  # Start all apps in dev mode
pnpm build                # Build everything
pnpm lint                 # Lint all packages
pnpm check-types          # TypeScript validation across all workspaces
pnpm web dev              # Web app only
pnpm tauri dev            # Desktop app only
pnpm tauri android dev    # Android app
pnpm tauri ios dev        # iOS app
pnpm shadcn add           # Add shadcn/ui components to packages/ui
pnpm clean                # Clean all build outputs

📖 Documentation

For setup guides, architecture, theming, i18n, deployment and more, see Documentation

🤝 Contributing

See CONTRIBUTING.md.

📄 License

MIT