@korajs/cli 0.3.2 → 0.4.0

package/dist/index.d.cts

@@ -5,7 +5,7 @@ import * as citty from 'citty';
 declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
 type PackageManager = (typeof PACKAGE_MANAGERS)[number];
 /** Available project templates */
-declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic"];
+declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "tauri-react"];
 type TemplateName = (typeof TEMPLATES)[number];
 /** Metadata for a project template */
 interface TemplateInfo {
@@ -548,11 +548,13 @@ interface ProjectNameValidationResult {
  */
 declare function validateProjectName(name: string): ProjectNameValidationResult;
 
+type PlatformOption = 'web' | 'desktop-tauri';
 type FrameworkOption = 'react' | 'vue' | 'svelte' | 'solid';
 type AuthOption = 'none' | 'email-password' | 'oauth';
 type DatabaseOption = 'none' | 'sqlite' | 'postgres';
 type DatabaseProviderOption = 'none' | 'local' | 'supabase' | 'neon' | 'railway' | 'vercel-postgres' | 'custom';
 interface TemplateSelectionInput {
+    platform: PlatformOption;
     tailwind: boolean;
     sync: boolean;
     db: DatabaseOption;
@@ -567,6 +569,32 @@ declare function isAuthValue(value: string): value is AuthOption;
 declare function isDatabaseValue(value: string): value is DatabaseOption;
 declare function isDatabaseProviderValue(value: string): value is DatabaseProviderOption;
 
+interface CreatePreferences {
+    platform: PlatformOption;
+    framework: FrameworkOption;
+    tailwind: boolean;
+    sync: boolean;
+    db: DatabaseOption;
+    dbProvider: DatabaseProviderOption;
+    auth: AuthOption;
+    packageManager: PackageManager;
+}
+/**
+ * Preference store for scaffold-time defaults in `create-kora-app`.
+ */
+declare class PreferenceStore {
+    private readonly store;
+    constructor();
+    getCreatePreferences(): CreatePreferences | null;
+    saveCreatePreferences(preferences: CreatePreferences): void;
+    clearCreatePreferences(): void;
+}
+/**
+ * Gets preferences from storage or returns defaults when not available.
+ */
+declare function getCreatePreferencesOrDefault(store: PreferenceStore): CreatePreferences;
+declare function getDefaultCreatePreferences(): CreatePreferences;
+
 interface SelectOption<T extends string> {
     label: string;
     value: T;
@@ -613,32 +641,8 @@ declare class ClackPromptClient implements PromptClient {
     outro(message: string): void;
 }
 
-interface CreatePreferences {
-    framework: FrameworkOption;
-    tailwind: boolean;
-    sync: boolean;
-    db: DatabaseOption;
-    dbProvider: DatabaseProviderOption;
-    auth: AuthOption;
-    packageManager: PackageManager;
-}
-/**
- * Preference store for scaffold-time defaults in `create-kora-app`.
- */
-declare class PreferenceStore {
-    private readonly store;
-    constructor();
-    getCreatePreferences(): CreatePreferences | null;
-    saveCreatePreferences(preferences: CreatePreferences): void;
-    clearCreatePreferences(): void;
-}
-/**
- * Gets preferences from storage or returns defaults when not available.
- */
-declare function getCreatePreferencesOrDefault(store: PreferenceStore): CreatePreferences;
-declare function getDefaultCreatePreferences(): CreatePreferences;
-
 interface CreateFlags {
+    platform?: string;
     framework?: string;
     auth?: string;
     db?: string;
@@ -648,6 +652,7 @@ interface CreateFlags {
     useDefaults: boolean;
 }
 interface PreferenceResolutionResult {
+    platform: PlatformOption;
     framework: FrameworkOption;
     auth: AuthOption;
     db: DatabaseOption;

package/dist/index.d.ts

@@ -5,7 +5,7 @@ import * as citty from 'citty';
 declare const PACKAGE_MANAGERS: readonly ["pnpm", "npm", "yarn", "bun"];
 type PackageManager = (typeof PACKAGE_MANAGERS)[number];
 /** Available project templates */
-declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic"];
+declare const TEMPLATES: readonly ["react-tailwind-sync", "react-tailwind", "react-sync", "react-basic", "tauri-react"];
 type TemplateName = (typeof TEMPLATES)[number];
 /** Metadata for a project template */
 interface TemplateInfo {
@@ -548,11 +548,13 @@ interface ProjectNameValidationResult {
  */
 declare function validateProjectName(name: string): ProjectNameValidationResult;
 
+type PlatformOption = 'web' | 'desktop-tauri';
 type FrameworkOption = 'react' | 'vue' | 'svelte' | 'solid';
 type AuthOption = 'none' | 'email-password' | 'oauth';
 type DatabaseOption = 'none' | 'sqlite' | 'postgres';
 type DatabaseProviderOption = 'none' | 'local' | 'supabase' | 'neon' | 'railway' | 'vercel-postgres' | 'custom';
 interface TemplateSelectionInput {
+    platform: PlatformOption;
     tailwind: boolean;
     sync: boolean;
     db: DatabaseOption;
@@ -567,6 +569,32 @@ declare function isAuthValue(value: string): value is AuthOption;
 declare function isDatabaseValue(value: string): value is DatabaseOption;
 declare function isDatabaseProviderValue(value: string): value is DatabaseProviderOption;
 
+interface CreatePreferences {
+    platform: PlatformOption;
+    framework: FrameworkOption;
+    tailwind: boolean;
+    sync: boolean;
+    db: DatabaseOption;
+    dbProvider: DatabaseProviderOption;
+    auth: AuthOption;
+    packageManager: PackageManager;
+}
+/**
+ * Preference store for scaffold-time defaults in `create-kora-app`.
+ */
+declare class PreferenceStore {
+    private readonly store;
+    constructor();
+    getCreatePreferences(): CreatePreferences | null;
+    saveCreatePreferences(preferences: CreatePreferences): void;
+    clearCreatePreferences(): void;
+}
+/**
+ * Gets preferences from storage or returns defaults when not available.
+ */
+declare function getCreatePreferencesOrDefault(store: PreferenceStore): CreatePreferences;
+declare function getDefaultCreatePreferences(): CreatePreferences;
+
 interface SelectOption<T extends string> {
     label: string;
     value: T;
@@ -613,32 +641,8 @@ declare class ClackPromptClient implements PromptClient {
     outro(message: string): void;
 }
 
-interface CreatePreferences {
-    framework: FrameworkOption;
-    tailwind: boolean;
-    sync: boolean;
-    db: DatabaseOption;
-    dbProvider: DatabaseProviderOption;
-    auth: AuthOption;
-    packageManager: PackageManager;
-}
-/**
- * Preference store for scaffold-time defaults in `create-kora-app`.
- */
-declare class PreferenceStore {
-    private readonly store;
-    constructor();
-    getCreatePreferences(): CreatePreferences | null;
-    saveCreatePreferences(preferences: CreatePreferences): void;
-    clearCreatePreferences(): void;
-}
-/**
- * Gets preferences from storage or returns defaults when not available.
- */
-declare function getCreatePreferencesOrDefault(store: PreferenceStore): CreatePreferences;
-declare function getDefaultCreatePreferences(): CreatePreferences;
-
 interface CreateFlags {
+    platform?: string;
     framework?: string;
     auth?: string;
     db?: string;
@@ -648,6 +652,7 @@ interface CreateFlags {
     useDefaults: boolean;
 }
 interface PreferenceResolutionResult {
+    platform: PlatformOption;
     framework: FrameworkOption;
     auth: AuthOption;
     db: DatabaseOption;

package/dist/index.js

@@ -27,7 +27,7 @@ import {
   writeDockerfileArtifact,
   writeFlyTomlArtifact,
   writeRailwayJsonArtifact
-} from "./chunk-E7OCVRYL.js";
+} from "./chunk-YGVO4POI.js";
 import {
   ClackPromptClient,
   CliError,
@@ -54,7 +54,7 @@ import {
   saveResolvedPreferences,
   shouldSavePreferences,
   validateProjectName
-} from "./chunk-KTSRAPSE.js";
+} from "./chunk-CMSX76KM.js";
 export {
   ClackPromptClient,
   CliError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@korajs/cli",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Kora.js CLI tooling and project scaffolding",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -36,7 +36,7 @@
     "conf": "^15.1.0",
     "esbuild": "^0.28.0",
     "validate-npm-package-name": "^7.0.2",
-    "@korajs/core": "0.3.2"
+    "@korajs/core": "0.4.0"
   },
   "devDependencies": {
     "@types/node": "^25.5.2",

package/templates/tauri-react/.env.example

@@ -0,0 +1,7 @@
+# Sync server URL (used by the Tauri app to connect to the sync server)
+# In development, defaults to ws://localhost:3001/kora-sync
+# For production builds, set this to your deployed server URL:
+# VITE_SYNC_URL=wss://your-server.example.com/kora-sync
+
+# Sync server port
+PORT=3001

package/templates/tauri-react/.github/workflows/release-desktop.yml

@@ -0,0 +1,107 @@
+# Build and release desktop binaries for macOS, Windows, and Linux.
+#
+# Trigger: Push a version tag (e.g., v1.0.0) or run manually.
+#
+# Prerequisites:
+#   1. Generate Tauri signing keys:
+#      pnpm tauri signer generate -w ~/.tauri/myapp.key
+#   2. Add secrets to your GitHub repo:
+#      - TAURI_SIGNING_PRIVATE_KEY: Contents of ~/.tauri/myapp.key
+#      - TAURI_SIGNING_PRIVATE_KEY_PASSWORD: Password used during generation
+#   3. (Optional) For macOS notarization:
+#      - APPLE_CERTIFICATE: Base64-encoded .p12 certificate
+#      - APPLE_CERTIFICATE_PASSWORD: Certificate password
+#      - APPLE_SIGNING_IDENTITY: e.g., "Developer ID Application: Your Name (TEAM_ID)"
+#      - APPLE_ID: Apple ID email
+#      - APPLE_PASSWORD: App-specific password
+#      - APPLE_TEAM_ID: Your Apple Developer Team ID
+#
+# After the workflow runs, a GitHub Release is created with installers
+# for all platforms plus an update manifest (latest.json) for auto-updates.
+
+name: Release Desktop
+
+on:
+  push:
+    tags:
+      - 'v*'
+  workflow_dispatch:
+    inputs:
+      tag:
+        description: 'Version tag (e.g., v1.0.0)'
+        required: true
+
+permissions:
+  contents: write
+
+jobs:
+  build:
+    strategy:
+      fail-fast: false
+      matrix:
+        include:
+          - platform: macos-latest
+            args: '--target aarch64-apple-darwin'
+            rust_target: aarch64-apple-darwin
+          - platform: macos-latest
+            args: '--target x86_64-apple-darwin'
+            rust_target: x86_64-apple-darwin
+          - platform: ubuntu-22.04
+            args: ''
+            rust_target: ''
+          - platform: windows-latest
+            args: ''
+            rust_target: ''
+
+    runs-on: ${{ matrix.platform }}
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install system dependencies (Linux)
+        if: matrix.platform == 'ubuntu-22.04'
+        run: |
+          sudo apt-get update
+          sudo apt-get install -y libwebkit2gtk-4.1-dev libappindicator3-dev librsvg2-dev patchelf
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - uses: pnpm/action-setup@v4
+        with:
+          version: 9
+
+      - name: Install Rust stable
+        uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: ${{ matrix.rust_target }}
+
+      - name: Rust cache
+        uses: swatinem/rust-cache@v2
+        with:
+          workspaces: './src-tauri -> target'
+
+      - name: Install dependencies
+        run: pnpm install
+
+      - name: Build and release
+        uses: tauri-apps/tauri-action@v0
+        env:
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+          TAURI_SIGNING_PRIVATE_KEY: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY }}
+          TAURI_SIGNING_PRIVATE_KEY_PASSWORD: ${{ secrets.TAURI_SIGNING_PRIVATE_KEY_PASSWORD }}
+          # macOS code signing (optional)
+          APPLE_CERTIFICATE: ${{ secrets.APPLE_CERTIFICATE }}
+          APPLE_CERTIFICATE_PASSWORD: ${{ secrets.APPLE_CERTIFICATE_PASSWORD }}
+          APPLE_SIGNING_IDENTITY: ${{ secrets.APPLE_SIGNING_IDENTITY }}
+          APPLE_ID: ${{ secrets.APPLE_ID }}
+          APPLE_PASSWORD: ${{ secrets.APPLE_PASSWORD }}
+          APPLE_TEAM_ID: ${{ secrets.APPLE_TEAM_ID }}
+        with:
+          tagName: ${{ github.ref_name || github.event.inputs.tag }}
+          releaseName: '${{ github.ref_name || github.event.inputs.tag }}'
+          releaseBody: 'See the assets below to download and install.'
+          releaseDraft: true
+          prerelease: false
+          args: ${{ matrix.args }}

package/templates/tauri-react/README.md.hbs

@@ -0,0 +1,148 @@
+# {{projectName}}
+
+A native desktop application built with [Kora.js](https://ehoneahobed.github.io/kora/) and [Tauri](https://tauri.app). Uses native SQLite for fast local storage and syncs data across devices via a lightweight sync server.
+
+## Getting Started
+
+```bash
+pnpm dev
+```
+
+This starts both the sync server and the Tauri desktop app. The first launch compiles the Rust backend (2-5 minutes). Subsequent launches are fast.
+
+On first launch, you'll see a setup screen to enter your sync server URL. For local development, use `ws://localhost:3001/kora-sync` (the local sync server started by `pnpm dev`). You can also skip setup to use the app in local-only mode.
+
+## Project Structure
+
+```
+src/
+  schema.ts          # Data schema definition
+  main.tsx           # Entry point
+  AppShell.tsx       # Setup flow + Kora initialization
+  App.tsx            # Main application UI
+  SetupScreen.tsx    # First-launch server configuration
+  sync-config.ts     # Runtime sync URL storage
+  updater.ts         # Auto-update checker
+src-tauri/
+  Cargo.toml         # Rust dependencies (Kora SQLite + updater plugins)
+  tauri.conf.json    # Window, bundle, and updater config
+  capabilities/      # Tauri security permissions
+  src/
+    main.rs          # Rust entry point
+    lib.rs           # Plugin registration
+server.ts            # Kora sync server
+dev.ts               # Dev orchestrator (starts sync + Tauri together)
+kora.config.ts       # Kora configuration
+.github/workflows/
+  release-desktop.yml  # CI/CD for cross-platform builds
+```
+
+## Scripts
+
+| Script | Description |
+|--------|-------------|
+| `pnpm dev` | Start sync server + Tauri app together |
+| `pnpm dev:app` | Start Tauri app only (no sync server) |
+| `pnpm dev:server` | Start sync server only |
+| `pnpm build` | Build desktop app for distribution |
+| `pnpm deploy:server` | Deploy sync server to the cloud |
+
+## Distributing to Organizations
+
+This app is designed to be distributed to multiple organizations. Each organization gets the **same binary** and connects to their own sync server.
+
+### 1. Deploy a sync server for each organization
+
+```bash
+pnpm deploy:server
+```
+
+Or deploy manually to any Node.js host. Each org gets their own server (or share one with multi-tenant scoping).
+
+### 2. Build the desktop binary
+
+```bash
+pnpm build
+```
+
+No need to bake in a sync URL — users configure it on first launch.
+
+If you want to pre-configure the URL (e.g., for a specific org):
+
+```bash
+VITE_SYNC_URL=wss://acme-corp.example.com/kora-sync pnpm build
+```
+
+### 3. Set up auto-updates
+
+1. Generate signing keys:
+   ```bash
+   pnpm tauri signer generate -w ~/.tauri/myapp.key
+   ```
+
+2. Add the public key to `src-tauri/tauri.conf.json` under `plugins.updater.pubkey`.
+
+3. Set the update endpoint:
+   ```json
+   "endpoints": ["https://github.com/YOUR_ORG/YOUR_REPO/releases/latest/download/latest.json"]
+   ```
+
+4. Add `TAURI_SIGNING_PRIVATE_KEY` and `TAURI_SIGNING_PRIVATE_KEY_PASSWORD` to your GitHub repo secrets.
+
+5. Push a version tag to trigger a release:
+   ```bash
+   git tag v1.0.0 && git push origin v1.0.0
+   ```
+
+The GitHub Actions workflow builds for macOS, Windows, and Linux, creating a draft release with all installers.
+
+### 4. Distribute installers
+
+Built installers are in `src-tauri/target/release/bundle/`:
+
+| Platform | Output |
+|----------|--------|
+| macOS | `.dmg` and `.app` bundle |
+| Windows | `.msi` and `.exe` installer |
+| Linux | `.deb`, `.rpm`, `.AppImage` |
+
+Share these with your users. Installed apps auto-update when you push new releases.
+
+## First-Launch Experience
+
+When users install and open the app:
+
+1. **Setup screen** asks for the sync server URL
+2. User enters the URL provided by their organization admin
+3. App connects, verifies the server, and saves the URL locally
+4. On subsequent launches, the app connects automatically
+
+Users can also skip setup and use the app offline — they can connect later from the settings gear icon.
+
+## Environment Variables
+
+| Variable | Default | Description |
+|----------|---------|-------------|
+| `VITE_SYNC_URL` | (none) | Pre-configure sync URL at build time |
+| `PORT` | `3001` | Sync server port |
+
+## Code Signing
+
+### macOS
+
+For distribution outside the Mac App Store, you need a Developer ID certificate from Apple:
+
+1. Enroll in the [Apple Developer Program](https://developer.apple.com/programs/)
+2. Create a "Developer ID Application" certificate
+3. Add the certificate and credentials to your GitHub secrets (see `.github/workflows/release-desktop.yml`)
+
+### Windows
+
+For SmartScreen trust, get an EV code signing certificate from a provider like DigiCert or Sectigo. Set the certificate in your CI environment.
+
+## Learn More
+
+- [Tauri Desktop Guide](https://ehoneahobed.github.io/kora/guide/tauri-desktop)
+- [Deployment Guide](https://ehoneahobed.github.io/kora/guide/deployment)
+- [Sync Configuration](https://ehoneahobed.github.io/kora/guide/sync-configuration)
+- [Schema Design](https://ehoneahobed.github.io/kora/guide/schema-design)

package/templates/tauri-react/dev.ts

@@ -0,0 +1,37 @@
+import { spawn, type ChildProcess } from 'node:child_process'
+
+// Starts both the sync server and the Tauri app with a single command.
+// The sync server runs in the background so the desktop app can sync
+// data across devices during development.
+
+const children: ChildProcess[] = []
+
+function cleanup() {
+  for (const child of children) {
+    child.kill()
+  }
+  process.exit()
+}
+
+process.on('SIGINT', cleanup)
+process.on('SIGTERM', cleanup)
+
+// Start the sync server
+const syncServer = spawn('tsx', ['server.ts'], {
+  stdio: 'inherit',
+  shell: true,
+})
+children.push(syncServer)
+
+// Start the Tauri app (manages Vite dev server + Rust build)
+const tauriApp = spawn('tauri', ['dev'], {
+  stdio: 'inherit',
+  shell: true,
+})
+children.push(tauriApp)
+
+// If the Tauri app exits, stop everything
+tauriApp.on('close', (code) => {
+  syncServer.kill()
+  process.exit(code ?? 0)
+})

package/templates/tauri-react/index.html.hbs

@@ -0,0 +1,16 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{projectName}}</title>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      body { font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; }
+    </style>
+  </head>
+  <body>
+    <div id="root"></div>
+    <script type="module" src="/src/main.tsx"></script>
+  </body>
+</html>

package/templates/tauri-react/kora.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'korajs/config'
+
+export default defineConfig({
+	schema: './src/schema.ts',
+	dev: {
+		port: 5173,
+		sync: {
+			enabled: true,
+			port: 3001,
+			store: 'sqlite',
+		},
+		watch: {
+			enabled: true,
+			debounceMs: 300,
+		},
+	},
+})

package/templates/tauri-react/package.json.hbs

@@ -0,0 +1,44 @@
+{
+  "name": "{{projectName}}",
+  "version": "0.0.1",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "tsx dev.ts",
+    "dev:app": "tauri dev",
+    "dev:server": "tsx server.ts",
+    "build": "tauri build",
+    "start:server": "node --import tsx server.ts",
+    "deploy:server": "kora deploy"
+  },
+  "dependencies": {
+    "korajs": "{{koraVersion}}",
+    "@korajs/core": "{{koraVersion}}",
+    "@korajs/react": "{{koraVersion}}",
+    "@korajs/tauri": "{{koraVersion}}",
+    "@tauri-apps/api": "^2.0.0",
+    "@tauri-apps/plugin-updater": "^2.0.0",
+    "lucide-react": "^0.468.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@korajs/cli": "{{koraVersion}}",
+    "@korajs/server": "{{koraVersion}}",
+    "@tauri-apps/cli": "^2.0.0",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@vitejs/plugin-react": "^4.3.0",
+    "better-sqlite3": "^12.9.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0",
+    "vite": "^6.0.0",
+    "ws": "^8.18.0"
+  },
+  "pnpm": {
+    "onlyBuiltDependencies": [
+      "better-sqlite3",
+      "esbuild"
+    ]
+  }
+}

package/templates/tauri-react/server.ts

@@ -0,0 +1,23 @@
+import { createProductionServer, createSqliteServerStore } from '@korajs/server'
+
+// Sync server for your Kora desktop app.
+// Started automatically by `pnpm dev`, or run standalone with `pnpm dev:server`.
+// Deploy with `pnpm deploy:server` (uses kora deploy).
+//
+// All desktop clients connect to this server to sync data across devices.
+// For production, deploy this server and set VITE_SYNC_URL when building
+// the desktop app: VITE_SYNC_URL=wss://your-server.com/kora-sync pnpm build
+
+const store = createSqliteServerStore({ filename: './kora-server.db' })
+
+const server = createProductionServer({
+  store,
+  port: Number(process.env.PORT) || 3001,
+  staticDir: './dist',
+  syncPath: '/kora-sync',
+})
+
+server.start().then((url) => {
+  console.log(`Kora sync server running at ${url}`)
+  console.log(`  Sync endpoint: ${url.replace('http', 'ws')}/kora-sync`)
+})