npm - @voltro/cli - Versions diffs - 0.29.0 → 0.30.0 - Mend

@voltro/cli 0.29.0 → 0.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (169) hide show

package/templates/apps/api-ratelimit/package.json CHANGED Viewed

@@ -13,17 +13,17 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-ratelimit": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-ratelimit": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-rbac/package.json CHANGED Viewed

@@ -13,17 +13,17 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-rbac": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-rbac": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-rest/package.json CHANGED Viewed

@@ -13,16 +13,16 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/plugin-openapi": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
-    "@voltro/sql-postgres": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/plugin-openapi": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/sql-postgres": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-saas/package.json CHANGED Viewed

@@ -13,20 +13,20 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/plugin-analytics-postgres": "0.29.0",
-    "@voltro/plugin-billing": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-notifications": "0.29.0",
-    "@voltro/plugin-presence": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
-    "@voltro/sql-postgres": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/plugin-analytics-postgres": "0.30.0",
+    "@voltro/plugin-billing": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-notifications": "0.30.0",
+    "@voltro/plugin-presence": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/sql-postgres": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-saas-starter/package.json CHANGED Viewed

@@ -13,19 +13,19 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-auth": "0.29.0",
-    "@voltro/plugin-billing": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
-    "@voltro/sql-postgres": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-auth": "0.30.0",
+    "@voltro/plugin-billing": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/sql-postgres": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-search/package.json CHANGED Viewed

@@ -13,17 +13,17 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-search": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-search": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-status/package.json CHANGED Viewed

@@ -13,17 +13,17 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-rbac": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
-    "@voltro/sql-postgres": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-rbac": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/sql-postgres": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-versioning/package.json CHANGED Viewed

@@ -13,17 +13,17 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-versioning": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-versioning": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/api-webhooks/package.json CHANGED Viewed

