GitHub - odest/catalyzer: Production-grade cross-platform starter template to build Web, Desktop, and Mobile apps from a single codebase. Powered by Next.js, Tauri, and Turborepo.

Catalyzer 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 catalyzer@latest, 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 catalyzer@latest 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)

Note

Building native apps requires additional platform-specific tools (e.g., Xcode, Android Studio, C++ Build Tools). See our Docs or Tauri's Prerequisites Guide for details.

Create a New Project

npm create catalyzer@latest

Using other package managers

pnpm create catalyzer@latest
yarn create catalyzer@latest
npx create-catalyzer@latest
bunx create-catalyzer@latest

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.

Configuration

Before deploying or sharing your project, make sure to update the site metadata (URLs, headline, and description) in: packages/core/src/config/site.ts

Important

GitHub Actions & Release Please: For the automated release pipelines and changelog generation to function properly, you must configure the following repository settings:

Workflow Permissions (Settings > Actions > General): Grant Read and write permissions and check Allow GitHub Actions to create and approve pull requests.
Pull Request Merging (Settings > General): To maintain the required linear git history for the release bot, uncheck Allow merge commits and Allow rebase merging. Leave only Allow squash merging checked, and set the default commit message to Pull request title.

📦 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 catalyzer@latest)
  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

Platform	Status	Links
🌐 Web	✅ Available	Live Demo
📱 PWA	✅ Available	Live Demo
🪟 Windows	✅ Available	Download Demo
🍎 macOS	✅ Available	Download Demo
🐧 Linux	✅ Available	Download Demo
🤖 Android	✅ Available	Download Demo
📱 iOS	✅ Available	Download Demo

🛠️ Tech Stack

⌨️ Core Commands

pnpm dev                  # Start all apps in dev mode
pnpm build                # Build everything
pnpm lint                 # Lint all packages
pnpm format               # Format all code
pnpm typecheck            # 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