@korajs/cli 1.0.0-beta.6 → 1.0.0-beta.9

package/templates/react-sync/server.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import {
 	type CreateKoraAuthServerOptions,
 	createKoraAuthServer,
@@ -12,6 +13,45 @@ import {
 } from '@korajs/server'
 import schema from './src/schema'
 
+loadLocalEnv()
+
+function loadLocalEnv(mode = process.env.NODE_ENV || 'development') {
+	const existingKeys = new Set(Object.keys(process.env))
+	for (const file of ['.env', '.env.local', `.env.${mode}`, `.env.${mode}.local`]) {
+		if (!existsSync(file)) continue
+		for (const [key, value] of Object.entries(parseEnvFile(readFileSync(file, 'utf8')))) {
+			if (!existingKeys.has(key)) {
+				process.env[key] = value
+			}
+		}
+	}
+}
+
+function parseEnvFile(contents: string): Record<string, string> {
+	const env: Record<string, string> = {}
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim()
+		if (!line || line.startsWith('#')) continue
+		const normalized = line.startsWith('export ') ? line.slice('export '.length).trim() : line
+		const equalsIndex = normalized.indexOf('=')
+		if (equalsIndex <= 0) continue
+		const key = normalized.slice(0, equalsIndex).trim()
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue
+		env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim())
+	}
+	return env
+}
+
+function parseEnvValue(value: string): string {
+	const quote = value[0]
+	if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+		const inner = value.slice(1, -1)
+		return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner
+	}
+	const commentIndex = value.search(/\s#/)
+	return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim()
+}
+
 async function createStore() {
 	if (process.env.DATABASE_URL) {
 		return createPostgresServerStore({
@@ -36,7 +76,10 @@ async function start() {
 		staticDir: './dist',
 		syncPath,
 		httpRoutes: auth ? [{ path: '/auth', handle: auth.handleRequest }] : undefined,
-		syncOptions: auth ? { auth: auth.auth } : undefined,
+		syncOptions: {
+			schemaVersion: schema.version,
+			...(auth ? { auth: auth.auth } : {}),
+		},
 		operationalAuth: {
 			adminToken: process.env.KORA_ADMIN_TOKEN,
 			metricsToken: process.env.KORA_METRICS_TOKEN,

package/templates/react-sync/src/main.tsx

@@ -26,7 +26,7 @@ const app = createApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 // Connect to sync server once the app is ready

package/templates/react-sync/src/vite-env.d.ts

@@ -1,4 +1,5 @@
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 }
 

package/templates/react-sync/vite.config.ts

@@ -85,7 +85,7 @@ export default defineConfig({
 	server: {
 		allowedHosts: true,
 		watch: {
-			ignored: ['**/.kora/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
+			ignored: ['**/.kora/**', '**/kora/generated/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
 		},
 		proxy: {
 			'/kora-sync': {

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

@@ -47,7 +47,7 @@ To enable real-time sync across devices, update `src/main.tsx`:
 const app = createApp({
   schema,
   sync: {
-    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001',
+    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001/kora-sync',
   },
   // ...
 })

package/templates/react-tailwind/src/main.tsx

@@ -12,7 +12,7 @@ const app = createApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 createRoot(document.getElementById('root')!).render(

package/templates/react-tailwind/src/vite-env.d.ts

@@ -1,4 +1,5 @@
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 }
 

package/templates/react-tailwind-sync/README.md.hbs

@@ -11,7 +11,7 @@ npm run dev
 This starts both the Vite dev server and the Kora sync server.
 
 - **App**: http://localhost:5173
-- **Sync server**: ws://localhost:3001
+- **Sync server**: ws://localhost:3001/kora-sync
 
 ## Project Structure
 
@@ -40,7 +40,7 @@ writes, and `useTodos.ts` is the React binding that exposes todo data and action
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `VITE_SYNC_URL` | `ws://localhost:3001` | WebSocket URL for the sync server |
+| `VITE_SYNC_URL` | `ws://localhost:3001/kora-sync` | WebSocket URL for the sync endpoint |
 | `VITE_AUTH_URL` | current origin | HTTP URL for `/auth/*` routes |
 | `PORT` | `3001` | Sync server port |
 | `KORA_SERVER_DB` | `./.kora/kora-server.db` | SQLite file used by the sync server when `DATABASE_URL` is empty |
@@ -95,7 +95,7 @@ The client and sync server must be deployed separately:
 Set `VITE_SYNC_URL` to your deployed sync server URL when building:
 
 ```bash
-VITE_SYNC_URL=wss://your-server.example.com npm run build
+VITE_SYNC_URL=wss://your-server.example.com/kora-sync npm run build
 ```
 
 ## Learn More

package/templates/react-tailwind-sync/server.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import {
 	type CreateKoraAuthServerOptions,
 	createKoraAuthServer,
@@ -12,6 +13,45 @@ import {
 } from '@korajs/server'
 import schema from './src/schema'
 
+loadLocalEnv()
+
+function loadLocalEnv(mode = process.env.NODE_ENV || 'development') {
+	const existingKeys = new Set(Object.keys(process.env))
+	for (const file of ['.env', '.env.local', `.env.${mode}`, `.env.${mode}.local`]) {
+		if (!existsSync(file)) continue
+		for (const [key, value] of Object.entries(parseEnvFile(readFileSync(file, 'utf8')))) {
+			if (!existingKeys.has(key)) {
+				process.env[key] = value
+			}
+		}
+	}
+}
+
+function parseEnvFile(contents: string): Record<string, string> {
+	const env: Record<string, string> = {}
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim()
+		if (!line || line.startsWith('#')) continue
+		const normalized = line.startsWith('export ') ? line.slice('export '.length).trim() : line
+		const equalsIndex = normalized.indexOf('=')
+		if (equalsIndex <= 0) continue
+		const key = normalized.slice(0, equalsIndex).trim()
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue
+		env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim())
+	}
+	return env
+}
+
+function parseEnvValue(value: string): string {
+	const quote = value[0]
+	if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+		const inner = value.slice(1, -1)
+		return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner
+	}
+	const commentIndex = value.search(/\s#/)
+	return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim()
+}
+
 async function createStore() {
 	if (process.env.DATABASE_URL) {
 		return createPostgresServerStore({
@@ -36,7 +76,10 @@ async function start() {
 		staticDir: './dist',
 		syncPath,
 		httpRoutes: auth ? [{ path: '/auth', handle: auth.handleRequest }] : undefined,
-		syncOptions: auth ? { auth: auth.auth } : undefined,
+		syncOptions: {
+			schemaVersion: schema.version,
+			...(auth ? { auth: auth.auth } : {}),
+		},
 		operationalAuth: {
 			adminToken: process.env.KORA_ADMIN_TOKEN,
 			metricsToken: process.env.KORA_METRICS_TOKEN,

package/templates/react-tailwind-sync/src/main.tsx

@@ -26,7 +26,7 @@ const app = createApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 // Connect to sync server once the app is ready

package/templates/react-tailwind-sync/src/vite-env.d.ts

@@ -1,4 +1,5 @@
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 }
 

package/templates/react-tailwind-sync/vite.config.ts

@@ -86,7 +86,7 @@ export default defineConfig({
 	server: {
 		allowedHosts: true,
 		watch: {
-			ignored: ['**/.kora/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
+			ignored: ['**/.kora/**', '**/kora/generated/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
 		},
 		proxy: {
 			'/kora-sync': {

package/templates/svelte-basic/README.md.hbs

@@ -47,7 +47,7 @@ To enable real-time sync across devices, update `src/main.tsx`:
 const app = createApp({
   schema,
   sync: {
-    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001',
+    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001/kora-sync',
   },
   // ...
 })

package/templates/svelte-basic/src/main.ts

@@ -10,7 +10,7 @@ const kora = createKoraApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 mount(Root, { target: document.getElementById('app')!, props: { kora } })

package/templates/svelte-sync/README.md.hbs

@@ -11,7 +11,7 @@ npm run dev
 This starts both the Vite dev server and the Kora sync server.
 
 - **App**: http://localhost:5173
-- **Sync server**: ws://localhost:3001
+- **Sync server**: ws://localhost:3001/kora-sync
 
 ## Project Structure
 
@@ -40,7 +40,7 @@ writes, and `useTodos.ts` is the React binding that exposes todo data and action
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `VITE_SYNC_URL` | `ws://localhost:3001` | WebSocket URL for the sync server |
+| `VITE_SYNC_URL` | `ws://localhost:3001/kora-sync` | WebSocket URL for the sync endpoint |
 | `VITE_AUTH_URL` | current origin | HTTP URL for `/auth/*` routes |
 | `PORT` | `3001` | Sync server port |
 | `KORA_SERVER_DB` | `./.kora/kora-server.db` | SQLite file used by the sync server when `DATABASE_URL` is empty |
@@ -95,7 +95,7 @@ The client and sync server must be deployed separately:
 Set `VITE_SYNC_URL` to your deployed sync server URL when building:
 
 ```bash
-VITE_SYNC_URL=wss://your-server.example.com npm run build
+VITE_SYNC_URL=wss://your-server.example.com/kora-sync npm run build
 ```
 
 ## Learn More

package/templates/svelte-sync/server.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import {
 	type CreateKoraAuthServerOptions,
 	createKoraAuthServer,
@@ -12,6 +13,45 @@ import {
 } from '@korajs/server'
 import schema from './src/schema'
 
+loadLocalEnv()
+
+function loadLocalEnv(mode = process.env.NODE_ENV || 'development') {
+	const existingKeys = new Set(Object.keys(process.env))
+	for (const file of ['.env', '.env.local', `.env.${mode}`, `.env.${mode}.local`]) {
+		if (!existsSync(file)) continue
+		for (const [key, value] of Object.entries(parseEnvFile(readFileSync(file, 'utf8')))) {
+			if (!existingKeys.has(key)) {
+				process.env[key] = value
+			}
+		}
+	}
+}
+
+function parseEnvFile(contents: string): Record<string, string> {
+	const env: Record<string, string> = {}
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim()
+		if (!line || line.startsWith('#')) continue
+		const normalized = line.startsWith('export ') ? line.slice('export '.length).trim() : line
+		const equalsIndex = normalized.indexOf('=')
+		if (equalsIndex <= 0) continue
+		const key = normalized.slice(0, equalsIndex).trim()
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue
+		env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim())
+	}
+	return env
+}
+
+function parseEnvValue(value: string): string {
+	const quote = value[0]
+	if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+		const inner = value.slice(1, -1)
+		return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner
+	}
+	const commentIndex = value.search(/\s#/)
+	return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim()
+}
+
 async function createStore() {
 	if (process.env.DATABASE_URL) {
 		return createPostgresServerStore({
@@ -36,7 +76,10 @@ async function start() {
 		staticDir: './dist',
 		syncPath,
 		httpRoutes: auth ? [{ path: '/auth', handle: auth.handleRequest }] : undefined,
-		syncOptions: auth ? { auth: auth.auth } : undefined,
+		syncOptions: {
+			schemaVersion: schema.version,
+			...(auth ? { auth: auth.auth } : {}),
+		},
 		operationalAuth: {
 			adminToken: process.env.KORA_ADMIN_TOKEN,
 			metricsToken: process.env.KORA_METRICS_TOKEN,

package/templates/svelte-sync/src/main.ts

@@ -20,7 +20,7 @@ const kora = createKoraApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 kora.ready.then(() => kora.sync?.connect())

package/templates/svelte-sync/src/vite-env.d.ts

@@ -2,6 +2,7 @@
 /// <reference types="vite/client" />
 
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 	readonly VITE_AUTH_URL?: string
 }

package/templates/svelte-sync/vite.config.ts

@@ -71,7 +71,7 @@ export default defineConfig({
 	server: {
 		allowedHosts: true,
 		watch: {
-			ignored: ['**/.kora/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
+			ignored: ['**/.kora/**', '**/kora/generated/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
 		},
 		proxy: {
 			'/kora-sync': {

package/templates/svelte-tailwind/README.md.hbs

@@ -47,7 +47,7 @@ To enable real-time sync across devices, update `src/main.tsx`:
 const app = createApp({
   schema,
   sync: {
-    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001',
+    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001/kora-sync',
   },
   // ...
 })

package/templates/svelte-tailwind/src/main.ts

@@ -10,7 +10,7 @@ const kora = createKoraApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 mount(Root, { target: document.getElementById('app')!, props: { kora } })

package/templates/svelte-tailwind-sync/README.md.hbs

@@ -11,7 +11,7 @@ npm run dev
 This starts both the Vite dev server and the Kora sync server.
 
 - **App**: http://localhost:5173
-- **Sync server**: ws://localhost:3001
+- **Sync server**: ws://localhost:3001/kora-sync
 
 ## Project Structure
 
@@ -40,7 +40,7 @@ writes, and `useTodos.ts` is the React binding that exposes todo data and action
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `VITE_SYNC_URL` | `ws://localhost:3001` | WebSocket URL for the sync server |
+| `VITE_SYNC_URL` | `ws://localhost:3001/kora-sync` | WebSocket URL for the sync endpoint |
 | `VITE_AUTH_URL` | current origin | HTTP URL for `/auth/*` routes |
 | `PORT` | `3001` | Sync server port |
 | `KORA_SERVER_DB` | `./.kora/kora-server.db` | SQLite file used by the sync server when `DATABASE_URL` is empty |
@@ -95,7 +95,7 @@ The client and sync server must be deployed separately:
 Set `VITE_SYNC_URL` to your deployed sync server URL when building:
 
 ```bash
-VITE_SYNC_URL=wss://your-server.example.com npm run build
+VITE_SYNC_URL=wss://your-server.example.com/kora-sync npm run build
 ```
 
 ## Learn More

package/templates/svelte-tailwind-sync/server.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import {
 	type CreateKoraAuthServerOptions,
 	createKoraAuthServer,
@@ -12,6 +13,45 @@ import {
 } from '@korajs/server'
 import schema from './src/schema'
 
+loadLocalEnv()
+
+function loadLocalEnv(mode = process.env.NODE_ENV || 'development') {
+	const existingKeys = new Set(Object.keys(process.env))
+	for (const file of ['.env', '.env.local', `.env.${mode}`, `.env.${mode}.local`]) {
+		if (!existsSync(file)) continue
+		for (const [key, value] of Object.entries(parseEnvFile(readFileSync(file, 'utf8')))) {
+			if (!existingKeys.has(key)) {
+				process.env[key] = value
+			}
+		}
+	}
+}
+
+function parseEnvFile(contents: string): Record<string, string> {
+	const env: Record<string, string> = {}
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim()
+		if (!line || line.startsWith('#')) continue
+		const normalized = line.startsWith('export ') ? line.slice('export '.length).trim() : line
+		const equalsIndex = normalized.indexOf('=')
+		if (equalsIndex <= 0) continue
+		const key = normalized.slice(0, equalsIndex).trim()
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue
+		env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim())
+	}
+	return env
+}
+
+function parseEnvValue(value: string): string {
+	const quote = value[0]
+	if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+		const inner = value.slice(1, -1)
+		return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner
+	}
+	const commentIndex = value.search(/\s#/)
+	return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim()
+}
+
 async function createStore() {
 	if (process.env.DATABASE_URL) {
 		return createPostgresServerStore({
@@ -36,7 +76,10 @@ async function start() {
 		staticDir: './dist',
 		syncPath,
 		httpRoutes: auth ? [{ path: '/auth', handle: auth.handleRequest }] : undefined,
-		syncOptions: auth ? { auth: auth.auth } : undefined,
+		syncOptions: {
+			schemaVersion: schema.version,
+			...(auth ? { auth: auth.auth } : {}),
+		},
 		operationalAuth: {
 			adminToken: process.env.KORA_ADMIN_TOKEN,
 			metricsToken: process.env.KORA_METRICS_TOKEN,

package/templates/svelte-tailwind-sync/src/main.ts

@@ -20,7 +20,7 @@ const kora = createKoraApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 kora.ready.then(() => kora.sync?.connect())

package/templates/svelte-tailwind-sync/src/vite-env.d.ts

@@ -2,6 +2,7 @@
 /// <reference types="vite/client" />
 
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 	readonly VITE_AUTH_URL?: string
 }

package/templates/svelte-tailwind-sync/vite.config.ts

@@ -72,7 +72,7 @@ export default defineConfig({
 	server: {
 		allowedHosts: true,
 		watch: {
-			ignored: ['**/.kora/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
+			ignored: ['**/.kora/**', '**/kora/generated/**', '**/*.db', '**/*.db-shm', '**/*.db-wal'],
 		},
 		proxy: {
 			'/kora-sync': {

package/templates/tauri-react/server.ts

@@ -1,3 +1,4 @@
+import { existsSync, readFileSync } from 'node:fs'
 import {
 	type CreateKoraAuthServerOptions,
 	createKoraAuthServer,
@@ -20,6 +21,45 @@ import schema from './src/schema'
 // 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
 
+loadLocalEnv()
+
+function loadLocalEnv(mode = process.env.NODE_ENV || 'development') {
+	const existingKeys = new Set(Object.keys(process.env))
+	for (const file of ['.env', '.env.local', `.env.${mode}`, `.env.${mode}.local`]) {
+		if (!existsSync(file)) continue
+		for (const [key, value] of Object.entries(parseEnvFile(readFileSync(file, 'utf8')))) {
+			if (!existingKeys.has(key)) {
+				process.env[key] = value
+			}
+		}
+	}
+}
+
+function parseEnvFile(contents: string): Record<string, string> {
+	const env: Record<string, string> = {}
+	for (const rawLine of contents.split(/\r?\n/)) {
+		const line = rawLine.trim()
+		if (!line || line.startsWith('#')) continue
+		const normalized = line.startsWith('export ') ? line.slice('export '.length).trim() : line
+		const equalsIndex = normalized.indexOf('=')
+		if (equalsIndex <= 0) continue
+		const key = normalized.slice(0, equalsIndex).trim()
+		if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(key)) continue
+		env[key] = parseEnvValue(normalized.slice(equalsIndex + 1).trim())
+	}
+	return env
+}
+
+function parseEnvValue(value: string): string {
+	const quote = value[0]
+	if ((quote === '"' || quote === "'") && value[value.length - 1] === quote) {
+		const inner = value.slice(1, -1)
+		return quote === '"' ? inner.replace(/\\n/g, '\n').replace(/\\r/g, '\r') : inner
+	}
+	const commentIndex = value.search(/\s#/)
+	return (commentIndex >= 0 ? value.slice(0, commentIndex) : value).trim()
+}
+
 async function createStore() {
 	if (process.env.DATABASE_URL) {
 		return createPostgresServerStore({
@@ -43,7 +83,10 @@ async function start() {
 		port: Number(process.env.PORT) || 3001,
 		syncPath,
 		httpRoutes: auth ? [{ path: '/auth', handle: auth.handleRequest }] : undefined,
-		syncOptions: auth ? { auth: auth.auth } : undefined,
+		syncOptions: {
+			schemaVersion: schema.version,
+			...(auth ? { auth: auth.auth } : {}),
+		},
 		operationalAuth: {
 			adminToken: process.env.KORA_ADMIN_TOKEN,
 			metricsToken: process.env.KORA_METRICS_TOKEN,

package/templates/tauri-react/src/AppShell.tsx

@@ -101,7 +101,7 @@ function ConnectedApp({ syncUrl, onChangeServer, onFactoryReset }: ConnectedAppP
 						},
 					}
 				: {}),
-			devtools: true,
+			devtools: import.meta.env.DEV,
 		}),
 	)
 

package/templates/tauri-react/src/vite-env.d.ts

@@ -1,4 +1,5 @@
 interface ImportMetaEnv {
+	readonly DEV: boolean
 	readonly VITE_SYNC_URL?: string
 }
 

package/templates/vue-basic/README.md.hbs

@@ -47,7 +47,7 @@ To enable real-time sync across devices, update `src/main.tsx`:
 const app = createApp({
   schema,
   sync: {
-    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001',
+    url: import.meta.env.VITE_SYNC_URL || 'ws://localhost:3001/kora-sync',
   },
   // ...
 })

package/templates/vue-basic/src/main.ts

@@ -11,7 +11,7 @@ const kora = createKoraApp({
 	store: {
 		workerUrl: koraWorkerUrl,
 	},
-	devtools: true,
+	devtools: import.meta.env.DEV,
 })
 
 createApp({

package/templates/vue-sync/README.md.hbs

@@ -11,7 +11,7 @@ npm run dev
 This starts both the Vite dev server and the Kora sync server.
 
 - **App**: http://localhost:5173
-- **Sync server**: ws://localhost:3001
+- **Sync server**: ws://localhost:3001/kora-sync
 
 ## Project Structure
 
@@ -40,7 +40,7 @@ writes, and `useTodos.ts` is the React binding that exposes todo data and action
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `VITE_SYNC_URL` | `ws://localhost:3001` | WebSocket URL for the sync server |
+| `VITE_SYNC_URL` | `ws://localhost:3001/kora-sync` | WebSocket URL for the sync endpoint |
 | `VITE_AUTH_URL` | current origin | HTTP URL for `/auth/*` routes |
 | `PORT` | `3001` | Sync server port |
 | `KORA_SERVER_DB` | `./.kora/kora-server.db` | SQLite file used by the sync server when `DATABASE_URL` is empty |
@@ -95,7 +95,7 @@ The client and sync server must be deployed separately:
 Set `VITE_SYNC_URL` to your deployed sync server URL when building:
 
 ```bash
-VITE_SYNC_URL=wss://your-server.example.com npm run build
+VITE_SYNC_URL=wss://your-server.example.com/kora-sync npm run build
 ```
 
 ## Learn More