fimo 0.11.0-staging.4 → 0.11.0-staging.6

package/assets/skills/fimo-code/references/labels.md

@@ -21,11 +21,11 @@ In development, the generated app reloads when DB label values change. In produc
 
 ## Locale behavior
 
-The default label locale is `i18n.defaultLocale` in `fimo-config.json`, falling back to `en` when it is not set. `fimo validate`, the generated app runtime, and `fimo labels set` without `--locale` all use that default locale.
+The default label locale is `i18n.defaultLocale` in `.fimo/config.json`, falling back to `en` when it is not set. `fimo validate`, the generated app runtime, and `fimo labels set` without `--locale` all use that default locale.
 
 For non-default locales, create explicit DB values with `fimo labels set --locale <locale>` or `fimo labels set-many --locale <locale>`. Keep the code shape the same for every locale: `t('hero.title')` declares the key, and the DB decides which locale value is shown.
 
-`fimo-config.json` owns the locale list:
+`.fimo/config.json` owns the locale list:
 
 ```json
 {

package/assets/skills/fimo-code/references/locales.md

@@ -4,7 +4,7 @@ Fimo provides locale utilities that follow the Fimo standard, but they are helpe
 
 ## Configuration
 
-`fimo-config.json` owns the locale list and routing strategy. Keep one locale unless the user asks for multilingual or localized output.
+`.fimo/config.json` owns the locale list and routing strategy. Keep one locale unless the user asks for multilingual or localized output.
 
 ```jsonc
 {
@@ -28,7 +28,7 @@ Locale tags should be structurally valid, for example `en`, `es`, `pt-BR`, or `z
 
 ## Canonical Routes
 
-Keep `fimo-config.json#routes` canonical and unlocalized:
+Keep `.fimo/config.json#routes` canonical and unlocalized:
 
 ```json
 {
@@ -71,7 +71,7 @@ Copyable examples live in `assets/react-router-locales/routes.ts` and `assets/re
 
 Before changing a multilingual app, inspect its locale provider, route table, language switcher, redirects, and current public URLs. Preserve that behavior while migrating.
 
-For React Router projects, prefer converging on one locale contract owned by `fimo-config.json`, `fimoRoutes()`, and `FimoLink`. Move existing providers and language-switcher UI into the framework root instead of replacing them or adding a second locale context. Keep route metadata canonical and reuse page modules across locales.
+For React Router projects, prefer converging on one locale contract owned by `.fimo/config.json`, `fimoRoutes()`, and `FimoLink`. Move existing providers and language-switcher UI into the framework root instead of replacing them or adding a second locale context. Keep route metadata canonical and reuse page modules across locales.
 
 If adopting the standard helper would change established public URLs, do not silently rewrite them. Keep the custom router temporarily, pass its resolved locale to `<FimoProviders locale={locale}>`, and ask the user to choose the canonical URLs and redirects before normalizing the route table.
 
@@ -86,7 +86,7 @@ import { FimoLink } from 'fimo/react-router';
 <FimoLink to="/pricing" locale="es">Spanish pricing</FimoLink>
 ```
 
-`FimoLink` localizes absolute internal paths according to `fimo-config.json#i18n.routing`. It leaves relative, hash, query-only, and external URLs alone. Use React Router's raw `Link` only when you intentionally want to bypass Fimo's locale behavior.
+`FimoLink` localizes absolute internal paths according to `.fimo/config.json#i18n.routing`. It leaves relative, hash, query-only, and external URLs alone. Use React Router's raw `Link` only when you intentionally want to bypass Fimo's locale behavior.
 
 Read the active locale with `useLocale()` when component logic needs it:
 
@@ -125,5 +125,5 @@ When using custom routing, also provide localized internal-link helpers in that
 ## What Not To Do
 
 - Do not create `src/pages/__localized/*` copies just for locales.
-- Do not duplicate every route in `fimo-config.json` per locale.
+- Do not duplicate every route in `.fimo/config.json` per locale.
 - Do not use `/es` as a normal canonical route when `es` is an enabled locale.

package/assets/skills/fimo-code/references/setup-plain-vite.md

@@ -85,7 +85,7 @@ Notes:
 ```
 
 The `seo` plugin rewrites `<title>`, og, twitter, canonical tags from
-`fimo-config.json#seo` at build time. You can leave a placeholder title in
+`.fimo/config.json#seo` at build time. You can leave a placeholder title in
 `index.html`; it'll be replaced.
 
 ## File: `src/main.tsx`
@@ -140,7 +140,7 @@ export function App() {
 }
 ```
 
-## File: `fimo-config.json`
+## File: `.fimo/config.json`
 
 ```json
 {
@@ -165,7 +165,7 @@ this version field. It also never injects the React Router plugin: in a
 framework-mode project that `reactRouter()` plugin is added by your own
 `vite.config.ts`, not by `fimo/vite`.
 
-## File: `.fimo.settings.json`
+## File: `.fimo/project.json`
 
 ```json
 {
@@ -222,6 +222,6 @@ shows the **deployed** app, not the localhost dev server.
 ## What to do next
 
 - Add a sitemap: pass `fimo({ seo: true, sitemap: true })` and set
-  `fimo-config.json#seo.url` to your production base URL.
+  `.fimo/config.json#seo.url` to your production base URL.
 - Look up exports: see `references/ui.md`.
 - Use schema content: see `references/content.md`.

package/assets/skills/fimo-code/references/setup-react-router.md

@@ -166,7 +166,7 @@ export default fimoRoutes(routes) satisfies RouteConfig;
 Page filenames are your choice; the scaffold uses PascalCase (e.g. `Index.tsx`,
 `Privacy.tsx`).
 
-`fimoRoutes()` is Fimo's React Router helper for path-prefix locales. It is a no-op for single-locale projects and expands concrete locale aliases when `fimo-config.json#i18n.locales` contains more locales. Custom routers can ignore this helper and pass their own locale to `<FimoProviders locale={locale}>`; see `references/locales.md`.
+`fimoRoutes()` is Fimo's React Router helper for path-prefix locales. It is a no-op for single-locale projects and expands concrete locale aliases when `.fimo/config.json#i18n.locales` contains more locales. Custom routers can ignore this helper and pass their own locale to `<FimoProviders locale={locale}>`; see `references/locales.md`.
 
 ## File: `src/pages/Index.tsx`
 
@@ -182,7 +182,7 @@ export default function HomePage() {
 }
 ```
 
-## File: `fimo-config.json`
+## File: `.fimo/config.json`
 
 ```json
 {
@@ -200,7 +200,7 @@ export default function HomePage() {
 }
 ```
 
-## File: `.fimo.settings.json`
+## File: `.fimo/project.json`
 
 ```json
 {
@@ -268,9 +268,9 @@ changes after a `fimo deploy` (the local dev server is localhost-only).
 ## What to do next
 
 - Add more routes: extend `src/routes.ts`, create matching `src/pages/*.tsx`,
-  add route entries in `fimo-config.json#routes`.
+  add route entries in `.fimo/config.json#routes`.
 - Add a sitemap: pass `fimo({ sitemap: true })` (opt-in, off by default; the
   canonical template enables it). To customize the base URL, set
-  `fimo-config.json#seo.url`.
+  `.fimo/config.json#seo.url`.
 - Override SEO per route: see `references/seo-overrides.md`.
 - Look up an export: see `references/api.md`.

package/assets/skills/fimo-code/references/ui.md

@@ -27,7 +27,7 @@ Use these to render content-type field values consistently. They carry source me
 1. **Schema text → `<Text>`**, never `<h1>{post.title}</h1>`.
 2. **Schema media → `<Image>` / `<Video>`**, never `<img src={post.coverImage.url} />`. Provide `width` / `height` when known so Fimo can optimize and reserve layout space.
 3. **Non-schema images** (decorative, hard-coded URLs, generated assets referenced directly) → `<StaticImage>`. Never hand-construct a `FimoMedia` to feed `<Image>`.
-4. **Label text → `<Text value={t('key')} />`**, not `<h1>{t(...)}</h1>`. Label values live in the DB for `i18n.defaultLocale` from `fimo-config.json` unless a non-default locale is explicitly targeted. See `references/labels.md`.
+4. **Label text → `<Text value={t('key')} />`**, not `<h1>{t(...)}</h1>`. Label values live in the DB for `i18n.defaultLocale` from `.fimo/config.json` unless a non-default locale is explicitly targeted. See `references/labels.md`.
 5. **Mixed schema + translated text** → the `` fimo`...` `` template literal inside `<Text>`.
 6. **Never hand-roll richtext rendering** — always `<RichText>`. To restyle a node, pass `components={{ heading: ..., link: ..., ... }}`.
 7. **Schema `json` → `<Json>`**, not a hand-rolled `<pre data-fimo-source={getFimoSource(post.metadata)}>{JSON.stringify(post.metadata)}</pre>`. Default renders as a `<span>`; pass `as="pre"` (with a `whitespace-pre-wrap` class) for a formatted block, or a children render function for custom display of specific keys.

package/assets/skills/fimo-migration/references/workflow.md

@@ -6,7 +6,7 @@ Use this as the phase contract for complete migrations.
 
 1. Confirm the target path.
 2. If the target path is missing, create exactly one Fimo project there.
-3. If it has `.fimo.settings.json`, reuse it.
+3. If it has `.fimo/project.json` or the legacy `.fimo.settings.json`, reuse it.
 4. If it is non-empty and not a Fimo project, stop and ask for a target path.
 5. Never overwrite user work outside generated migration folders without reading
    the existing files first.

package/assets/skills/fimo-migration/scripts/build-canonical-manifest.mjs

@@ -110,7 +110,7 @@ function buildCanonicalManifest({ projectRoot, urlLedger, urlLedgerPath, sourceL
     forms,
     redirects: normalizeItems(sourceLedger?.redirects, 'redirect'),
     locales: normalizeItems(sourceLedger?.locales, 'locale'),
-    seo: normalizeSeo(urlLedger),
+    seo: normalizeSeo(urlLedger, projectRoot),
     unsupported: normalizeItems(sourceLedger?.unsupported, 'unsupported'),
     unresolved: mergeItems([
       ...normalizeUnresolved(sourceLedger?.unresolved),
@@ -326,14 +326,15 @@ function normalizeUrlForms(forms) {
   }));
 }
 
-function normalizeSeo(urlLedger) {
+function normalizeSeo(urlLedger, projectRoot) {
+  const configPath = resolveProjectConfigPath(projectRoot);
   return asArray(urlLedger?.pages).map((page) => ({
     id: `seo:${page.route}`,
     status: 'discovered',
     route: page.route,
     sourceUrls: compact([page.url]),
     sourceFiles: compact([page.artifacts?.html]),
-    targetFiles: ['fimo-config.json'],
+    targetFiles: [configPath],
     confidence: numberOr(page.confidence, 0.7),
     title: page.seo?.title ?? page.title ?? null,
     description: page.seo?.description ?? null,
@@ -341,6 +342,34 @@ function normalizeSeo(urlLedger) {
   }));
 }
 
+function resolveProjectConfigPath(projectRoot) {
+  if (fs.existsSync(path.join(projectRoot, '.fimo/project.json'))) {
+    return '.fimo/config.json';
+  }
+  if (fs.existsSync(path.join(projectRoot, '.fimo.settings.json'))) {
+    if (fs.existsSync(path.join(projectRoot, 'fimo-config.json'))) {
+      return 'fimo-config.json';
+    }
+    if (fs.existsSync(path.join(projectRoot, 'fimo.config.json'))) {
+      return 'fimo.config.json';
+    }
+    return 'fimo-config.json';
+  }
+  if (
+    fs.existsSync(path.join(projectRoot, '.fimo/config.json')) ||
+    fs.existsSync(path.join(projectRoot, '.fimo/agents'))
+  ) {
+    return '.fimo/config.json';
+  }
+  if (fs.existsSync(path.join(projectRoot, 'fimo-config.json'))) {
+    return 'fimo-config.json';
+  }
+  if (fs.existsSync(path.join(projectRoot, 'fimo.config.json'))) {
+    return 'fimo.config.json';
+  }
+  return '.fimo/config.json';
+}
+
 function normalizeUnresolved(items) {
   return asArray(items).map((item, index) => {
     if (typeof item === 'string') {

package/assets/skills/fimo-studio/references/custom-domains.md

@@ -12,7 +12,7 @@ If you're driving Fimo from the terminal, the equivalent commands are `fimo doma
 ## Adding a Custom Domain
 
 1. Open **Settings** from the top navigation bar (gear icon), alongside Preview, Content, Assets, Agents, and Analytics.
-2. In the Settings menu on the left, select **Domains** (globe icon) — listed with General, SEO, and Audit log.
+2. In the Settings menu on the left, select **Domains** (globe icon) — listed with General and SEO.
 3. Click the **Add domain** button (+ icon) in the top-right of the panel. (When domain purchase is enabled, a **Buy domain** button with a shopping-cart icon sits next to it.)
 4. A drawer opens. Type or select a domain — you can enter a subdomain or an apex domain. Domains your organization already owns appear in an autocomplete dropdown, and Fimo checks availability live as you type. For an apex domain, a checkbox lets you also redirect it to the `www` subdomain (on by default). Confirm to add it.
 5. A DNS table appears showing the record(s) you need to add. For a **subdomain** it's a single CNAME record:

package/dist/build/vite/index.d.ts

@@ -2,7 +2,7 @@ import type { PluginOption } from 'vite';
 export interface FimoViteOptions {
     /**
      * Emit `sitemap.xml` at build (and serve at `/sitemap.xml` in dev). Reads
-     * `seo.url` from `fimo-config.json` as the base URL.
+     * `seo.url` from `.fimo/config.json` as the base URL.
      *
      * Opt-in via `fimo({ sitemap: true })`.
      */
@@ -10,14 +10,14 @@ export interface FimoViteOptions {
     /**
      * Emit `robots.txt` at build (and serve at `/robots.txt` in dev). Defaults
      * to an allow-all robots policy + a `Sitemap:` directive when `seo.url` is
-     * set in `fimo-config.json`.
+     * set in `.fimo/config.json`.
      *
      * Opt-in via `fimo({ robots: true })`.
      */
     robots?: boolean;
     /**
      * Inject SEO meta tags into `index.html` via `transformIndexHtml`. Resolves
-     * per-route SEO from `fimo-config.json#seo` and the matched route.
+     * per-route SEO from `.fimo/config.json#seo` and the matched route.
      *
      * Only applies in projects that have an `index.html` (plain Vite). Conflicts
      * with frameworks that have their own SEO mechanism — React Router's `meta`

package/dist/build/vite/plugins/fimo-config.d.ts

@@ -1,11 +1,11 @@
 import type { Plugin } from 'vite';
 /**
- * Vite plugin that exposes the user's `fimo-config.json`:
+ * Vite plugin that exposes the user's `.fimo/config.json`:
  * - As a virtual module `virtual:fimo-config` that browser-running package
  *   code (fimo/seo, fimo/app) imports to read `seo`, `routes`, etc. without
  *   relying on `readFileSync` at runtime.
  *
- * Edits to `fimo-config.json` invalidate the virtual module so HMR picks up
+ * Edits to the project config invalidate the virtual module so HMR picks up
  * the new values without a full reload.
  */
 export default function fimoConfigPlugin(): Plugin;

package/dist/build/vite/plugins/fimo-config.js

@@ -1,23 +1,23 @@
 import { readFileSync } from 'fs';
-import { resolve } from 'path';
+import { resolveFimoConfigPath } from '../../../runtime/shared/fimo-config.server.js';
 const VIRTUAL_ID = 'virtual:fimo-config';
 const RESOLVED_ID = '\0' + VIRTUAL_ID;
 /**
- * Vite plugin that exposes the user's `fimo-config.json`:
+ * Vite plugin that exposes the user's `.fimo/config.json`:
  * - As a virtual module `virtual:fimo-config` that browser-running package
  *   code (fimo/seo, fimo/app) imports to read `seo`, `routes`, etc. without
  *   relying on `readFileSync` at runtime.
  *
- * Edits to `fimo-config.json` invalidate the virtual module so HMR picks up
+ * Edits to the project config invalidate the virtual module so HMR picks up
  * the new values without a full reload.
  */
 export default function fimoConfigPlugin() {
-    let configPath = resolve(process.cwd(), 'fimo-config.json');
+    let configPath = resolveFimoConfigPath(process.cwd());
     return {
         name: 'vite-plugin-fimo-config',
         config(userConfig) {
             const root = typeof userConfig.root === 'string' ? userConfig.root : process.cwd();
-            configPath = resolve(root, 'fimo-config.json');
+            configPath = resolveFimoConfigPath(root);
         },
         resolveId(id) {
             if (id === VIRTUAL_ID) {

package/dist/build/vite/plugins/robots.d.ts

@@ -1,7 +1,7 @@
 import type { Plugin } from 'vite';
 /**
  * Emit a minimal `robots.txt` (allow-all + Sitemap reference if `seo.url` is
- * set in `fimo-config.json`). Serves at `/robots.txt` in dev; emits as a
+ * set in `.fimo/config.json`). Serves at `/robots.txt` in dev; emits as a
  * static asset at build time.
  *
  * Opt-in via `fimo({ robots: true })` in your `vite.config.ts`.

package/dist/build/vite/plugins/robots.js

@@ -1,8 +1,8 @@
 import { readFileSync } from 'fs';
-import { resolve } from 'path';
+import { resolveFimoConfigPath } from '../../../runtime/shared/fimo-config.server.js';
 function readSeoUrl() {
     try {
-        const raw = readFileSync(resolve(process.cwd(), 'fimo-config.json'), 'utf-8');
+        const raw = readFileSync(resolveFimoConfigPath(process.cwd()), 'utf-8');
         const config = JSON.parse(raw);
         return config.seo?.url;
     }
@@ -25,7 +25,7 @@ function buildRobotsTxt(baseUrl) {
 }
 /**
  * Emit a minimal `robots.txt` (allow-all + Sitemap reference if `seo.url` is
- * set in `fimo-config.json`). Serves at `/robots.txt` in dev; emits as a
+ * set in `.fimo/config.json`). Serves at `/robots.txt` in dev; emits as a
  * static asset at build time.
  *
  * Opt-in via `fimo({ robots: true })` in your `vite.config.ts`.

package/dist/build/vite/plugins/server-config.js

@@ -9,7 +9,7 @@ export default function serverConfigPlugin() {
                         overlay: false,
                     },
                     watch: {
-                        ignored: ['**/.worktrees/**', '**/fimo-config.json'],
+                        ignored: ['**/.worktrees/**', '**/.fimo/config.json', '**/fimo-config.json'],
                     },
                 },
                 build: {},

package/dist/build/vite/plugins/sitemap.js

@@ -1,9 +1,9 @@
 import { readFileSync } from 'fs';
-import { resolve } from 'path';
 import { getFimoPaths } from '../../../runtime/paths/get-fimo-paths.js';
+import { resolveFimoConfigPath } from '../../../runtime/shared/fimo-config.server.js';
 function readSeoUrl() {
     try {
-        const raw = readFileSync(resolve(process.cwd(), 'fimo-config.json'), 'utf-8');
+        const raw = readFileSync(resolveFimoConfigPath(process.cwd()), 'utf-8');
         const config = JSON.parse(raw);
         return config.seo?.url;
     }

package/dist/build/vite/plugins/translations.js

@@ -4,7 +4,8 @@ import { readFile } from 'node:fs/promises';
 import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { getFimoDefaultLocale, getFimoLocales } from '../../../runtime/i18n/locale.js';
-import { getConfigServer } from '../../../runtime/shared/fimo-config.server.js';
+import { CURRENT_PROJECT_LAYOUT, LEGACY_PROJECT_LAYOUT } from '../../../runtime/project-layout.js';
+import { getConfigServer, resolveFimoConfigPath } from '../../../runtime/shared/fimo-config.server.js';
 const VIRTUAL_ID = 'virtual:translations';
 const RESOLVED_ID = '\0' + VIRTUAL_ID;
 const EVENT_RECONNECT_DELAY_MS = 2000;
@@ -155,7 +156,7 @@ export default function translationsPlugin() {
         },
         async buildStart() {
             bundle = emptyLabelBundle(rootDir);
-            this.addWatchFile(join(rootDir, 'fimo-config.json'));
+            this.addWatchFile(resolveFimoConfigPath(rootDir));
             this.addWatchFile(join(rootDir, '.env'));
             this.addWatchFile(join(rootDir, '.env.local'));
             if (command === 'build') {
@@ -165,7 +166,7 @@ export default function translationsPlugin() {
         configureServer(server) {
             devServer = server;
             closed = false;
-            server.watcher.add([join(rootDir, 'fimo-config.json'), join(rootDir, '.env'), join(rootDir, '.env.local')]);
+            server.watcher.add([resolveFimoConfigPath(rootDir), join(rootDir, '.env'), join(rootDir, '.env.local')]);
             void refreshLabelsAndInvalidateIfChanged().catch(() => undefined);
             startFallbackPolling();
             void connectEvents();
@@ -196,7 +197,7 @@ export default function translationsPlugin() {
             ].join('\n');
         },
         async handleHotUpdate(ctx) {
-            const watched = new Set([join(rootDir, 'fimo-config.json'), join(rootDir, '.env'), join(rootDir, '.env.local')]);
+            const watched = new Set([resolveFimoConfigPath(rootDir), join(rootDir, '.env'), join(rootDir, '.env.local')]);
             if (!watched.has(ctx.file)) {
                 return;
             }
@@ -515,13 +516,16 @@ async function readEnvFile(filePath) {
     }
 }
 async function readProjectSettings(rootDir) {
-    try {
-        const raw = await readFile(join(rootDir, '.fimo.settings.json'), 'utf8');
-        return JSON.parse(raw);
-    }
-    catch {
-        return {};
+    for (const relativePath of [CURRENT_PROJECT_LAYOUT.project, LEGACY_PROJECT_LAYOUT.project]) {
+        try {
+            const raw = await readFile(join(rootDir, relativePath), 'utf8');
+            return JSON.parse(raw);
+        }
+        catch {
+            continue;
+        }
     }
+    return {};
 }
 function deriveEventsRooms(projectId, tenantApiUrl) {
     const rooms = new Set([projectId]);

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-08-02T09:47:16.199Z",
+  "bundledAt": "2026-08-04T09:13:16.740Z",
   "cliVersion": "0.10.0",
   "external": [
     "oxc-parser",