fimo 0.9.0-experimental.1 → 0.9.0

package/dist/runtime/app/FimoProviders.d.ts

@@ -1,5 +1,15 @@
 import React from 'react';
-export type { DisplayRoute, ParamInfo } from '../shared/display-routes.js';
+export interface ParamInfo {
+    schema: string;
+    queryField: string;
+    displayField: string;
+}
+export interface DisplayRoute {
+    id: string;
+    name: string;
+    path: string;
+    params?: Record<string, ParamInfo>;
+}
 export interface FimoProvidersProps {
     children?: React.ReactNode;
     locale?: string;

package/dist/runtime/app/FimoProviders.js

@@ -11,10 +11,31 @@ import { ViteLifecycles } from '../core/ViteLifecycles.js';
 import { FimoLocaleProvider } from '../i18n/FimoLocaleContext.js';
 import { getFimoTextDirection, resolveFimoLocale, toHtmlLang } from '../i18n/locale.js';
 import { ScreenshotProvider } from '../iframe/ScreenshotProvider.js';
-import { getDisplayRoutes as getDisplayRoutesFromConfig } from '../shared/display-routes.js';
 import { OptionalTracking } from '../t/OptionalTracking.js';
+const titleCase = (seg) => seg
+    .replace(/[_\-]+/g, ' ')
+    .replace(/([a-z])([A-Z])/g, '$1 $2')
+    .split(/\s+/)
+    .filter(Boolean)
+    .map((w) => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase())
+    .join(' ');
+const generateRouteName = (path) => {
+    if (path === '/') {
+        return 'Home';
+    }
+    const firstSegment = path.replace(/^\//, '').split('/')[0];
+    return titleCase(firstSegment);
+};
 function getDisplayRoutes() {
-    return getDisplayRoutesFromConfig(fimoConfig);
+    const configRoutes = fimoConfig.routes ?? {};
+    return Object.entries(configRoutes)
+        .filter(([, route]) => route.path)
+        .map(([id, route]) => ({
+        id,
+        path: route.path,
+        name: route.name || generateRouteName(route.path),
+        params: route.params,
+    }));
 }
 function PreviewBridge() {
     const navigate = useNavigate();

package/dist/runtime/content/client/createContentClient.js

@@ -100,10 +100,11 @@ export function createContentClient(config) {
         return (await list(params)).items;
     }
     async function create(payload) {
+        const localizedPayload = info.localized ? withMutationLocale(payload, readCollectionLocale({})) : payload;
         const res = await fetch(`${apiBase()}/entries/${info.uid}`, {
             method: 'POST',
             headers: fimoHeaders({ 'Content-Type': 'application/json' }),
-            body: JSON.stringify(splitWritePayload(payload)),
+            body: JSON.stringify(splitWritePayload(localizedPayload)),
         });
         if (!res.ok) {
             throw new Error(await res.text());

package/dist/runtime/i18n/FimoLocaleContext.js

@@ -1,4 +1,3 @@
-'use client';
 import { jsx as _jsx } from "react/jsx-runtime";
 import { createContext, useContext } from 'react';
 const fallbackLocale = {

package/dist/runtime/primitives/lib/useFimoLiveValue.d.ts

@@ -9,11 +9,9 @@ import { type RefObject } from 'react';
  * preview knows to dispatch events instead of falling back to raw DOM writes,
  * and updates internal state when a mutation arrives.
  *
- * In prod (published app): only `useFimoLiveValueProd` is linked. The dev
- * check must work under any bundler (Vite, webpack, Turbopack) and plain
- * Node SSR: `import.meta.env.DEV` only exists under Vite, and
- * `process.env.NODE_ENV` is statically replaced by Next/webpack — checking
- * both keeps the hook correct across adapters.
+ * In prod (published app): Vite statically inlines `import.meta.env.DEV`, so
+ * `useFimoLiveValueProd` is the only implementation linked and the listener
+ * machinery is dead-code-eliminated.
  */
 declare function useFimoLiveValueDev<T, E extends HTMLElement = HTMLElement>(external: T): {
     value: T;

package/dist/runtime/primitives/lib/useFimoLiveValue.js

@@ -10,11 +10,9 @@ import { useEffect, useRef, useState } from 'react';
  * preview knows to dispatch events instead of falling back to raw DOM writes,
  * and updates internal state when a mutation arrives.
  *
- * In prod (published app): only `useFimoLiveValueProd` is linked. The dev
- * check must work under any bundler (Vite, webpack, Turbopack) and plain
- * Node SSR: `import.meta.env.DEV` only exists under Vite, and
- * `process.env.NODE_ENV` is statically replaced by Next/webpack — checking
- * both keeps the hook correct across adapters.
+ * In prod (published app): Vite statically inlines `import.meta.env.DEV`, so
+ * `useFimoLiveValueProd` is the only implementation linked and the listener
+ * machinery is dead-code-eliminated.
  */
 function useFimoLiveValueDev(external) {
     const ref = useRef(null);
@@ -48,9 +46,4 @@ function useFimoLiveValueProd(external) {
     const ref = useRef(null);
     return { value: external, ref };
 }
-// globalThis lookup, not a bare `process` reference: this file is part of the
-// browser-facing runtime surface, which must typecheck without node types
-// (the generated-types gate enforces it).
-const isDevRuntime = import.meta.env?.DEV === true ||
-    globalThis.process?.env?.NODE_ENV === 'development';
-export const useFimoLiveValue = (isDevRuntime ? useFimoLiveValueDev : useFimoLiveValueProd);
+export const useFimoLiveValue = (import.meta.env.DEV ? useFimoLiveValueDev : useFimoLiveValueProd);

package/dist/runtime/primitives/translations.d.ts

@@ -1,2 +1,28 @@
-export { useLabels, useTranslations } from './labels-hook.js';
+import { FimoString } from './lib/index.js';
+/**
+ * Hook to provide a label function (`t`).
+ *
+ * Returns FimoString with source tracking for inline editing.
+ * Use with <Text> component for rendering, or String() for escape hatch.
+ *
+ * @example
+ * const { t } = useLabels();
+ *
+ * // With Text component (recommended)
+ * <Text value={t('welcome')} />
+ *
+ * // Escape hatch for attributes
+ * <input placeholder={String(t('email.placeholder'))} />
+ */
+export declare function useLabels(): {
+    t: (fullKey: string) => FimoString;
+    locale: string;
+};
+/**
+ * Legacy alias for older projects. Prefer useLabels() in new code.
+ */
+export declare function useTranslations(): {
+    t: (fullKey: string) => FimoString;
+    locale: string;
+};
 //# sourceMappingURL=translations.d.ts.map

package/dist/runtime/primitives/translations.js

@@ -1,14 +1,61 @@
-// Vite flavor of the label layer: hydrates the framework-neutral store from
-// the `virtual:translations` module (fimo/vite labels plugin) and wires HMR.
-// Framework-agnostic consumers use ./labels-store.ts + ./labels-hook.ts.
+import { useSyncExternalStore } from 'react';
 import { defaultLocale as bundledDefaultLocale, dictionaries as bundledDictionaries, signature as translationSignature, updatedAt as bundledUpdatedAt, } from 'virtual:translations';
-import { applyLabelUpdate, hydrateLabels } from './labels-store.js';
-hydrateLabels({
+import { useLocale } from '../i18n/FimoLocaleContext.js';
+import { FimoString } from './lib/index.js';
+const labelListeners = new Set();
+let labelState = {
     dictionaries: bundledDictionaries ?? {},
     defaultLocale: bundledDefaultLocale || 'en',
     signature: translationSignature,
     updatedAt: bundledUpdatedAt ?? null,
-});
+};
+function subscribeLabels(listener) {
+    labelListeners.add(listener);
+    return () => {
+        labelListeners.delete(listener);
+    };
+}
+function getLabelSnapshot() {
+    return labelState;
+}
+function setLabelState(next) {
+    if (next.signature === labelState.signature) {
+        return;
+    }
+    labelState = next;
+    for (const listener of labelListeners) {
+        listener();
+    }
+}
+function isRecord(value) {
+    return Boolean(value) && typeof value === 'object' && !Array.isArray(value);
+}
+function normalizeDictionaries(value) {
+    if (!isRecord(value)) {
+        return null;
+    }
+    const dictionaries = {};
+    for (const [locale, labels] of Object.entries(value)) {
+        if (!isRecord(labels)) {
+            continue;
+        }
+        dictionaries[locale] = Object.fromEntries(Object.entries(labels).filter((entry) => typeof entry[1] === 'string'));
+    }
+    return dictionaries;
+}
+function applyLabelUpdate(payload) {
+    if (!isRecord(payload)) {
+        return;
+    }
+    const dictionaries = normalizeDictionaries(payload.dictionaries);
+    if (!dictionaries) {
+        return;
+    }
+    const defaultLocale = typeof payload.defaultLocale === 'string' ? payload.defaultLocale : labelState.defaultLocale;
+    const signature = typeof payload.signature === 'string' ? payload.signature : JSON.stringify({ dictionaries, defaultLocale });
+    const updatedAt = typeof payload.updatedAt === 'string' ? payload.updatedAt : null;
+    setLabelState({ dictionaries, defaultLocale, signature, updatedAt });
+}
 // @ts-ignore - import.meta.hot is provided by Vite during development.
 if (import.meta.hot) {
     const onLabelsUpdated = (payload) => {
@@ -22,4 +69,35 @@ if (import.meta.hot) {
         import.meta.hot.off('fimo:labels-updated', onLabelsUpdated);
     });
 }
-export { useLabels, useTranslations } from './labels-hook.js';
+/**
+ * Hook to provide a label function (`t`).
+ *
+ * Returns FimoString with source tracking for inline editing.
+ * Use with <Text> component for rendering, or String() for escape hatch.
+ *
+ * @example
+ * const { t } = useLabels();
+ *
+ * // With Text component (recommended)
+ * <Text value={t('welcome')} />
+ *
+ * // Escape hatch for attributes
+ * <input placeholder={String(t('email.placeholder'))} />
+ */
+export function useLabels() {
+    const localeContext = useLocale();
+    const labels = useSyncExternalStore(subscribeLabels, getLabelSnapshot, getLabelSnapshot);
+    const t = (fullKey) => {
+        const locale = localeContext.locale || labels.defaultLocale || 'en';
+        const dictionary = labels.dictionaries[locale] ?? labels.dictionaries[labels.defaultLocale] ?? {};
+        const text = dictionary[fullKey] ?? '';
+        return new FimoString(text, `__labels.${locale}.${fullKey}.value`);
+    };
+    return { t, locale: localeContext.locale };
+}
+/**
+ * Legacy alias for older projects. Prefer useLabels() in new code.
+ */
+export function useTranslations() {
+    return useLabels();
+}

package/dist/runtime/shared/fimo-config.server.js

@@ -20,7 +20,6 @@ export function getConfigServer(rootDir) {
             i18n: raw.i18n,
             routes: raw.routes,
             version: raw.version,
-            framework: raw.framework,
         };
     }
     catch {

package/dist/runtime/shared/fimo-config.types.d.ts

@@ -57,7 +57,5 @@ export interface FimoConfig {
     i18n?: FimoI18nConfig;
     routes?: Record<string, FimoRouteConfig>;
     version?: string | number;
-    /** The project's framework. Absent means the Fimo template (react-router). */
-    framework?: 'react-router' | 'next' | string;
 }
 //# sourceMappingURL=fimo-config.types.d.ts.map

package/dist/scripts/extract-translations.js

@@ -8,7 +8,6 @@
 import { existsSync, readFileSync, readdirSync, statSync } from 'node:fs';
 import { join } from 'node:path';
 import { parseSync } from 'oxc-parser';
-import { collectScopedBindings, isFunctionLike, resolveScopedKey } from './i18n-namespace.js';
 function findReactFiles(dir, files = []) {
     if (!existsSync(dir)) {
         return files;
@@ -35,21 +34,17 @@ function extractFromFile(filePath) {
         const code = readFileSync(filePath, 'utf-8');
         const result = parseSync(filePath, code);
         const ast = result.program;
-        function visit(node, scopes) {
+        function visit(node) {
             if (!node || typeof node !== 'object') {
                 return;
             }
-            // A function introduces a new scope layer with its `useTranslations`
-            // bindings; nested calls resolve innermost-first.
-            const childScopes = isFunctionLike(node) ? [...scopes, collectScopedBindings(node)] : scopes;
-            if (node.type === 'CallExpression' && node.callee?.type === 'Identifier') {
-                const name = node.callee.name;
-                const firstArg = (node.arguments ?? [])[0];
-                if (firstArg?.type === 'Literal' && typeof firstArg.value === 'string') {
-                    const { key, scoped, unresolvable } = resolveScopedKey(name, firstArg.value, childScopes);
-                    // A namespace-scoped var (any name) OR a bare Fimo `t(...)`. A passed-in
-                    // param `t` is unresolvable (the caller owns the namespace) — skip it.
-                    if (!unresolvable && (scoped || name === 't')) {
+            if (node.type === 'CallExpression') {
+                const callee = node.callee;
+                if (callee?.type === 'Identifier' && callee?.name === 't') {
+                    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 });
                     }
                 }
@@ -58,15 +53,15 @@ function extractFromFile(filePath) {
                 const child = node[key];
                 if (Array.isArray(child)) {
                     for (const item of child) {
-                        visit(item, childScopes);
+                        visit(item);
                     }
                 }
                 else if (typeof child === 'object' && child !== null) {
-                    visit(child, childScopes);
+                    visit(child);
                 }
             }
         }
-        visit(ast, []);
+        visit(ast);
     }
     catch (error) {
         console.error(`Failed to parse ${filePath}:`, error);

package/dist/scripts/lib/validation-report.d.ts

@@ -23,7 +23,6 @@ export interface PhaseResult {
     skipped?: {
         reason: string;
     };
-    warnings?: string[];
 }
 export interface ValidationReport {
     ok: boolean;

package/dist/scripts/lib/validation-report.js

@@ -76,9 +76,6 @@ function formatPhaseHuman(phase) {
             out.push(`    ${parts.join(', ')}`);
         }
     }
-    for (const warning of phase.warnings ?? []) {
-        out.push(`    ⚠ ${warning}`);
-    }
     for (const err of phase.errors) {
         const loc = err.file ? ` (${err.file}${err.line ? `:${err.line}` : ''}${err.column ? `:${err.column}` : ''})` : '';
         out.push(`    [${err.kind}] ${err.rule}: ${err.message}${loc}`);

package/dist/scripts/validate-route-metadata.js

@@ -31,17 +31,6 @@ export function validateRouteMetadata(options = {}) {
     const srcDir = path.resolve(cwd, 'src');
     const routesFilePath = path.resolve(srcDir, 'routes.ts');
     const errors = [];
-    // Everything below the i18n checks cross-validates React Router's
-    // src/routes.ts. Adopted (wrapped) projects on another framework declare it
-    // in fimo-config.json — their routes come from framework scans, so only the
-    // framework-neutral config checks apply.
-    const earlyConfig = readJson(configFilePath);
-    const framework = typeof earlyConfig.framework === 'string' ? earlyConfig.framework : 'react-router';
-    if (framework !== 'react-router') {
-        const i18n = validateI18nConfig(earlyConfig);
-        const configRoutes = loadConfigRoutes(earlyConfig);
-        return { errors: i18n.errors, routesChecked: configRoutes.length };
-    }
     // Parse routes from src/routes.ts (file → path mapping)
     let fileRoutes = [];
     if (!fs.existsSync(routesFilePath)) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "0.9.0-experimental.1",
+  "version": "0.9.0",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "bin": {
     "fimo": "dist/cli/index.js"
@@ -22,18 +22,6 @@
       "types": "./dist/runtime/index.d.ts",
       "import": "./dist/runtime/index.js"
     },
-    "./react": {
-      "types": "./dist/runtime/react/index.d.ts",
-      "import": "./dist/runtime/react/index.js"
-    },
-    "./next": {
-      "types": "./dist/runtime/next/index.d.ts",
-      "import": "./dist/runtime/next/index.js"
-    },
-    "./next/server": {
-      "types": "./dist/runtime/next/server.d.ts",
-      "import": "./dist/runtime/next/server.js"
-    },
     "./react-router": {
       "types": "./dist/runtime/react-router/index.d.ts",
       "import": "./dist/runtime/react-router/index.js"
@@ -53,50 +41,6 @@
     "./templates": {
       "types": "./dist/runtime/templates.d.ts",
       "import": "./dist/runtime/templates.js"
-    },
-    "./strapi": {
-      "types": "./dist/runtime/strapi/index.d.ts",
-      "import": "./dist/runtime/strapi/index.js"
-    },
-    "./remix": {
-      "types": "./dist/runtime/remix/index.d.ts",
-      "import": "./dist/runtime/remix/index.js"
-    },
-    "./remix/server": {
-      "types": "./dist/runtime/remix/server.d.ts",
-      "import": "./dist/runtime/remix/server.js"
-    },
-    "./astro": {
-      "types": "./dist/runtime/astro/index.d.ts",
-      "import": "./dist/runtime/astro/index.js"
-    },
-    "./astro/server": {
-      "types": "./dist/runtime/astro/server.d.ts",
-      "import": "./dist/runtime/astro/server.js"
-    },
-    "./nuxt": {
-      "types": "./dist/runtime/nuxt/index.d.ts",
-      "import": "./dist/runtime/nuxt/index.js"
-    },
-    "./nuxt/server": {
-      "types": "./dist/runtime/nuxt/server.d.ts",
-      "import": "./dist/runtime/nuxt/server.js"
-    },
-    "./svelte": {
-      "types": "./dist/runtime/svelte/index.d.ts",
-      "import": "./dist/runtime/svelte/index.js"
-    },
-    "./svelte/server": {
-      "types": "./dist/runtime/svelte/server.d.ts",
-      "import": "./dist/runtime/svelte/server.js"
-    },
-    "./vue": {
-      "types": "./dist/runtime/vue/index.d.ts",
-      "import": "./dist/runtime/vue/index.js"
-    },
-    "./vue/server": {
-      "types": "./dist/runtime/vue/server.d.ts",
-      "import": "./dist/runtime/vue/server.js"
     }
   },
   "publishConfig": {
@@ -153,37 +97,16 @@
     "yaml": "2.8.2"
   },
   "peerDependencies": {
-    "@remix-run/react": ">=2.0.0",
-    "@sveltejs/kit": ">=2.0.0",
     "@tanstack/react-query": "^5.80.6",
-    "astro": ">=4.0.0",
-    "next": ">=14.0.0",
-    "nuxt": ">=3.0.0",
-    "react": "^18.2.0 || ^19.0.0",
-    "react-dom": "^18.2.0 || ^19.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
     "react-router": "^7.0.0 || ^8.0.0",
-    "vite": "^7.0.0 || ^8.0.0",
-    "vue": ">=3.0.0"
+    "vite": "^7.0.0 || ^8.0.0"
   },
   "peerDependenciesMeta": {
-    "@remix-run/react": {
-      "optional": true
-    },
-    "@sveltejs/kit": {
-      "optional": true
-    },
     "@tanstack/react-query": {
       "optional": true
     },
-    "astro": {
-      "optional": true
-    },
-    "next": {
-      "optional": true
-    },
-    "nuxt": {
-      "optional": true
-    },
     "react": {
       "optional": true
     },
@@ -195,9 +118,6 @@
     },
     "vite": {
       "optional": true
-    },
-    "vue": {
-      "optional": true
     }
   },
   "engines": {

package/release.json

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

package/scripts/postinstall.mjs

@@ -1,39 +1,17 @@
 #!/usr/bin/env node
-// Two paths:
+// GLOBAL install (`npm i -g fimo`, `pnpm add -g fimo`, etc.)
+//   → print a short, non-blocking hint. We steer users toward `npx fimo@latest`
+//     (always current) and `fimo init`, and don't run any interactive prompt
+//     from a package lifecycle script.
 //
-//  1) GLOBAL install (`npm i -g fimo`, `pnpm add -g fimo`, etc.)
-//     → print a short, non-blocking hint. We steer users toward
-//       `npx fimo@latest` (always current) and `fimo init`, and don't run any
-//       interactive prompt from a package lifecycle script.
-//
-//  2) LOCAL / project install (`pnpm install` in a project that has `fimo`
-//     in its dependencies)
-//     → if the install was inside a Fimo project (`.fimo.settings.json`
-//       found by walking up from `INIT_CWD`), re-sync the project-scope
-//       `fimo` skill into every per-agent dir the project is set up for.
-//       The skill source is `node_modules/fimo/assets/skills/fimo/`, version-
-//       locked to the installed package.
-//
-//       Silent on no-op; non-fatal on any failure (a skill copy must
-//       never break the user's install).
-//
-// pnpm caveat: by default, pnpm strips build scripts from non-approved deps.
-// Fimo-controlled installs (`fimo init --install`, sandbox `fimopm install`,
-// and E2E helper installs) pass a scoped allow-all-builds flag for pnpm so the
-// fimo postinstall hook can refresh project skills. The template intentionally
-// does not persist allowlists in package.json / pnpm-workspace.yaml because
-// those conflict with sandbox install flags and drift when deps change. npm /
-// yarn run lifecycle scripts by default and need no extra config.
-
-import fs from 'node:fs';
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
+// LOCAL / project install (`pnpm install` in a project that depends on `fimo`)
+//   → nothing to do. Fimo no longer writes skills into projects: the only skill
+//     is a tiny global `fimo` bootstrap installed by `fimo skills install`, and
+//     the rich skills are fetched on demand via `fimo skills get`. Keeping this
+//     path a no-op means `pnpm install` never touches the working tree.
 
 import { isGlobalInstall } from './lib/postinstall-onboarding.mjs';
 
-const THIS_FILE = fileURLToPath(import.meta.url);
-const CLI_ROOT = path.resolve(path.dirname(THIS_FILE), '..');
-
 const ESC = String.fromCharCode(27);
 const green = (s) => `${ESC}[32m${s}${ESC}[0m`;
 const bold = (s) => `${ESC}[1m${s}${ESC}[0m`;
@@ -49,40 +27,8 @@ if (isGlobalInstall(process.env)) {
   console.log();
   console.log(`  Get started:`);
   console.log(`       ${cyan('fimo init')}            ${dim('# sign in, create or link a project')}`);
-  console.log(`       ${cyan('fimo skills install')}  ${dim('# set up skills for your AI coding tools')}`);
+  console.log(`       ${cyan('fimo skills install')}  ${dim('# set up Fimo skills for your AI coding tools')}`);
   console.log();
-  process.exit(0);
 }
 
-// Project-install path: dynamic-import the built helper and re-sync the
-// project-scope `fimo` skill if we resolve to a Fimo project root.
-// Skipped silently when:
-//   - The CLI hasn't been built yet (workspace dev install before `pnpm build`)
-//   - `INIT_CWD` isn't inside a Fimo project (helper returns 'not-a-fimo-project')
-//   - The project has no per-agent rule files yet (helper returns 'no-agents')
-const helperPath = path.join(CLI_ROOT, 'dist', 'cli', 'project-skill.js');
-if (!fs.existsSync(helperPath)) {
-  process.exit(0);
-}
-
-try {
-  const { syncProjectFimoSkill } = await import(helperPath);
-  const initCwd = process.env.INIT_CWD ?? process.cwd();
-  const result = await syncProjectFimoSkill({ cwd: initCwd });
-
-  if (result.status === 'installed' && !result.skillSourceMissing) {
-    const skillDest =
-      result.agents.length === 1 ? result.agents[0] : `${result.agents.length} agents (${result.agents.join(', ')})`;
-    console.log(`${green('✓')} fimo skill synced for ${skillDest}`);
-    for (const failure of result.failures) {
-      console.error(`  ! fimo skill failed for ${failure.agent}: ${failure.error}`);
-    }
-  }
-  // Other statuses (not-a-fimo-project, no-agents, skill-source-missing)
-  // are silent — they're expected for non-Fimo deps and pre-create installs.
-} catch (err) {
-  // Never break the user's install over a skill-sync failure.
-  if (process.env.FIMO_DEBUG_POSTINSTALL === '1') {
-    console.error('[fimo postinstall] sync failed:', err);
-  }
-}
+process.exit(0);

package/templates/react-router/AGENTS.md

@@ -0,0 +1,44 @@
+# Fimo project
+
+This is a Fimo project — a content + media + forms + analytics platform for React websites with a CMS
+dashboard. Fimo owns everything after the build: content, editing, environments, and hosting stay
+editable by the whole team.
+
+## Load the Fimo skills before doing Fimo work
+
+Fimo ships its skills through its CLI so they always match this project's installed version. Before
+writing schema-driven code, running CLI/deploy workflows, or migrating content, load the relevant skill:
+
+```bash
+npx fimo@latest skills list          # what's available
+npx fimo@latest skills get fimo-code  # writing code: schemas, forms, labels, fimo/ui
+npx fimo@latest skills get fimo-cli   # CLI + workflows: push, deploy, sync, labels, domains
+```
+
+Add `--ref <doc>` for a skill's reference docs. Always fetch fresh from the CLI rather than trusting a
+cached copy.
+
+## Critical: never hardcode user-facing things
+
+Fimo's whole point is that editors change content in the dashboard, not in code. Anything hardcoded
+breaks that. Load `fimo-code` for the exact primitives, but the rule is:
+
+- **Content** → declare a schema, render with the generated `useList()` / `useGet()` hooks + `fimo/ui`. Never `const posts = [...]` in JSX.
+- **Strings** → `t('key')` + `fimo labels set`. Never `<h1>Welcome</h1>`.
+- **Media** → `<Image>` / `<Video>` from `fimo/ui`. Never `<img src>`.
+- **Forms** → the generated Zod schema + `submitX` helper. Never hand-roll fetch/validation.
+
+## Development loop
+
+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.
+
+## Project rules
+
+- **Deploy is on-demand**, not a save step. Batch related edits into one deploy.
+- Do not add a second deploy tool (Vercel, Netlify, etc.).
+- **Never edit `.fimo.settings.json`** — it links this folder to the remote project.
+- The scaffolded homepage is disposable starter content. Replace it on the first real generation.
+- **Secrets live in the Fimo dashboard**, not in a committed `.env`.
+- When scripting, pass flags to `fimo` commands (`fimo deploy -m "…"`, `fimo delete -y`) — bare interactive forms hang in non-TTY shells.

package/templates/react-router/CLAUDE.md

@@ -0,0 +1,5 @@
+# Fimo project
+
+Instructions for this project live in `AGENTS.md` (the cross-tool standard). Read it:
+
+@AGENTS.md

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.9.0-experimental.1",
+    "fimo": "0.9.0",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",