fimo 2.2.0-staging.10 → 2.2.0-staging.11

package/dist/runtime/templates.d.ts

@@ -12,6 +12,7 @@ export declare const DEFAULT_TEMPLATE: TemplateFramework;
  * out of `dist`) to reach the package root, then into `templates/<framework>`.
  */
 export declare function getTemplatePath(framework?: TemplateFramework): string;
+export declare function getWelcomeTemplatePath(): string;
 /**
  * Absolute path to the legacy template at `apps/api/templates/default/`.
  *

package/dist/runtime/templates.js

@@ -42,6 +42,9 @@ export const DEFAULT_TEMPLATE = 'nextjs';
 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/`.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.2.0-staging.10",
+  "version": "2.2.0-staging.11",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -176,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"
   },
@@ -188,12 +189,12 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.2.0-staging.10",
-    "@fimo/api-contracts": "2.2.0-staging.10",
-    "@fimo/cli-kit": "2.2.0-staging.10",
-    "@fimo/framework-detect": "2.2.0-staging.10",
-    "@fimo/routes": "2.2.0-staging.10",
-    "@fimo/tsconfig": "2.2.0-staging.10",
+    "@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",

package/templates/astro/package.json

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

package/templates/nextjs/package.json

@@ -12,9 +12,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.10",
-    "fimo-next": "2.2.0-staging.10",
-    "fimo-react": "2.2.0-staging.10",
+    "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/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.10",
-    "fimo-react": "2.2.0-staging.10",
-    "fimo-react-router": "2.2.0-staging.10",
-    "fimo-vite": "2.2.0-staging.10",
+    "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.10",
-    "fimo-sveltekit": "2.2.0-staging.10"
+    "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.10",
-    "fimo-react": "2.2.0-staging.10",
-    "fimo-react-router": "2.2.0-staging.10",
-    "fimo-vite": "2.2.0-staging.10",
+    "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"
+            }
+          }
+        }
+      ]
+    }
+  ]
+}

package/templates/welcome/template/.fimo/agents/welcome-guide/GOAL.md

@@ -0,0 +1,7 @@
+# Welcome pulse
+
+Return exactly this sentence and do nothing else:
+
+Your Fimo workspace is ready. Edit the highlighted title in Preview, then explore the Media Library.
+
+Do not inspect files, run commands, call tools, edit content, or publish anything.

package/templates/welcome/template/.fimo/agents/welcome-guide/config.yaml

@@ -0,0 +1,8 @@
+version: 1
+description: 'Send one tiny onboarding pulse so you can see a scheduled agent run.'
+
+triggers:
+  - type: manual
+  - type: schedule
+    cron: '*/2 * * * *'
+    tz: 'UTC'

package/templates/welcome/template/.fimo/config.json

@@ -0,0 +1,53 @@
+{
+  "runtime": { "framework": "react-router" },
+  "seo": {
+    "title": "Welcome to Fimo",
+    "description": "Learn how to edit content, manage media, migrate a website, and run autonomous agents with Fimo.",
+    "siteName": "Welcome to Fimo",
+    "url": "https://fimo.ai/",
+    "image": "https://fimo.ai/socials/og_cover.png",
+    "favicon": "https://fimo.ai/favicon-orange.svg",
+    "locale": "en_US"
+  },
+  "i18n": {
+    "defaultLocale": "en",
+    "locales": ["en"],
+    "routing": {
+      "strategy": "path-prefix",
+      "prefixDefaultLocale": false
+    }
+  },
+  "routes": {
+    "home": {
+      "label": "Welcome",
+      "path": "/:locale",
+      "params": { "locale": { "type": "locale", "optional": true } },
+      "seo": {
+        "title": "Welcome to Fimo",
+        "description": "Your editable Fimo tutorial project."
+      }
+    },
+    "article": {
+      "label": "Article",
+      "path": "/:locale/articles/:slug",
+      "params": {
+        "locale": { "type": "locale", "optional": true },
+        "slug": {
+          "schema": "Article",
+          "queryField": "slug"
+        }
+      },
+      "seo": {
+        "title": "Fimo tutorial article",
+        "description": "Learn how to make your website autonomous with Fimo."
+      }
+    }
+  },
+  "agents": {
+    "notifications": {
+      "email_recipients": []
+    }
+  },
+  "version": "4",
+  "source": "cli"
+}

package/templates/welcome/template/src/font.css

@@ -0,0 +1,60 @@
+@import url('https://fonts.googleapis.com/css2?family=Manrope:wght@400;500;600;700;800&family=Geist+Mono:wght@400;500&display=swap');
+
+.fimo-starter-font {
+  font-family:
+    'Manrope',
+    ui-sans-serif,
+    system-ui,
+    -apple-system,
+    BlinkMacSystemFont,
+    'Segoe UI',
+    sans-serif;
+}
+
+.fimo-mono {
+  font-family: 'Geist Mono', ui-monospace, 'SF Mono', Menlo, monospace;
+  letter-spacing: 0.08em;
+}
+
+@keyframes fimo-icon-loop {
+  0%,
+  100% {
+    transform: translate(0, 0) rotate(0deg);
+  }
+  25% {
+    transform: translate(2px, -2px) rotate(6deg);
+  }
+  50% {
+    transform: translate(0, 1px) rotate(0deg);
+  }
+  75% {
+    transform: translate(-2px, -1px) rotate(-6deg);
+  }
+}
+
+.step-cell:hover .step-icon {
+  animation: fimo-icon-loop 1.1s ease-in-out 2;
+}
+
+@keyframes fimo-dot-blink {
+  0%,
+  80%,
+  100% {
+    opacity: 0.25;
+  }
+  40% {
+    opacity: 1;
+  }
+}
+
+.fimo-dots span {
+  animation: fimo-dot-blink 1.2s infinite;
+}
+
+.fimo-dots span:nth-child(2) {
+  animation-delay: 0.2s;
+}
+
+.fimo-dots span:nth-child(3) {
+  animation-delay: 0.4s;
+}