@@ -13,18 +13,18 @@
   "dependencies": {
     "@effect/platform": "^0.97.0",
     "@effect/rpc": "^0.76.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/database": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/plugin-multitenancy": "0.29.0",
-    "@voltro/plugin-webhooks": "0.29.0",
-    "@voltro/protocol": "0.29.0",
-    "@voltro/runtime": "0.29.0",
-    "@voltro/sql-postgres": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/database": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/plugin-multitenancy": "0.30.0",
+    "@voltro/plugin-webhooks": "0.30.0",
+    "@voltro/protocol": "0.30.0",
+    "@voltro/runtime": "0.30.0",
+    "@voltro/sql-postgres": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {
-    "@voltro/testing": "0.29.0",
+    "@voltro/testing": "0.30.0",
     "typescript": "^6.0.3",
     "vitest": "^4.1.10"
   }

package/templates/apps/changelog/package.json CHANGED Viewed

@@ -12,12 +12,12 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@voltro/changelog": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/changelog": "0.30.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },

package/templates/apps/edge-functions/package.json CHANGED Viewed

@@ -12,8 +12,8 @@
   },
   "dependencies": {
     "@effect/platform": "^0.97.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/serverless": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/serverless": "0.30.0",
     "effect": "^3.22.0"
   },
   "devDependencies": {

package/templates/apps/frontend-admin/app.config.ts CHANGED Viewed

@@ -22,7 +22,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide with no manual setup. The <LocaleSwitcher>
-  // in the layout writes the `voltro:lang` cookie + reloads. Grow the app to
+  // in the layout writes the `voltro:locale` cookie + reloads. Grow the app to
   // more languages by adding a code here + a `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-admin/package.json CHANGED Viewed

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/ui-shadcn": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-admin/src/locales/index.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React,
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React,
 // use `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'

package/templates/apps/frontend-app/app.config.ts CHANGED Viewed

@@ -27,7 +27,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide with no manual setup. The <LocaleSwitcher>
-  // in the layout writes the `voltro:lang` cookie + reloads. Grow the app to
+  // in the layout writes the `voltro:locale` cookie + reloads. Grow the app to
   // more languages by adding a code here + a `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-app/package.json CHANGED Viewed

@@ -12,18 +12,18 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/ui-shadcn": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-app/src/locales/index.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React,
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React,
 // use `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'

package/templates/apps/frontend-app/src/pages/layout.tsx CHANGED Viewed

@@ -4,7 +4,7 @@
 // `theme: 'dark' | 'light' | 'system'` in app.config.ts for the dark class.
 //
 // The app is bilingual (see `locales` in app.config.ts): nav labels come from
-// the catalog via `<T>`, and <LocaleSwitcher> writes the `voltro:lang` cookie
+// the catalog via `<T>`, and <LocaleSwitcher> writes the `voltro:locale` cookie
 // + reloads so the framework re-renders in the chosen language.
 import type { ReactNode } from 'react'

package/templates/apps/frontend-app/src/pages/page.tsx CHANGED Viewed

@@ -20,7 +20,7 @@ import { T, useTFn } from '@voltro/i18n'
 import { getCatalog } from '../locales'
 // Locale-aware tab title: @voltro/web resolves meta({ locale }) from the
-// active locale (the `voltro:lang` cookie in this cookie-i18n app).
+// active locale (the `voltro:locale` cookie in this cookie-i18n app).
 export const meta = ({ locale }: { readonly locale: string }): PageMeta => ({
   title: getCatalog(locale)['meta.notes.title'],
 })

package/templates/apps/frontend-auth/package.json CHANGED Viewed

@@ -12,18 +12,18 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/ui-shadcn": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-auth/src/locales/index.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React use
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React use
 // `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'
 import de from './de'

package/templates/apps/frontend-blank/app.config.ts CHANGED Viewed

@@ -22,7 +22,7 @@ export default {
   // <I18nProvider> from these codes and loads the matching
   // `src/locales/<code>.ts` catalog — so `<T id="…" />` / `useT()` /
   // `useLocale()` work app-wide with no manual setup. The <LocaleSwitcher>
-  // in the layout writes the `voltro:lang` cookie + reloads. Grow the app to
+  // in the layout writes the `voltro:locale` cookie + reloads. Grow the app to
   // more languages by adding a code here + a `src/locales/<code>.ts`.
   locales:       ['en', 'de'] as const,
   defaultLocale: 'en'         as const,

package/templates/apps/frontend-blank/package.json CHANGED Viewed

@@ -12,17 +12,17 @@
     "typecheck": "tsc --noEmit"
   },
   "dependencies": {
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/ui-shadcn": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-blank/src/locales/index.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React,
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React,
 // use `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'

package/templates/apps/frontend-blank/src/pages/layout.tsx CHANGED Viewed

@@ -7,7 +7,7 @@
 // to control the dark class.
 //
 // The app is bilingual (see `locales` in app.config.ts): <LocaleSwitcher>
-// writes the `voltro:lang` cookie + reloads so the framework re-renders in
+// writes the `voltro:locale` cookie + reloads so the framework re-renders in
 // the chosen language.
 import type { ReactNode } from 'react'

package/templates/apps/frontend-blank/src/pages/page.tsx CHANGED Viewed

@@ -10,7 +10,7 @@ import { T } from '@voltro/i18n'
 import { getCatalog } from '../locales'
 // Locale-aware tab title: @voltro/web resolves meta({ locale }) from the
-// active locale (the `voltro:lang` cookie in this cookie-i18n app).
+// active locale (the `voltro:locale` cookie in this cookie-i18n app).
 export const meta = ({ locale }: { readonly locale: string }): PageMeta => ({
   title: getCatalog(locale)['meta.home.title'],
 })

package/templates/apps/frontend-cms/package.json CHANGED Viewed

@@ -12,19 +12,19 @@
     "test": "voltro test"
   },
   "dependencies": {
-    "@{{projectName}}/api": "0.29.0",
-    "@voltro/cli": "0.29.0",
-    "@voltro/client": "0.29.0",
-    "@voltro/cms": "0.29.0",
-    "@voltro/env": "0.29.0",
-    "@voltro/i18n": "0.29.0",
-    "@voltro/ui-shadcn": "0.29.0",
-    "@voltro/web": "0.29.0",
+    "@{{projectName}}/api": "0.30.0",
+    "@voltro/cli": "0.30.0",
+    "@voltro/client": "0.30.0",
+    "@voltro/cms": "0.30.0",
+    "@voltro/env": "0.30.0",
+    "@voltro/i18n": "0.30.0",
+    "@voltro/ui-shadcn": "0.30.0",
+    "@voltro/web": "0.30.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0"
   },
   "devDependencies": {
-    "@voltro/devtools": "0.29.0",
+    "@voltro/devtools": "0.30.0",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "typescript": "^6.0.3",

package/templates/apps/frontend-cms/src/locales/index.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 // Catalog lookup OUTSIDE React — for a page's `meta({ locale })` locale-aware
 // <title>. This app is cookie-i18n (no `/<locale>` URL prefix), so @voltro/web
-// hands `meta` the active locale from the `voltro:lang` cookie. Inside React use
+// hands `meta` the active locale from the `voltro:locale` cookie. Inside React use
 // `<T>` / `useT()` via the framework's auto-wired <I18nProvider> instead.
 import en from './en'
 import de from './de'

package/templates/apps/frontend-collab/README.md ADDED Viewed

@@ -0,0 +1,80 @@
+# {{projectName}} / {{appName}}
+Voltro collaborative-editing frontend (template: **frontend-collab**).
+A document editor whose textarea is bound to a `crdtText()` body over the
+framework's reactive loop. Type in **two browser tabs at once** and the edits
+**converge** — no last-write-wins loser — because the api merges every update
+into the shared document server-side, then broadcasts the merged result back
+live. Zero infra: the merge and the broadcast are in-process on a single
+`voltro dev`.
+## Scaffold the pair
+`frontend-collab` consumes a sibling api — scaffold it **together with
+[`api-collab`](../api-collab)** (which exposes the `documents.list` subscription
++ `documents.create` / `documents.setBody` mutations):
+```bash
+voltro create-project collab --api=api-collab --web=frontend-collab
+cd collab
+pnpm install
+pnpm dev            # boots BOTH apps (api on :4000, web on its portRange port)
+```
+Open the web app, click **Create document**, then open a **second tab** on the
+same URL and type in both. Every keystroke merges — both tabs' edits survive.
+## How it works
+```
+ Tab A                              api (api-collab)
+ ─────                              ────────────────
+ local crdtText() handle           documents.setBody (crdtText 'body' column)
+   │  keystroke → insert/delete       └─ runtime folds the update into the
+   │  → handle.encode()  ──rpc──►        STORED state (mergeCrdtStates) → merged
+   ▼                                        └─► reactive delta ──WS──► every tab
+ useSubscription('app',
+   'documents.list')  ◄──WS── merged body ── handle.merge(body) → textarea
+```
+1. **`useSubscription('app', 'documents.list')`** streams the shared document,
+   including its **merged** `body` (encoded CRDT bytes), on every write.
+2. A **local `crdtText()` handle** (`@voltro/local-first`) is seeded from that
+   body. Each keystroke applies a contiguous insert/delete to the handle and
+   sends `handle.encode()` via **`useMutation('app', 'documents.setBody')`**.
+3. The api's **authoritative server-side merge** folds the update into the
+   stored state before broadcasting — so concurrent edits converge.
+4. Incoming server bodies are **folded back** into the local handle
+   (idempotent), keeping every tab in sync.
+This page is exactly the app-level binding the local-first docs describe as the
+`SyncClient` transport: `push` = the `setBody` mutation, `onRemoteState` = the
+`documents` subscription.
+## Not wired here: presence cursors
+Live "who else is editing" cursors (`usePresence` from
+`@voltro/local-first/react`) need a `PresenceChannel` bound to the app's
+broadcast broker — a runtime binding, not zero-infra in a single dev process
+across tabs — so this template omits them. The CRDT text convergence above needs
+none of that; it rides the reactive engine you already have.
+## Files
+```
+app.config.ts            type:web + the `apis: { app }` wiring
+package.json             depends on @{{projectName}}/api (the sibling) + @voltro/local-first
+src/pages/
+  layout.tsx             root shell (header + <main>)
+  page.tsx               the collaborative editor — subscription + CRDT handle + setBody
+  page.test.tsx          render + edit-dispatch tests (jsdom)
+src/locales/{en,de}.ts   bilingual UI strings
+```
+## Multi-tenancy note
+The dev `AuthMiddleware` resolves the tenant from the `x-tenant` header,
+defaulting to `'acme'` (the `TENANT` constant in `page.tsx`). The `documents`
+table carries the `tenant()` mixin, so reads/writes are auto-scoped. Wire real
+auth before production (see the authentication docs).