fimo 2.2.0-staging.15 → 2.2.0-staging.16

package/assets/skills/fimo-code/references/frameworks/next/app-router.md

@@ -109,7 +109,18 @@ Do not add `'use client'` to a page solely because Fimo is present. Keep promise
 
 ## Metadata
 
-Next remains in control through `generateMetadata`. Resolve labels/content on the server and convert tracked strings only where Next expects primitives:
+Fimo owns the site-wide defaults; the application owns per-page overrides. Keep (or add) the starter wiring in the root layout — it maps `.fimo/config.json#seo` (Studio's Settings → SEO: title, description, favicon, share image, robots, theme color, canonical) onto Next `Metadata`/`Viewport`:
+
+```ts
+import { buildFimoMetadata, buildFimoViewport } from 'fimo-next';
+
+export const generateMetadata = () => buildFimoMetadata();
+export const generateViewport = () => buildFimoViewport();
+```
+
+If the root layout lacks this wiring, add it (updating the fimo packages if `fimo-next` does not export the helpers); without it, Settings → SEO never reaches the rendered head.
+
+Per-page `metadata`/`generateMetadata` exports override the defaults field by field. Resolve labels/content on the server and convert tracked strings only where Next expects primitives:
 
 ```ts
 export async function generateMetadata() {

package/assets/skills/fimo-code/references/frameworks/next.md

@@ -2,7 +2,7 @@
 
 Use this reference when `fimo describe --json` reports `framework.slug: "nextjs"`, or the project uses an App Router (`app/` or `src/app/`) or Pages Router (`pages/` or `src/pages/`) tree.
 
-Fimo supports schema-first content in both routers across static generation, ISR, request-time rendering, and Client Components. The application owns routes, locale resolution, links, `<html lang/dir>`, and SEO. Fimo receives the resolved locale and supplies content, labels, source metadata, and client editing context.
+Fimo supports schema-first content in both routers across static generation, ISR, request-time rendering, and Client Components. The application owns routes, locale resolution, links, `<html lang/dir>`, and per-page SEO overrides. Fimo receives the resolved locale and supplies content, labels, source metadata, client editing context, and the site-wide SEO defaults (App Router: `buildFimoMetadata`/`buildFimoViewport` in the root layout — see the router reference's Metadata section).
 
 ## Choose the router reference
 

package/dist/cli/bundle.json

@@ -1,7 +1,7 @@
 {
   "bundled": true,
   "bundler": "esbuild",
-  "bundledAt": "2026-09-01T10:25:33.582Z",
+  "bundledAt": "2026-09-01T11:14:02.951Z",
   "cliVersion": "2.1.0",
   "external": [
     "oxc-parser",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.2.0-staging.15",
+  "version": "2.2.0-staging.16",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -189,13 +189,13 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.2.0-staging.15",
-    "@fimo/api-contracts": "2.2.0-staging.15",
-    "@fimo/cli-kit": "2.2.0-staging.15",
-    "@fimo/framework-detect": "2.2.0-staging.15",
-    "@fimo/routes": "2.2.0-staging.15",
-    "@fimo/sdk": "2.2.0-staging.15",
-    "@fimo/tsconfig": "2.2.0-staging.15",
+    "@fimo/agents-bundle": "2.2.0-staging.16",
+    "@fimo/api-contracts": "2.2.0-staging.16",
+    "@fimo/cli-kit": "2.2.0-staging.16",
+    "@fimo/framework-detect": "2.2.0-staging.16",
+    "@fimo/routes": "2.2.0-staging.16",
+    "@fimo/sdk": "2.2.0-staging.16",
+    "@fimo/tsconfig": "2.2.0-staging.16",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",

package/templates/astro/package.json

@@ -9,8 +9,8 @@
     "check": "astro sync && astro check"
   },
   "dependencies": {
-    "fimo": "2.2.0-staging.15",
-    "fimo-astro": "2.2.0-staging.15"
+    "fimo": "2.2.0-staging.16",
+    "fimo-astro": "2.2.0-staging.16"
   },
   "devDependencies": {
     "@astrojs/check": "^0.9.10",

package/templates/nextjs/AGENTS.md

@@ -40,7 +40,7 @@ The scaffolded homepage is disposable. Replace it on the first real generation.
 - Next's `app` tree is the router and stays authoritative: the default shell is one ordinary root layout plus `/` as the homepage, and unknown paths get Next's native 404. When a product requires locale URLs, implement the framework-native strategy (`[locale]` segments, middleware, cookies, domains, or an i18n library), pass the resolved locale into Fimo server reads and `FimoProvider`, and load `fimo skills get fimo-code --ref frameworks/next/locales` first. Do not impose locale-prefixed URLs on a default-only project.
 - `FimoProvider` owns the optional Studio preview runtime. Do not add a preview bridge component, read Fimo preview environment variables, or inject Fimo scripts in application code.
 - Keep `.fimo/config.json#routes` as Studio metadata, not as the Next.js router. Describe only URLs the application actually serves; add a `:locale` segment to a route's metadata only after the application implements that locale routing. There, `params.locale.optional: true` means omit the configured default locale from the URL; use `optional: false` only when every locale, including the default, must be prefixed.
-- The application owns routes, locale resolution, links, HTML language/direction, and SEO. Fimo connects to those decisions.
+- The application owns routes, locale resolution, links, HTML language/direction, and per-page SEO overrides. Fimo supplies the site-wide SEO defaults (title, description, favicon, share image) from `.fimo/config.json#seo` through the root layout's `generateMetadata`/`generateViewport` (`buildFimoMetadata`/`buildFimoViewport` from `fimo-next`); keep that wiring, and add page-level `metadata`/`generateMetadata` exports where a page needs its own values — they merge over the defaults.
 - Do not add a second deployment platform.
 - Never edit `.fimo/project.json`; it links this directory to the remote project.
 - Keep `.fimo/config.json#runtime` true to the code: framework, `dev`/`build`/`install` commands, output directory. Update it when you rename a package script, move the build output, or change framework; the reference is `fimo skills get fimo-code --ref frameworks/hosting`.

package/templates/nextjs/package.json

@@ -12,9 +12,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.15",
-    "fimo-next": "2.2.0-staging.15",
-    "fimo-react": "2.2.0-staging.15",
+    "fimo": "2.2.0-staging.16",
+    "fimo-next": "2.2.0-staging.16",
+    "fimo-react": "2.2.0-staging.16",
     "next": "^16.3.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"

package/templates/nextjs/src/app/layout.tsx

@@ -1,10 +1,13 @@
-import { FimoProvider } from 'fimo-next';
+import { FimoProvider, buildFimoMetadata, buildFimoViewport } from 'fimo-next';
 import type { ReactNode } from 'react';
 
 import { defaultLocale } from '../locales';
 
 import './globals.css';
 
+export const generateMetadata = () => buildFimoMetadata();
+export const generateViewport = () => buildFimoViewport();
+
 export default function RootLayout({ children }: Readonly<{ children: ReactNode }>) {
   return (
     <html lang={defaultLocale}>

package/templates/react-router/package.json

@@ -21,10 +21,10 @@
     "cmdk": "^1.1.1",
     "date-fns": "^4.1.0",
     "embla-carousel-react": "^8.6.0",
-    "fimo": "2.2.0-staging.15",
-    "fimo-react": "2.2.0-staging.15",
-    "fimo-react-router": "2.2.0-staging.15",
-    "fimo-vite": "2.2.0-staging.15",
+    "fimo": "2.2.0-staging.16",
+    "fimo-react": "2.2.0-staging.16",
+    "fimo-react-router": "2.2.0-staging.16",
+    "fimo-vite": "2.2.0-staging.16",
     "input-otp": "^1.4.2",
     "isbot": "^5",
     "lucide-react": "^0.577.0",

package/templates/sveltekit/package.json

@@ -11,8 +11,8 @@
     "prepare": "svelte-kit sync"
   },
   "dependencies": {
-    "fimo": "2.2.0-staging.15",
-    "fimo-sveltekit": "2.2.0-staging.15"
+    "fimo": "2.2.0-staging.16",
+    "fimo-sveltekit": "2.2.0-staging.16"
   },
   "devDependencies": {
     "@sveltejs/kit": "^2.70.2",

package/templates/vite/package.json

@@ -11,10 +11,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.15",
-    "fimo-react": "2.2.0-staging.15",
-    "fimo-react-router": "2.2.0-staging.15",
-    "fimo-vite": "2.2.0-staging.15",
+    "fimo": "2.2.0-staging.16",
+    "fimo-react": "2.2.0-staging.16",
+    "fimo-react-router": "2.2.0-staging.16",
+    "fimo-vite": "2.2.0-staging.16",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"