fimo 2.2.0-staging.1 → 2.2.0-staging.11

package/dist/runtime/templates.js

@@ -28,7 +28,7 @@ const PACKAGE_ROOT = path.resolve(MODULE_DIR, '..', '..');
 const RELEASE_FILE = path.join(PACKAGE_ROOT, 'release.json');
 const PACKAGE_JSON_FILE = path.join(PACKAGE_ROOT, 'package.json');
 export const TEMPLATE_FRAMEWORKS = ['react-router', 'vite', 'astro', 'nextjs', 'sveltekit'];
-export const DEFAULT_TEMPLATE = 'react-router';
+export const DEFAULT_TEMPLATE = 'nextjs';
 /**
  * Absolute path to the requested framework's template directory.
  *
@@ -42,6 +42,9 @@ export const DEFAULT_TEMPLATE = 'react-router';
 export function getTemplatePath(framework = DEFAULT_TEMPLATE) {
     return path.resolve(PACKAGE_ROOT, 'templates', framework);
 }
+export function getWelcomeTemplatePath() {
+    return path.resolve(PACKAGE_ROOT, 'templates', 'welcome');
+}
 /**
  * Absolute path to the legacy template at `apps/api/templates/default/`.
  *
@@ -69,8 +72,8 @@ export function readReleaseMeta() {
     try {
         const raw = fs.readFileSync(RELEASE_FILE, 'utf8');
         const parsed = JSON.parse(raw);
-        const source = parsed.source === 'npm' || parsed.source === 'dev' ? parsed.source : null;
-        return { source };
+        const source = parsed.source === 'npm' || parsed.source === 'dev' || parsed.source === 'url' ? parsed.source : null;
+        return { source, url: typeof parsed.url === 'string' && parsed.url.length > 0 ? parsed.url : null };
     }
     catch {
         return { source: null };
@@ -91,16 +94,34 @@ export function readCliSemver() {
 }
 /**
  * Pure version: given a release manifest + CLI semver, return the value
- * to pin `fimo` to (or null for dev). Exported for unit tests.
+ * to pin `fimo` to (or null when nothing is known). Exported for unit tests.
+ *
+ * Throws rather than returning an unreproducible pin: a project that records a
+ * package-manager cache path (or a `fimo` its companions cannot follow) is
+ * broken on every other machine, and the error names the missing publish step.
  */
 export function computeFimoPin(meta, semver, options = {}) {
     if (meta.source === 'npm') {
-        if (semver) {
-            return semver;
+        return semver;
+    }
+    // A checkout wins over a baked artifact URL: `publish-cli --id` keeps its
+    // release.json in the workspace so the next local run still iterates on
+    // source, not on the tarball it just uploaded.
+    const localPin = options.devPackageRoot ? `file:${options.devPackageRoot}` : null;
+    if (localPin && pinsWholeGroup(localPin)) {
+        return localPin;
+    }
+    if (meta.source === 'url') {
+        if (!meta.url) {
+            throw new Error('Refusing to create a project from a development CLI that was published without a public artifact URL. ' +
+                'Republish it remotely with `pnpm -F fimo publish-cli -- --id <task-name>` and install that artifact.');
         }
+        return meta.url;
     }
-    if ((meta.source === 'dev' || meta.source === null) && options.devPackageRoot) {
-        return `file:${options.devPackageRoot}`;
+    if (localPin) {
+        throw new Error(`Refusing to create a project pinned to ${localPin}: that path is not a Fimo checkout, so it is neither ` +
+            'reproducible on another machine nor able to pin the matching companion packages. Install `fimo` from npm, ' +
+            'or publish this CLI with `pnpm -F fimo publish-cli -- --id <task-name>` and install that artifact.');
     }
     return null;
 }
@@ -233,6 +254,14 @@ export function deriveFimoPackagePin(name, fimoPin) {
     }
     return fimoPin;
 }
+/**
+ * Whether every Fimo package can be pinned from this `fimo` pin. A pin that
+ * only the CLI can follow leaves the companions on the template's `latest`,
+ * which silently mixes channels inside one project (FIMO-2070).
+ */
+function pinsWholeGroup(fimoPin) {
+    return FIMO_PACKAGES.every((name) => deriveFimoPackagePin(name, fimoPin) !== null);
+}
 /**
  * Rewrite `fimo` and any companion packages present (in dependencies +
  * devDependencies) to the current pin. Only touches entries that look like a

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.2.0-staging.1",
+  "version": "2.2.0-staging.11",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -77,6 +77,10 @@
       "types": "./dist/runtime/astro/internal.d.ts",
       "import": "./dist/runtime/astro/internal.js"
     },
+    "./vite/preview-health": {
+      "types": "./dist/build/vite/plugins/preview-health.d.ts",
+      "import": "./dist/build/vite/plugins/preview-health.js"
+    },
     "./next": {
       "types": "./dist/build/next/moved.d.ts",
       "import": "./dist/build/next/moved.js"
@@ -172,6 +176,7 @@
     "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:package-manager-compat": "pnpm --workspace-root run build --filter=fimo && node test/package-manager-compat/run.mjs",
     "test:watch": "vitest",
     "clean": "rm -rf dist *.tsbuildinfo"
   },
@@ -184,12 +189,12 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.2.0-staging.1",
-    "@fimo/api-contracts": "2.2.0-staging.1",
-    "@fimo/cli-kit": "2.2.0-staging.1",
-    "@fimo/framework-detect": "2.2.0-staging.1",
-    "@fimo/routes": "2.2.0-staging.1",
-    "@fimo/tsconfig": "2.2.0-staging.1",
+    "@fimo/agents-bundle": "2.2.0-staging.11",
+    "@fimo/api-contracts": "2.2.0-staging.11",
+    "@fimo/cli-kit": "2.2.0-staging.11",
+    "@fimo/framework-detect": "2.2.0-staging.11",
+    "@fimo/routes": "2.2.0-staging.11",
+    "@fimo/tsconfig": "2.2.0-staging.11",
     "@types/node": "22.18.6",
     "agent-install": "^0.0.5",
     "astro": "^7.1.6",
@@ -201,8 +206,8 @@
     "tsx": "4.22.4",
     "typescript": "7.0.2",
     "vite": "8.2.2",
-    "vitest": "4.1.10",
-    "wrangler": "4.124.0",
+    "vitest": "4.1.11",
+    "wrangler": "4.126.0",
     "yaml": "2.8.2"
   },
   "engines": {

package/templates/astro/package.json

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

package/templates/nextjs/AGENTS.md

@@ -37,7 +37,7 @@ The scaffolded homepage is disposable. Replace it on the first real generation.
 - **Deploy is on-demand**, not a save step. Batch related edits into one deploy.
 - Use the selected package manager's committed build-script policy. pnpm projects pin `pnpm@10.26.0` and approve `esbuild` and `fimo` through `pnpm-workspace.yaml#allowBuilds`; Bun projects trust the same packages through `package.json#trustedDependencies`. Run a plain install with the selected manager so local installation matches Preview and production publishing. Review new dependencies before extending the policy; all three paths stop on unreviewed scripts.
 - Treat the user's language request as part of setup. The first explicitly requested locale is the primary locale; put it first and set it as `i18n.defaultLocale` in `.fimo/config.json`, with every requested locale in `i18n.locales`. If no language is requested, keep `en` and state that choice. That file is the only place to change: `src/locales.ts` reads it, so the served language and `<html lang>` follow. It does not create locale URLs; implement a URL strategy only when the product asks for one. Never introduce a default-locale environment variable.
-- Next's `app` tree is the router and stays authoritative: the starter 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.
+- 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.

package/templates/nextjs/package.json

@@ -12,10 +12,10 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.1",
-    "fimo-next": "2.2.0-staging.1",
-    "fimo-react": "2.2.0-staging.1",
-    "next": "^16.3.0",
+    "fimo": "2.2.0-staging.11",
+    "fimo-next": "2.2.0-staging.11",
+    "fimo-react": "2.2.0-staging.11",
+    "next": "^16.3.3",
     "react": "^19.2.7",
     "react-dom": "^19.2.7"
   },

package/templates/react-router/.fimo/config.json

@@ -2,8 +2,7 @@
   "runtime": { "framework": "react-router" },
   "seo": {
     "title": "Welcome to your Fimo website",
-    "description": "A default homepage starter for Fimo projects.",
-    "siteName": "Fimo Starter Site",
+    "description": "A default homepage for Fimo projects.",
     "url": "https://fimo.ai/",
     "image": "https://fimo.ai/socials/og_cover.png",
     "favicon": "https://fimo.ai/favicon-orange.svg",

package/templates/react-router/AGENTS.md

@@ -47,6 +47,6 @@ breaks that. Load `fimo-code` for the exact primitives, but the rule is:
 - Do not add a second deploy tool (Vercel, Netlify, etc.).
 - **Never edit `.fimo/project.json`** — it links this folder 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`.
-- The scaffolded homepage is disposable starter content. Replace it on the first real generation.
+- The scaffolded homepage is disposable template 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/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.1",
-    "fimo-react": "2.2.0-staging.1",
-    "fimo-react-router": "2.2.0-staging.1",
-    "fimo-vite": "2.2.0-staging.1",
+    "fimo": "2.2.0-staging.11",
+    "fimo-react": "2.2.0-staging.11",
+    "fimo-react-router": "2.2.0-staging.11",
+    "fimo-vite": "2.2.0-staging.11",
     "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.1",
-    "fimo-sveltekit": "2.2.0-staging.1"
+    "fimo": "2.2.0-staging.11",
+    "fimo-sveltekit": "2.2.0-staging.11"
   },
   "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.1",
-    "fimo-react": "2.2.0-staging.1",
-    "fimo-react-router": "2.2.0-staging.1",
-    "fimo-vite": "2.2.0-staging.1",
+    "fimo": "2.2.0-staging.11",
+    "fimo-react": "2.2.0-staging.11",
+    "fimo-react-router": "2.2.0-staging.11",
+    "fimo-vite": "2.2.0-staging.11",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"

package/templates/welcome/manifest.json

@@ -0,0 +1,404 @@
+{
+  "name": "fimo-site",
+  "version": 14,
+  "description": "An editable Welcome to Fimo tutorial with real CMS content, media, branches, and an autonomous agent.",
+  "assets": [
+    {
+      "key": "editable-preview",
+      "file": "editable-preview.avif",
+      "name": "Editable Preview",
+      "altText": "A cursor selecting an orange image frame inside an editable website",
+      "caption": "Select this image in Preview to replace it."
+    },
+    {
+      "key": "media-library",
+      "file": "media-library.avif",
+      "name": "Media Library",
+      "altText": "A contact sheet of black, white, and orange website assets",
+      "caption": "These tutorial images are available in your Media Library."
+    },
+    {
+      "key": "autonomous-loop",
+      "file": "autonomous-loop.avif",
+      "name": "Autonomous Website Loop",
+      "altText": "A repeating website, check, edit, and deploy automation loop",
+      "caption": "Fimo agents keep a finished website healthy after the first build."
+    },
+    {
+      "key": "slack-teams",
+      "file": "slack-teams.avif",
+      "name": "Slack and Microsoft Teams",
+      "altText": "Slack and Microsoft Teams logos connected side by side",
+      "caption": "Connect Fimo to the collaboration tools your team already uses."
+    },
+    {
+      "key": "analytics-overview",
+      "file": "analytics-overview.avif",
+      "name": "Analytics Overview",
+      "altText": "A browser window with an ascending bar chart and an orange trend arrow",
+      "caption": "Follow your traffic in the Analytics workspace."
+    }
+  ],
+  "singletons": [
+    {
+      "type": "HomePage",
+      "data": {
+        "title": "This site is yours to change.",
+        "intro": {
+          "type": "doc",
+          "content": [
+            {
+              "type": "paragraph",
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Four actions, five minutes. Every change is safe to make in this tutorial project."
+                }
+              ]
+            }
+          ]
+        },
+        "heroImage": {
+          "$asset": "editable-preview"
+        },
+        "heroImageHint": "Select this image in Edit mode",
+        "startLabel": "Start the 5-minute tour",
+        "tourTitle": "Try the essentials in five minutes",
+        "tourIntro": "Follow these steps in order. Every change is safe to make in this tutorial project.",
+        "steps": [
+          {
+            "number": "1",
+            "title": "Edit this page",
+            "body": "Edit mode lets you change text and images directly on the website.\n- Select the big title and replace it with “Welcome, [your name]”.",
+            "actionLabel": "Activate Edit mode",
+            "action": "toggleEditMode"
+          },
+          {
+            "number": "2",
+            "title": "Open the CMS",
+            "body": "The website content also lives in the CMS, as structured data.\n- Change “Title” and watch the site update.",
+            "actionLabel": "Jump to the Home page",
+            "action": "openHomePage"
+          },
+          {
+            "number": "3",
+            "title": "Explore branches",
+            "body": "Branches let people and agents work without touching the live site.\n- Try a change on “tutorial/first-change”.",
+            "actionLabel": "Show the branch menu",
+            "action": "openBranches"
+          },
+          {
+            "number": "4",
+            "title": "Meet your agent",
+            "body": "Your agent maintains this website on a schedule.\n- Click “Run now” and review the result and cost.",
+            "actionLabel": "Meet Welcome Guide",
+            "action": "openAgents"
+          }
+        ],
+        "articlesTitle": "Continue learning in the CMS",
+        "articlesIntro": "These are real entries in the Articles collection. Open Content to edit their titles, summaries, bodies, and cover images.",
+        "migrationTitle": "Migrate my existing website",
+        "migrationBody": {
+          "type": "doc",
+          "content": [
+            {
+              "type": "paragraph",
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Open your existing local project with Codex, Claude Code, Cursor, or another coding agent. Copy the prompt below so the agent connects the website you already trust to Fimo, with a recoverable backup first."
+                }
+              ]
+            }
+          ]
+        },
+        "migrationPrompt": "Before changing anything, create a recoverable backup of this website. If it uses Git, create a branch and commit the current state. If it does not use Git, duplicate the entire project folder and confirm the copy opens. Then inspect the existing codebase and migrate this website to Fimo in place. Preserve every route, visible piece of content, media asset, form, SEO field, redirect, and locale. Connect the existing implementation to Fimo rather than generating a new empty site. Report any item you cannot migrate safely before changing it.",
+        "buildTitle": "Create my website",
+        "buildBody": {
+          "type": "doc",
+          "content": [
+            {
+              "type": "paragraph",
+              "content": [
+                {
+                  "type": "text",
+                  "text": "Use your Codex, Claude Code, Cursor, or other coding-agent subscription to design and build the first version in a local repository. Connect it to Fimo when the foundation is ready. Fimo starts where the first build ends: content, visual editing, environments, agents, and hosting."
+                }
+              ]
+            }
+          ]
+        },
+        "closingTitle": "Fimo keeps finished websites autonomous",
+        "closingBody": "Fimo Credits are designed for the agents that maintain your website and for teammates who use Studio chat without a local coding tool."
+      }
+    }
+  ],
+  "collections": [
+    {
+      "type": "Article",
+      "entries": [
+        {
+          "slug": "create-your-first-agent",
+          "data": {
+            "title": "Create your first agent",
+            "summary": "Build a weekly SEO agent with one prompt: full audit, safe fixes applied to the CMS, and a report you can trust.",
+            "body": {
+              "type": "doc",
+              "content": [
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Agents are teammates with one clear mission. In a few minutes you can build one that keeps your SEO healthy: a full audit every week, safe fixes applied for you, and a report for everything else."
+                    }
+                  ]
+                },
+                {
+                  "type": "heading",
+                  "attrs": {
+                    "level": 2
+                  },
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Start with the prompt"
+                    }
+                  ]
+                },
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Open the chat and paste this:"
+                    }
+                  ]
+                },
+                {
+                  "type": "codeBlock",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Create an agent called SEO Guardian. Every Monday morning it runs a full SEO audit of this website: page titles, meta descriptions, headings, image alt texts, internal links, and last week's analytics. It applies the safe fixes directly to the CMS content, and lists anything that needs my decision in its report. It never touches the design or the code."
+                    }
+                  ]
+                },
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Fimo builds the agent from that sentence. You will find it in the Agents workspace, right next to Welcome Guide."
+                    }
+                  ]
+                },
+                {
+                  "type": "heading",
+                  "attrs": {
+                    "level": 2
+                  },
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "What the agent is made of"
+                    }
+                  ]
+                },
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Every agent is a small bundle of three things:"
+                    }
+                  ]
+                },
+                {
+                  "type": "bulletList",
+                  "content": [
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "The goal is its soul: one clear mission written in plain words. The agent re-reads it on every run, and it is the file you edit to change how it thinks."
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "Capabilities are the strict list of what it may touch. SEO Guardian reads and writes CMS content, fetches your pages, and reads your analytics. Nothing else, unless you grant it."
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "The trigger decides when it runs: a weekly schedule here, plus Run now whenever you want."
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "type": "heading",
+                  "attrs": {
+                    "level": 2
+                  },
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Adjust it"
+                    }
+                  ]
+                },
+                {
+                  "type": "bulletList",
+                  "content": [
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "Sharpen the goal: add rules like never touch the pricing page or keep titles under 60 characters."
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "Tighten or widen the capabilities as your trust grows."
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "Change the cadence, or keep it manual while you evaluate its work."
+                            }
+                          ]
+                        }
+                      ]
+                    },
+                    {
+                      "type": "listItem",
+                      "content": [
+                        {
+                          "type": "paragraph",
+                          "content": [
+                            {
+                              "type": "text",
+                              "text": "Read every report: it lists each change, why it was made, and what the run cost."
+                            }
+                          ]
+                        }
+                      ]
+                    }
+                  ]
+                },
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Start with one manual run: open the agent, click Run now, and read what it did. That first report is the best way to understand how your new teammate thinks."
+                    }
+                  ]
+                }
+              ]
+            },
+            "cover": {
+              "$asset": "autonomous-loop"
+            }
+          }
+        },
+        {
+          "slug": "branches-and-environments",
+          "data": {
+            "title": "How branches and environments work",
+            "summary": "Branches isolate changes. Environments group related branches under shared deployment configuration.",
+            "body": {
+              "type": "doc",
+              "content": [
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Every branch has its own content, database, preview runtime, URL, and assets, so work does not affect other branches or the live website. Several teammates can collaborate on the same branch when they want to work together. Environments group branches by deployment purpose and matching rules, with shared configuration such as secrets and webhook scopes."
+                    }
+                  ]
+                }
+              ]
+            },
+            "cover": {
+              "$asset": "editable-preview"
+            }
+          }
+        },
+        {
+          "slug": "discover-the-analytics",
+          "data": {
+            "title": "Discover the analytics",
+            "summary": "See who visits your website: pageviews, top pages, sources, devices, and countries.",
+            "body": {
+              "type": "doc",
+              "content": [
+                {
+                  "type": "paragraph",
+                  "content": [
+                    {
+                      "type": "text",
+                      "text": "Open the Analytics workspace to follow visitors, pageviews, bounce rate, top pages, and where your traffic comes from. Analytics persists across publications, so your history stays intact every time you ship."
+                    }
+                  ]
+                }
+              ]
+            },
+            "cover": {
+              "$asset": "analytics-overview"
+            }
+          }
+        }
+      ]
+    }
+  ]
+}