Nextkit is a modern, cross-platform application framework designed with the philosophy that "The Web is the Application." It allows you to build a single codebase using web technologies and deploy it as a high-performance Web App, a Progressive Web App (PWA), and a Native Desktop/Mobile application.
- True Cross-Platform: Write once, deploy everywhere—Web, PWA, and Native (Windows, macOS, Linux, iOS, and Android).
- Web-First Philosophy: Leverages the power of modern web standards to provide a seamless experience across all platforms.
- Vite + React 19: Powered by React 19 and Vite for instant HMR and high-performance builds.
- Native Performance: Uses Tauri 2.0 to provide native system access and small binary sizes with a Rust-based backend.
- PWA Ready: Includes a built-in Service Worker architecture for offline capabilities and installation.
- Frontend: React 19 + Vite
- Native Bridge: Tauri (Rust)
- Service Worker: esbuild for SW bundling
- Styling: Tailwind CSS
- Language: TypeScript, Rust
Scaffold a new project using the interactive wizard (zero configuration required):
# Using npm
npm create nextkit
# Or using npx / pnpm / bun
npx create-nextkit
pnpm create nextkit
bun create nextkitWhen working inside this repository, you can run the interactive wizard directly:
npm run create
# Or specify directory directly:
npm run create -- ../my-appTo add a Nextkit frontend/ + src-tauri/ client into an existing project (preserving its existing src/ and package.json):
npx nextkit attach ../my-existing-project
# Or from inside Nextkit:
npm run attach -- ../my-existing-projectThe attach command copies frontend/, src-tauri/, public/, scripts/, cli/debug/, and frontend tooling configs, keeps your existing src/ untouched, excludes client/tooling paths (frontend, src-tauri, cli, vite.config.ts, etc.) from your existing root tsconfig.json (isolating @/ via frontend/tsconfig.json), and merges missing client scripts and dependencies into package.json.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | shcargo install tauri-clinpm installDevelopment scripts are managed via package.json.
| Command | Description |
|---|---|
npm run create |
Launches the interactive project creation wizard. |
npm run attach |
Attaches a Nextkit client (frontend/ + src-tauri/) to an existing project. |
npm run dev |
Starts the Vite dev server (port 4000), Service Worker watcher, and Debug Bridge. |
npm run build |
Builds the static export of the site and minifies the Service Worker. |
npm run start |
Serves the production build locally (from the dist directory). |
npm run check |
Runs Oxlint and TypeScript compiler check concurrently. |
npm run tauri <cmd> |
Executes Tauri commands (e.g., npm run tauri dev or npm run tauri build). |
To start the native application in development mode:
npm run tauri devTo build the native application for production:
npm run tauri buildTo start the native mobile application in development mode:
npm run tauri ios dev
npm run tauri android devTo build the native mobile application for production:
npm run tauri ios build
npm run tauri android buildfrontend/: Browser/WebView frontend workspace (isolated TypeScript project viafrontend/tsconfig.json,@/->frontend/).frontend/app/: Application UI entry points, HTML shells, and root App components.frontend/blocks/: Business-facing React UI blocks composed from base components.frontend/components/: Base reusable React components and UI infrastructure.frontend/core/: Core domain logic and app-specific pure logic.frontend/infra/: Infrastructure, platform adapters, shared types, and utility libraries.frontend/sw/: Service Worker source code.
src/(optional in attached projects): Host/core source code checked by roottsconfig.json(@/->src/), kept separate fromfrontend/.src-tauri/: Rust backend and native configuration.public/: Static assets, including icons and the bundledsw.js.
- Vite Documentation - Next generation frontend tooling.
- React Documentation - The library for web and native user interfaces.
- Tauri Documentation - Framework for building tiny, fast binaries for desktop and mobile.
This project is licensed under the MIT License - see the LICENSE file for details.