fimo 0.14.0 → 0.15.0-staging.2

package/dist/scripts/extract-translations.js

@@ -1,14 +1,14 @@
 /**
- * Extract label keys from React components using oxc-parser.
+ * Extract label keys from application source.
  *
- * Labels are DB-owned. This scanner reports literal `t("key")` call sites so
- * `fimo validate` can verify the tenant DB contains visible values. It never
- * writes label values to local files.
+ * Labels are DB-owned. This scanner reports literal `t("key")` calls and
+ * literal `<Label value="key">` elements so `fimo validate` can verify that
+ * the tenant DB contains visible values. It never writes label values.
  */
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseSync } from 'oxc-parser';
-function findReactFiles(dir, files = []) {
+function findSourceFiles(dir, files = []) {
     if (!existsSync(dir)) {
         return files;
     }
@@ -20,67 +20,127 @@ function findReactFiles(dir, files = []) {
             if (entry === 'ui' || entry === 'node_modules') {
                 continue;
             }
-            findReactFiles(fullPath, files);
+            findSourceFiles(fullPath, files);
         }
-        else if (/\.(ts|tsx|js|jsx)$/.test(entry)) {
+        else if (/\.(ts|tsx|js|jsx|svelte)$/.test(entry)) {
             files.push(fullPath);
         }
     }
     return files;
 }
-function extractFromFile(filePath) {
-    const declarations = [];
-    try {
-        const code = readFileSync(filePath, 'utf-8');
-        const result = parseSync(filePath, code);
-        const ast = result.program;
-        function visit(node) {
-            if (!node || typeof node !== 'object') {
-                return;
+function importedNames(body, source, importedName) {
+    const names = new Set();
+    for (const statement of body) {
+        if (statement.type !== 'ImportDeclaration' || statement.source.value !== source) {
+            continue;
+        }
+        for (const specifier of statement.specifiers) {
+            if (specifier.type === 'ImportSpecifier' &&
+                specifier.imported.type === 'Identifier' &&
+                specifier.imported.name === importedName) {
+                names.add(specifier.local.name);
             }
-            if (node.type === 'CallExpression') {
-                const callee = node.callee;
-                const isTranslationCall = (callee?.type === 'Identifier' && callee.name === 't') ||
-                    (callee?.type === 'MemberExpression' &&
-                        callee.computed === false &&
-                        callee.object?.type === 'Identifier' &&
-                        callee.object.name === 'labels' &&
-                        callee.property?.type === 'Identifier' &&
-                        callee.property.name === 't');
-                if (isTranslationCall) {
-                    const args = node.arguments || [];
-                    const firstArg = args[0];
-                    if (firstArg?.type === 'Literal' && typeof firstArg.value === 'string') {
-                        const key = firstArg.value;
-                        declarations.push({ key, file: filePath });
-                    }
+        }
+    }
+    return names;
+}
+function extractFromModule(filePath, code, parsePath = filePath) {
+    const declarations = [];
+    const result = parseSync(parsePath, code);
+    const ast = result.program;
+    const fimoLabelNames = importedNames(ast.body, 'fimo/ui', 'Label');
+    function visit(node) {
+        if (!node || typeof node !== 'object') {
+            return;
+        }
+        if (node.type === 'CallExpression') {
+            const callee = node.callee;
+            const isTranslationCall = (callee?.type === 'Identifier' && callee.name === 't') ||
+                (callee?.type === 'MemberExpression' &&
+                    callee.computed === false &&
+                    callee.object?.type === 'Identifier' &&
+                    callee.object.name === 'labels' &&
+                    callee.property?.type === 'Identifier' &&
+                    callee.property.name === 't');
+            if (isTranslationCall) {
+                const args = node.arguments || [];
+                const firstArg = args[0];
+                if (firstArg?.type === 'Literal' && typeof firstArg.value === 'string') {
+                    declarations.push({ key: firstArg.value, file: filePath });
                 }
             }
-            for (const key of Object.keys(node)) {
-                const child = node[key];
-                if (Array.isArray(child)) {
-                    for (const item of child) {
-                        visit(item);
-                    }
+        }
+        if (node.type === 'JSXOpeningElement' &&
+            node.name?.type === 'JSXIdentifier' &&
+            fimoLabelNames.has(node.name.name)) {
+            for (const attribute of node.attributes ?? []) {
+                if (attribute?.type === 'JSXAttribute' &&
+                    attribute.name?.type === 'JSXIdentifier' &&
+                    attribute.name.name === 'value' &&
+                    attribute.value?.type === 'Literal' &&
+                    typeof attribute.value.value === 'string') {
+                    declarations.push({ key: attribute.value.value, file: filePath });
                 }
-                else if (typeof child === 'object' && child !== null) {
-                    visit(child);
+            }
+        }
+        for (const key of Object.keys(node)) {
+            const child = node[key];
+            if (Array.isArray(child)) {
+                for (const item of child) {
+                    visit(item);
                 }
             }
+            else if (typeof child === 'object' && child !== null) {
+                visit(child);
+            }
         }
-        visit(ast);
+    }
+    visit(ast);
+    return declarations;
+}
+const SVELTE_SCRIPT = /<script\b[^>]*>([\s\S]*?)<\/script>/gi;
+const SVELTE_COMMENT = /<!--[\s\S]*?-->/g;
+const SVELTE_T_CALL_KEY = /(?:\blabels\.t|(?<![\w$.])t)\(\s*(['"])([^'"]*)\1/g;
+function extractFromSvelte(filePath, code) {
+    const declarations = [];
+    const labelNames = new Set();
+    const markup = code
+        .replace(SVELTE_SCRIPT, (_script, contents) => {
+        const ast = parseSync(`${filePath}.ts`, contents).program;
+        for (const name of importedNames(ast.body, 'fimo/sveltekit/components', 'Label')) {
+            labelNames.add(name);
+        }
+        declarations.push(...extractFromModule(filePath, contents, `${filePath}.ts`));
+        return '';
+    })
+        .replace(SVELTE_COMMENT, '');
+    for (const name of labelNames) {
+        const labelKey = new RegExp(`<${name}\\b[^>]*?\\svalue=(?:"([^"]*)"|'([^']*)')`, 'g');
+        for (const match of markup.matchAll(labelKey)) {
+            declarations.push({ key: (match[1] ?? match[2]), file: filePath });
+        }
+    }
+    for (const match of markup.matchAll(SVELTE_T_CALL_KEY)) {
+        declarations.push({ key: match[2], file: filePath });
+    }
+    return declarations;
+}
+function extractFromFile(filePath) {
+    try {
+        const code = readFileSync(filePath, 'utf-8');
+        return filePath.endsWith('.svelte') ? extractFromSvelte(filePath, code) : extractFromModule(filePath, code);
     }
     catch (error) {
         console.error(`Failed to parse ${filePath}:`, error);
+        return [];
     }
-    return declarations;
 }
 export function extractLabelKeys(options = {}) {
     const cwd = options.cwd ?? process.cwd();
     const srcDir = join(cwd, 'src');
     const declarations = [];
     const seen = new Set();
-    for (const file of findReactFiles(srcDir)) {
+    for (const file of findSourceFiles(srcDir)) {
         for (const declaration of extractFromFile(file)) {
             if (seen.has(declaration.key)) {
                 continue;

package/dist/scripts/sync-forms.js

@@ -44,7 +44,7 @@ export function syncForms(options = {}) {
         }
     };
     const formsDir = resolve(cwd, FORMS_REL);
-    const templatePath = assetPath('content-templates', 'form-template.eta');
+    const templatePath = assetPath('content-templates', 'forms', 'react.eta');
     const templateSource = readFileSync(templatePath, 'utf-8');
     const eta = new Eta({ views: undefined, useWith: true, varName: 'it', autoEscape: false });
     const formFiles = getFormFiles(formsDir);

package/dist/scripts/sync-schemas.js

@@ -5,7 +5,7 @@ import { basename, dirname, join, resolve } from 'node:path';
  * hook files generated from the hooks template.
  *
  * - Scans `<cwd>/src/schemas/*.json`.
- * - Renders shared types plus either the React facade or split Next server/client facades.
+ * - Renders shared types plus the framework's React, Next, Astro, or SvelteKit facade.
  * - Creates/updates `<Pascal>.types.ts` and `<Pascal>.ts`, plus `<Pascal>.client.ts` for Next; deletes orphans.
  */
 import { camelCase, pascalCase } from 'change-case';
@@ -25,6 +25,14 @@ const SCHEMA_DEFINITION_SCHEMA = z.object({
     i18n: z.object({ enabled: z.boolean().optional() }).optional(),
     fields: z.record(z.string(), z.unknown()).optional(),
 });
+const CONTENT_TEMPLATE_PATHS = {
+    types: { current: 'shared/types.eta', legacy: 'types-template.eta' },
+    sharedServer: { current: 'shared/server.eta' },
+    reactClient: { current: 'react/client.eta', legacy: 'hooks-template.eta' },
+    nextServer: { current: 'next/server.eta' },
+    nextClient: { current: 'next/client.eta' },
+    svelteKitContent: { current: 'sveltekit/content.eta' },
+};
 function getSchemaFiles(schemasDir) {
     if (!existsSync(schemasDir)) {
         return [];
@@ -101,58 +109,117 @@ function resolveProjectRuntime(cwd) {
         packageRoot: dirname(packagePath),
         version,
         providesNextRuntime: packageExportsSubpath(packageJson, './next') && packageExportsSubpath(packageJson, './next/client'),
+        providesAstroRuntime: packageExportsSubpath(packageJson, './astro'),
+        providesSvelteKitRuntime: packageExportsSubpath(packageJson, './sveltekit'),
     };
 }
 function contentRuntimeImportFor(framework) {
-    return framework === 'nextjs' ? 'fimo/next' : 'fimo/ui';
+    if (framework === 'nextjs') {
+        return 'fimo/next';
+    }
+    if (framework === 'astro') {
+        return 'fimo/astro';
+    }
+    // @vercel/frameworks reports SvelteKit as `sveltekit-1`, while Fimo's
+    // public runtime profile is `sveltekit`. Both describe the same codegen
+    // target; callers may supply either the detector evidence or the profile.
+    if (framework === 'sveltekit' || framework === 'sveltekit-1') {
+        return 'fimo/sveltekit';
+    }
+    return 'fimo/ui';
 }
-function templatePath(runtime, fileName) {
+function templatePath(runtime, templateName) {
+    const template = CONTENT_TEMPLATE_PATHS[templateName];
     if (runtime && !isVersionAtLeast(runtime.version, MINIMUM_THIN_CONTENT_CLIENT_RUNTIME_VERSION)) {
-        return join(runtime.packageRoot, 'assets', 'content-templates', fileName);
+        const legacyPath = 'legacy' in template ? template.legacy : template.current;
+        return join(runtime.packageRoot, 'assets', 'content-templates', legacyPath);
     }
-    return assetPath('content-templates', fileName);
+    return assetPath('content-templates', template.current);
 }
 function resolveSchemaGenerationTarget(runtimeImport, runtime) {
     if (runtimeImport === 'fimo/ui') {
         return 'react';
     }
-    if (!runtime.providesNextRuntime) {
+    if (runtimeImport === 'fimo/next' && !runtime.providesNextRuntime) {
         throw new Error(`Cannot generate schema clients because project-local fimo@${runtime.version} does not provide the ` +
             'fimo/next and fimo/next/client exports required by this Next.js project. ' +
             `Run \`${CONTENT_CLIENT_RUNTIME_UPGRADE_COMMAND}\` in the project, then run \`npx fimo@latest validate\` again. ` +
             'No generated files were changed.');
     }
-    return 'next';
+    if (runtimeImport === 'fimo/astro' && !runtime.providesAstroRuntime) {
+        throw new Error(`Cannot generate schema clients because project-local fimo@${runtime.version} does not provide the ` +
+            'fimo/astro export required by this Astro project. ' +
+            `Run \`${CONTENT_CLIENT_RUNTIME_UPGRADE_COMMAND}\` in the project, then run \`npx fimo@latest validate\` again. ` +
+            'No generated files were changed.');
+    }
+    if (runtimeImport === 'fimo/sveltekit' && !runtime.providesSvelteKitRuntime) {
+        throw new Error(`Cannot generate schema clients because project-local fimo@${runtime.version} does not provide the ` +
+            'fimo/sveltekit export required by this SvelteKit project. ' +
+            `Run \`${CONTENT_CLIENT_RUNTIME_UPGRADE_COMMAND}\` in the project, then run \`npx fimo@latest validate\` again. ` +
+            'No generated files were changed.');
+    }
+    if (runtimeImport === 'fimo/next') {
+        return 'next';
+    }
+    return runtimeImport === 'fimo/astro' ? 'astro' : 'sveltekit';
 }
 function templatesForTarget(target, runtime, runtimeImport) {
     if (target === 'next') {
         return [
             {
                 suffix: '.types.ts',
-                path: templatePath(runtime, 'types-template.eta'),
+                path: templatePath(runtime, 'types'),
                 runtimeImport: 'fimo/next',
             },
             {
                 suffix: '.ts',
-                path: templatePath(runtime, 'next-server-template.eta'),
+                path: templatePath(runtime, 'nextServer'),
                 runtimeImport: 'fimo/next',
             },
             {
                 suffix: '.client.ts',
-                path: templatePath(runtime, 'next-client-template.eta'),
+                path: templatePath(runtime, 'nextClient'),
                 runtimeImport: 'fimo/next/client',
             },
         ];
     }
+    if (target === 'astro') {
+        return [
+            {
+                suffix: '.types.ts',
+                path: templatePath(runtime, 'types'),
+                runtimeImport: 'fimo/astro',
+            },
+            {
+                suffix: '.ts',
+                path: templatePath(runtime, 'sharedServer'),
+                runtimeImport: 'fimo/astro',
+            },
+        ];
+    }
+    if (target === 'sveltekit') {
+        return [
+            {
+                suffix: '.types.ts',
+                path: templatePath(runtime, 'types'),
+                runtimeImport: 'fimo/sveltekit',
+            },
+            {
+                suffix: '.ts',
+                path: templatePath(runtime, 'svelteKitContent'),
+                runtimeImport: 'fimo/sveltekit',
+            },
+        ];
+    }
     return [
         {
             suffix: '.types.ts',
-            path: templatePath(runtime, 'types-template.eta'),
+            path: templatePath(runtime, 'types'),
             runtimeImport,
         },
         {
             suffix: '.ts',
-            path: templatePath(runtime, 'hooks-template.eta'),
+            path: templatePath(runtime, 'reactClient'),
             runtimeImport,
         },
     ];
@@ -219,7 +286,7 @@ function renderContentRegistry(schemas) {
     const imports = schemas.map(({ pascal }) => `import * as ${pascal} from "./${pascal}";`).join('\n');
     const entries = schemas.map(({ pascal, registryKey }) => `  ${registryKey}: ${pascal},`).join('\n');
     return `${GENERATED_REGISTRY_MARKER}
-// Server code imports this registry and passes it to createFimo({ content, locale }).
+// Generated content registry for framework facades and project integrations.
 
 ${imports}
 
@@ -306,10 +373,10 @@ export function syncSchemas(options) {
     const runtime = schemas.length > 0 || generatedFilesOnDisk.length > 0 ? resolveProjectRuntime(cwd) : null;
     const runtimeImport = contentRuntimeImportFor(options.framework);
     const generationTarget = runtime ? resolveSchemaGenerationTarget(runtimeImport, runtime) : null;
-    const needsNextRegistry = generationTarget === 'next' && schemas.length > 0;
+    const needsContentRegistry = (generationTarget === 'next' || generationTarget === 'sveltekit') && schemas.length > 0;
     const ownsExistingRegistry = existsSync(registryPath) && readFileSync(registryPath, 'utf-8').startsWith(GENERATED_REGISTRY_MARKER);
-    const shouldGenerateRegistry = needsNextRegistry && (!existsSync(registryPath) || ownsExistingRegistry);
-    if (needsNextRegistry && !shouldGenerateRegistry) {
+    const shouldGenerateRegistry = needsContentRegistry && (!existsSync(registryPath) || ownsExistingRegistry);
+    if (needsContentRegistry && !shouldGenerateRegistry) {
         log(`Kept project-owned schema barrel: ${registryPath}`);
     }
     const templates = generationTarget && runtime ? templatesForTarget(generationTarget, runtime, runtimeImport) : [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "0.14.0",
+  "version": "0.15.0-staging.2",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "bin": {
     "fimo": "dist/cli/index.js"
@@ -26,6 +26,22 @@
       "types": "./dist/runtime/content/index.d.ts",
       "import": "./dist/runtime/content/index.js"
     },
+    "./astro": {
+      "types": "./dist/runtime/astro/server.d.ts",
+      "import": "./dist/runtime/astro/server.js"
+    },
+    "./astro/components": {
+      "types": "./assets/astro/components/index.d.ts",
+      "import": "./assets/astro/components/index.js"
+    },
+    "./astro/config": {
+      "types": "./dist/build/astro/config.d.ts",
+      "import": "./dist/build/astro/config.js"
+    },
+    "./astro/internal": {
+      "types": "./dist/runtime/astro/internal.d.ts",
+      "import": "./dist/runtime/astro/internal.js"
+    },
     "./next": {
       "types": "./dist/runtime/next/server.d.ts",
       "import": "./dist/runtime/next/server.js"
@@ -51,6 +67,27 @@
       "types": "./dist/runtime/react-router/preset.d.ts",
       "import": "./dist/runtime/react-router/preset.js"
     },
+    "./sveltekit": {
+      "types": "./dist/runtime/sveltekit/index.d.ts",
+      "import": "./dist/runtime/sveltekit/index.js"
+    },
+    "./sveltekit/components": {
+      "types": "./assets/sveltekit/components/index.d.ts",
+      "svelte": "./assets/sveltekit/components/index.js",
+      "import": "./assets/sveltekit/components/index.js"
+    },
+    "./sveltekit/config": {
+      "types": "./dist/build/sveltekit/config.d.ts",
+      "import": "./dist/build/sveltekit/config.js"
+    },
+    "./sveltekit/internal": {
+      "types": "./dist/runtime/sveltekit/internal.d.ts",
+      "import": "./dist/runtime/sveltekit/internal.js"
+    },
+    "./sveltekit/vite": {
+      "types": "./dist/build/sveltekit/vite.d.ts",
+      "import": "./dist/build/sveltekit/vite.js"
+    },
     "./paths": {
       "types": "./dist/runtime/paths/index.d.ts",
       "import": "./dist/runtime/paths/index.js"
@@ -84,12 +121,18 @@
     "publish:dry-run": "npm publish --dry-run",
     "postinstall": "node scripts/postinstall.mjs",
     "test": "vitest run",
-    "test:integration:next": "vitest run --config vitest.integration.config.ts",
+    "test:integration:astro": "vitest run --config vitest.integration.config.ts test/integration/astro-runtime.test.ts",
+    "test:integration:astro-compat": "vitest run --config vitest.integration.config.ts test/integration/astro-compat.test.ts",
+    "test:integration:frameworks": "vitest run --config vitest.integration.config.ts",
+    "test:integration:next": "vitest run --config vitest.integration.config.ts test/integration/next-runtime.test.ts",
+    "test:integration:sveltekit": "vitest run --config vitest.integration.config.ts test/integration/sveltekit-runtime.test.ts",
     "test:watch": "vitest",
     "clean": "rm -rf dist *.tsbuildinfo"
   },
   "dependencies": {
+    "@astrojs/vercel": "11.0.4",
     "@rollup/pluginutils": "^5.1.0",
+    "@sveltejs/adapter-vercel": "6.3.4",
     "change-case": "^5.4.4",
     "eta": "^3.5.0",
     "oxc-parser": "^0.118.0",
@@ -127,16 +170,25 @@
     "yaml": "2.8.2"
   },
   "peerDependencies": {
+    "@sveltejs/kit": "^2.0.0",
     "@tanstack/react-query": "^5.80.6",
+    "astro": "^5.0.0 || ^6.0.0 || ^7.0.0",
     "react": "^18.2.0 || ^19.0.0",
     "react-dom": "^18.2.0 || ^19.0.0",
     "react-router": "^7.0.0 || ^8.0.0",
+    "svelte": "^5.0.0",
     "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
     "@tanstack/react-query": {
       "optional": true
     },
+    "@sveltejs/kit": {
+      "optional": true
+    },
+    "astro": {
+      "optional": true
+    },
     "react": {
       "optional": true
     },
@@ -146,6 +198,9 @@
     "react-router": {
       "optional": true
     },
+    "svelte": {
+      "optional": true
+    },
     "vite": {
       "optional": true
     }

package/release.json

@@ -1,5 +1,5 @@
 {
   "source": "npm",
-  "apiUrl": "https://api.fimo.ai",
-  "webUrl": "https://fimo.ai"
+  "apiUrl": "https://api.staging.fimo.team",
+  "webUrl": "https://staging.fimo.team"
 }

package/templates/nextjs/AGENTS.md

@@ -4,14 +4,18 @@ This is a Fimo project. Fimo connects content, media, forms, analytics, editing,
 
 ## Load the Fimo skills before doing Fimo work
 
-Load only the skill relevant to the task:
+Before writing schema-driven code, running CLI/deploy workflows, or migrating content, load only the
+skill relevant to the task. During onboarding, preserve the exact CLI invocation prefix from the
+initiating prompt for every operational command; otherwise default to `npx fimo@latest`:
 
 ```bash
-pnpm exec fimo skills get fimo-code   # code and framework APIs from this project runtime
-npx fimo@latest skills get fimo-cli   # operational workflows: push, deploy, labels, domains
+pnpm exec fimo skills get fimo-code   # match the lockfile; code + framework APIs come from this project runtime
+npx fimo@latest skills get fimo-cli   # default prefix; keep the onboarding prefix when one was supplied
 ```
 
-Use the command that matches the project lockfile. Add `--ref <doc>` for one reference at a time. For Next.js code, start with `fimo-code --ref frameworks/next`, then load the App Router, Pages Router, or locale reference only when needed.
+Use `npm exec fimo`, `yarn fimo`, or `bunx --no-install fimo` instead of `pnpm exec fimo` when that
+matches the project lockfile. Add `--ref <doc>` for one reference at a time. Do not load `fimo-cli` for
+a code-only task, or use `npx fimo@latest` for project-local code generation and validation.
 
 ## Never hardcode editable values
 
@@ -26,10 +30,11 @@ The scaffolded homepage is disposable. Replace it on the first real generation.
 
 1. Start the application with the project package manager (`pnpm dev`, `npm run dev`, `yarn dev`, or `bun dev`).
 2. Build and verify against the local server.
-3. Offer `fimo deploy` for a hosted preview or `fimo deploy --publish` to go live. Deploy only after the developer confirms.
+3. When a unit of work is done, **offer** to deploy: `fimo deploy` for a hosted preview / shareable link, or `fimo deploy --publish` to go live. Deploy on the developer's request or confirmation. The one exception: new-project onboarding creates a single first hosted preview automatically unless the developer said not to deploy. Never publish without an explicit request.
 
 ## Project rules
 
+- **Deploy is on-demand**, not a save step. Batch related edits into one deploy.
 - The application owns routes, locale resolution, links, HTML language/direction, and SEO. Fimo connects to those decisions.
 - Do not add a second deployment platform.
 - Never edit `.fimo/project.json`; it links this directory to the remote project.

package/templates/nextjs/_gitignore

@@ -7,6 +7,7 @@ node_modules/
 # Build outputs
 .next/
 out/
+.vercel/
 next-env.d.ts
 *.tsbuildinfo
 

package/templates/react-router/AGENTS.md

@@ -9,11 +9,12 @@ When asked to create or manage an agent in this project, use Fimo's agent workfl
 ## Load the Fimo skills before doing Fimo work
 
 Before writing schema-driven code, running CLI/deploy workflows, or migrating content, load only the
-skill relevant to the task:
+skill relevant to the task. During onboarding, preserve the exact CLI invocation prefix from the
+initiating prompt for every operational command; otherwise default to `npx fimo@latest`:
 
 ```bash
 pnpm exec fimo skills get fimo-code   # match the lockfile; code + framework APIs come from this project runtime
-npx fimo@latest skills get fimo-cli   # operational workflows: push, deploy, labels, domains
+npx fimo@latest skills get fimo-cli   # default prefix; keep the onboarding prefix when one was supplied
 ```
 
 Use `npm exec fimo`, `yarn fimo`, or `bunx --no-install fimo` instead of `pnpm exec fimo` when that
@@ -34,7 +35,7 @@ breaks that. Load `fimo-code` for the exact primitives, but the rule is:
 
 1. Start the dev server with the project's package manager (`pnpm dev`, `npm run dev`, …) — live reload on localhost.
 2. Make edits; the running server shows them instantly. No deploy needed to see local changes.
-3. When a unit of work is done, **offer** to deploy: `fimo deploy` for a hosted preview / shareable link, or `fimo deploy --publish` to go live. Only after the developer confirms — never deploy on your own.
+3. When a unit of work is done, **offer** to deploy: `fimo deploy` for a hosted preview / shareable link, or `fimo deploy --publish` to go live. Deploy on the developer's request or confirmation. The one exception: new-project onboarding creates a single first hosted preview automatically unless the developer said not to deploy. Never publish without an explicit request.
 
 ## Project rules
 

package/templates/react-router/package.json

@@ -21,7 +21,7 @@
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "0.14.0",
+    "fimo": "0.15.0-staging.2",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/.fimo/config.json

@@ -0,0 +1,15 @@
+{
+  "runtime": { "framework": "sveltekit" },
+  "i18n": {
+    "defaultLocale": "en",
+    "locales": ["en"]
+  },
+  "routes": {
+    "home": {
+      "label": "Home",
+      "path": "/"
+    }
+  },
+  "version": "4",
+  "source": "cli"
+}

package/templates/sveltekit/AGENTS.md

@@ -0,0 +1,36 @@
+# Fimo project
+
+This SvelteKit application is connected to Fimo for content, editing, environments, and hosting.
+
+## Load the Fimo skills before doing Fimo work
+
+Before writing schema-driven code, running CLI/deploy workflows, or migrating content, load only the
+skill relevant to the task. During onboarding, preserve the exact CLI invocation prefix from the
+initiating prompt for every operational command; otherwise default to `npx fimo@latest`:
+
+```bash
+pnpm exec fimo skills get fimo-code
+pnpm exec fimo skills get fimo-code --ref frameworks/sveltekit
+npx fimo@latest skills get fimo-cli
+```
+
+Use `npm exec fimo`, `yarn fimo`, or `bunx --no-install fimo` instead of `pnpm exec fimo` when that
+matches the project lockfile. Add `--ref <doc>` for one reference at a time. Do not load `fimo-cli` for
+a code-only task, or use `npx fimo@latest` for project-local code generation and validation.
+
+## Development loop
+
+1. Start the application with the project package manager (`pnpm dev`, `npm run dev`, `yarn dev`, or `bun dev`).
+2. Build and verify against the local server.
+3. When a unit of work is done, **offer** to deploy: `fimo deploy` for a hosted preview / shareable link, or `fimo deploy --publish` to go live. Deploy on the developer's request or confirmation. The one exception: new-project onboarding creates a single first hosted preview automatically unless the developer said not to deploy. Never publish without an explicit request.
+
+## Project rules
+
+- **Deploy is on-demand**, not a save step. Batch related edits into one deploy.
+- The application owns routes, locale resolution, links, HTML language/direction, and SEO. Fimo connects to those decisions.
+- Do not add a second deployment platform.
+- Never edit `.fimo/project.json`; it links this directory to the remote project.
+- Keep secrets in the Fimo dashboard, not committed environment files.
+- Pass flags to interactive Fimo commands when scripting them.
+
+The scaffolded homepage is disposable. Replace it when building the requested site.

package/templates/sveltekit/CLAUDE.md

@@ -0,0 +1,5 @@
+# Fimo project
+
+Instructions for this project live in `AGENTS.md`. Read it:
+
+@AGENTS.md

package/templates/sveltekit/_gitignore

@@ -0,0 +1,16 @@
+# System files
+.DS_Store
+
+# Dependencies
+node_modules/
+
+# Build outputs
+.svelte-kit/
+.vercel/
+build/
+*.tsbuildinfo
+
+# Env
+.env
+.env.*
+!.env.example