Introduction
A cross-platform monorepo for Web, Desktop, and Mobile. Built on Tauri 2 and Next.js.
TNTStack is a starting point for building cross-platform apps. One codebase targets Web (SSR + PWA), Desktop (Windows, macOS, Linux), and Mobile (Android, iOS). The web deployment operates as a standard Next.js application with Server-Side Rendering (SSR) and Progressive Web App (PWA) capabilities. For native targets, we use Tauri v2. The native build pipeline takes a static export of the Next.js application and embeds it within a Rust-powered webview.
Both apps pull pages and state from a shared core package, and design system primitives from a shared UI package. You change a button once, it updates everywhere.
Features
Cross-Platform
Web, Desktop, and Mobile from one codebase. SSR for web, static export for native.
Shared Architecture
Business logic and pages in packages/core. Design system primitives and themes in packages/ui. Both apps consume them directly.
40+ Themes
OKLCh color palettes with light/dark variants. Custom themes via CSS custom properties.
10 Languages
Type-safe i18n implemented via next-intl. Supports 10 locales out of the box with dynamic routing.
Command Palette
Global ⌘K menu for quick navigation, settings, theme switching, and language selection.
Keyboard Shortcuts
Application-wide hotkeys for navigation, mode toggling, and sidebar control.
PWA
Offline support, precaching, and runtime caching strategies for the web app.
CI/CD
GitHub Actions for validation, Release Please for versioning, automated desktop and Android builds.
Platform
| Target | Development Server | Production Build |
|---|---|---|
| Web + PWA | pnpm web dev | pnpm web build |
| Windows / macOS / Linux | pnpm tauri dev | pnpm tauri build |
| Android | pnpm tauri android dev | pnpm tauri android build |
| iOS | pnpm tauri ios dev | pnpm tauri ios build |
Get Started
Initialization
npm create @tntstack/app@latestLocal Development
cd <your-project-name>
pnpm install
pnpm devThe web development server starts at http://localhost:3000 and the native desktop app in parallel.
Full setup with prerequisites and platform-specific configuration: Quick Start.
Dive In
Tech Stack
Technologies, versions, and why they're here.
Quick Start
Prerequisites, CLI options, and first run.
Architecture
Monorepo layout and package dependency graph.
Theming
Theme system, custom palettes, and sidebar variants.
Deployment
CI/CD, desktop builds, Android signing, web hosting.
Commands
Every CLI command and workspace script.