fimo 2.2.0-staging.2 → 2.2.0-staging.4

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.
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "fimo",
-  "version": "2.2.0-staging.2",
+  "version": "2.2.0-staging.4",
   "description": "Fimo CLI - create, deploy, and manage Fimo projects",
   "keywords": [
     "astro-component"
@@ -184,12 +184,12 @@
   "devDependencies": {
     "@clack/core": "^1.2.0",
     "@clack/prompts": "^1.2.0",
-    "@fimo/agents-bundle": "2.2.0-staging.2",
-    "@fimo/api-contracts": "2.2.0-staging.2",
-    "@fimo/cli-kit": "2.2.0-staging.2",
-    "@fimo/framework-detect": "2.2.0-staging.2",
-    "@fimo/routes": "2.2.0-staging.2",
-    "@fimo/tsconfig": "2.2.0-staging.2",
+    "@fimo/agents-bundle": "2.2.0-staging.4",
+    "@fimo/api-contracts": "2.2.0-staging.4",
+    "@fimo/cli-kit": "2.2.0-staging.4",
+    "@fimo/framework-detect": "2.2.0-staging.4",
+    "@fimo/routes": "2.2.0-staging.4",
+    "@fimo/tsconfig": "2.2.0-staging.4",
     "@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.2",
-    "fimo-astro": "2.2.0-staging.2"
+    "fimo": "2.2.0-staging.4",
+    "fimo-astro": "2.2.0-staging.4"
   },
   "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,9 +12,9 @@
   },
   "dependencies": {
     "@tanstack/react-query": "^5.80.6",
-    "fimo": "2.2.0-staging.2",
-    "fimo-next": "2.2.0-staging.2",
-    "fimo-react": "2.2.0-staging.2",
+    "fimo": "2.2.0-staging.4",
+    "fimo-next": "2.2.0-staging.4",
+    "fimo-react": "2.2.0-staging.4",
     "next": "^16.3.0",
     "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.2",
-    "fimo-react": "2.2.0-staging.2",
-    "fimo-react-router": "2.2.0-staging.2",
-    "fimo-vite": "2.2.0-staging.2",
+    "fimo": "2.2.0-staging.4",
+    "fimo-react": "2.2.0-staging.4",
+    "fimo-react-router": "2.2.0-staging.4",
+    "fimo-vite": "2.2.0-staging.4",
     "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.2",
-    "fimo-sveltekit": "2.2.0-staging.2"
+    "fimo": "2.2.0-staging.4",
+    "fimo-sveltekit": "2.2.0-staging.4"
   },
   "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.2",
-    "fimo-react": "2.2.0-staging.2",
-    "fimo-react-router": "2.2.0-staging.2",
-    "fimo-vite": "2.2.0-staging.2",
+    "fimo": "2.2.0-staging.4",
+    "fimo-react": "2.2.0-staging.4",
+    "fimo-react-router": "2.2.0-staging.4",
+    "fimo-vite": "2.2.0-staging.4",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "react-router": "^8.3.0"

package/assets/starters/fimo-site/manifest.json

@@ -1,64 +0,0 @@
-{
-  "name": "fimo-site",
-  "version": 1,
-  "description": "A content-led site with a homepage, contact form, labels, and manual review agents.",
-  "singletons": [
-    {
-      "type": "HomePage",
-      "data": {
-        "eyebrow": "Field notes",
-        "title": "Your website, ready to edit.",
-        "intro": {
-          "type": "doc",
-          "content": [
-            {
-              "type": "paragraph",
-              "content": [
-                {
-                  "type": "text",
-                  "text": "This starter is real website content. Edit the copy in Studio, change the code with your favorite agent, and keep both surfaces in sync."
-                }
-              ]
-            }
-          ]
-        },
-        "primaryCtaLabel": "Read the field notes",
-        "primaryCtaHref": "#stories",
-        "featured": [
-          {
-            "label": "Start here",
-            "title": "A calmer content workflow",
-            "summary": "Keep content, code, previews, and the team in one editable project.",
-            "href": "#stories"
-          },
-          {
-            "label": "For agents",
-            "title": "Build once, keep iterating",
-            "summary": "Give your coding agent a real CMS surface to work with after the first deploy.",
-            "href": "#stories"
-          },
-          {
-            "label": "For teams",
-            "title": "Make every edit reviewable",
-            "summary": "Let teammates shape the site without asking them to open a code editor.",
-            "href": "#stories"
-          }
-        ],
-        "contactHeading": "Make something useful",
-        "contactIntro": "Tell us what you are building and we will help you find the shortest path from first draft to a site your team can own."
-      }
-    }
-  ],
-  "labels": [
-    { "key": "nav.stories", "value": "Field notes", "locale": "en" },
-    { "key": "nav.contact", "value": "Start a conversation", "locale": "en" },
-    { "key": "hero.scroll", "value": "Explore the starter", "locale": "en" },
-    { "key": "contact.name", "value": "Your name", "locale": "en" },
-    { "key": "contact.email", "value": "Email address", "locale": "en" },
-    { "key": "contact.message", "value": "What are you building?", "locale": "en" },
-    { "key": "contact.submit", "value": "Send a note", "locale": "en" },
-    { "key": "contact.sent", "value": "Thanks. Your note is on its way.", "locale": "en" },
-    { "key": "contact.failed", "value": "That did not send. Please try again.", "locale": "en" }
-  ],
-  "forms": ["contact"]
-}

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/GOAL.md

@@ -1,8 +0,0 @@
-# Content guide
-
-Inspect the site's content model and homepage copy. Suggest a small editorial
-backlog that makes the site more useful to its intended audience.
-
-Return three suggestions, each with the content type or field it touches and
-why it matters. Use the existing content as evidence. Do not write files,
-change entries, or create labels.

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/capabilities.yaml

@@ -1 +0,0 @@
-- cms:read

package/assets/starters/fimo-site/template/.fimo/agents/content-guide/config.yaml

@@ -1,9 +0,0 @@
-# Keep starter agents manual-only. Adding a schedule or webhook and pushing to
-# main registers an automation for the project.
-version: 1
-description: 'Suggest useful editorial improvements from the existing CMS content.'
-data_sources:
-  - main
-
-triggers:
-  - type: manual

package/assets/starters/fimo-site/template/.fimo/agents/site-review/GOAL.md

@@ -1,14 +0,0 @@
-# Site review
-
-Review the starter project as a teammate would before the first publish.
-
-Read the declared routes, the CMS content, the labels, and the public site.
-Return a short report with:
-
-- one thing that already feels clear;
-- the three highest-value improvements;
-- any missing content or broken route you can prove;
-- one next action that a human or coding agent can review.
-
-This is a read-only review. Do not edit files, change CMS content, create
-branches, or publish anything.

package/assets/starters/fimo-site/template/.fimo/agents/site-review/capabilities.yaml

@@ -1,3 +0,0 @@
-- cms:read
-- i18n:read
-- net:fetch

package/assets/starters/fimo-site/template/.fimo/agents/site-review/config.yaml

@@ -1,9 +0,0 @@
-# Keep starter agents manual-only. Adding a schedule or webhook and pushing to
-# main registers an automation for the project.
-version: 1
-description: 'Review the starter site and return a concise, read-only launch report.'
-data_sources:
-  - main
-
-triggers:
-  - type: manual

package/assets/starters/fimo-site/template/src/forms/contact.json

@@ -1,14 +0,0 @@
-{
-  "name": "contact",
-  "label": "Start a conversation",
-  "fields": {
-    "name": { "type": "text", "label": "Your name", "required": true },
-    "email": { "type": "email", "label": "Email address", "required": true },
-    "message": {
-      "type": "textarea",
-      "label": "What are you building?",
-      "required": true,
-      "validation": { "minLength": 10, "maxLength": 2000 }
-    }
-  }
-}

package/assets/starters/fimo-site/template/src/forms/contact.ts

@@ -1,46 +0,0 @@
-// AUTO-GENERATED ⚠️ — do not edit by hand
-// Source: src/forms/contact.json
-// The CLI replaces the placeholder form id while seeding the starter. `fimo
-// validate` regenerates this file from the JSON spec on later edits.
-
-import { z } from 'zod';
-
-export const FORM_ID = '__FIMO_FORM_ID__';
-
-export const ContactSchema = z.object({
-  name: z.string().min(1, 'Your name is required'),
-  email: z.string().min(1, 'Email address is required').email('Invalid email address'),
-  message: z.string().min(1, 'What are you building? is required').min(10).max(2000),
-});
-
-export type ContactData = z.infer<typeof ContactSchema>;
-
-// @ts-ignore - meta.env is a vite feature
-const base = import.meta.env.VITE_API_URL;
-
-export async function submitContact(data: ContactData): Promise<{
-  success: boolean;
-  errors?: Record<string, string>;
-}> {
-  let response: Response;
-  try {
-    response = await fetch(`${base}/forms/${FORM_ID}/submit`, {
-      method: 'POST',
-      headers: { 'Content-Type': 'application/json' },
-      body: JSON.stringify(data),
-    });
-  } catch {
-    return { success: false };
-  }
-
-  if (response.ok) {
-    return { success: true };
-  }
-
-  if (response.status === 422) {
-    const json = (await response.json()) as { errors?: Record<string, string> };
-    return { success: false, errors: json.errors };
-  }
-
-  return { success: false };
-}

package/assets/starters/fimo-site/template/src/pages/Contact.tsx

@@ -1,193 +0,0 @@
-import { type FimoString, Text, useLabels } from 'fimo-react';
-import { ArrowUpRight, Check } from 'lucide-react';
-import { type FormEvent, type ReactNode, useState } from 'react';
-
-import { Button } from '@/components/ui/button';
-import { Input } from '@/components/ui/input';
-import { Label } from '@/components/ui/label';
-import { Spinner } from '@/components/ui/spinner';
-import { Textarea } from '@/components/ui/textarea';
-import { ContactSchema, submitContact } from '@/forms/contact';
-import { cn } from '@/lib/utils';
-import type { HomePage } from '@/schemas/HomePage';
-
-import { Bar } from './SiteContent';
-
-export function Contact({ page, loading }: { page?: HomePage; loading: boolean }) {
-  return (
-    <section id="contact" className="dark bg-background text-foreground scroll-mt-16">
-      <div className="mx-auto grid w-full max-w-6xl gap-12 px-6 py-20 lg:grid-cols-12 lg:gap-16 lg:px-10 lg:py-28">
-        <div className="lg:col-span-5">
-          {page ? (
-            <>
-              <Text
-                value={page.contactHeading}
-                as="h2"
-                className="text-4xl font-semibold tracking-[-0.03em] text-balance lg:text-5xl"
-              />
-              <Text value={page.contactIntro} as="p" className="text-muted-foreground mt-6 max-w-md leading-relaxed" />
-            </>
-          ) : (
-            <div aria-hidden>
-              <div className="grid gap-3">
-                <Bar loading={loading} className="h-10 w-4/5" />
-                <Bar loading={loading} className="h-10 w-2/5" />
-              </div>
-              <div className="mt-8 grid gap-2">
-                <Bar loading={loading} className="h-4 w-full max-w-md" />
-                <Bar loading={loading} className="h-4 w-11/12 max-w-md" />
-                <Bar loading={loading} className="h-4 w-2/3 max-w-md" />
-              </div>
-            </div>
-          )}
-        </div>
-
-        <div className="lg:col-span-7">
-          <ContactForm />
-        </div>
-      </div>
-    </section>
-  );
-}
-
-type SubmitState = 'idle' | 'submitting' | 'sent' | 'invalid' | 'failed';
-
-function ContactForm() {
-  const { t } = useLabels();
-  const [state, setState] = useState<SubmitState>('idle');
-  const [errors, setErrors] = useState<Record<string, string>>({});
-
-  const handleSubmit = async (event: FormEvent<HTMLFormElement>) => {
-    event.preventDefault();
-    // `currentTarget` is cleared once the handler yields, so keep the node.
-    const form = event.currentTarget;
-    setErrors({});
-
-    const parsed = ContactSchema.safeParse(Object.fromEntries(new FormData(form)));
-    if (!parsed.success) {
-      const fieldErrors: Record<string, string> = {};
-      for (const issue of parsed.error.issues) {
-        fieldErrors[issue.path[0] as string] = issue.message;
-      }
-      setErrors(fieldErrors);
-      setState('invalid');
-      return;
-    }
-
-    setState('submitting');
-    const result = await submitContact(parsed.data);
-    if (result.success) {
-      form.reset();
-      setState('sent');
-      return;
-    }
-
-    // A rejected submission comes back with per-field messages; a network or
-    // server failure has nothing to attach to a field, so it needs its own.
-    const fieldErrors = result.errors ?? {};
-    setErrors(fieldErrors);
-    setState(Object.keys(fieldErrors).length > 0 ? 'invalid' : 'failed');
-  };
-
-  const busy = state === 'submitting';
-  const sent = state === 'sent';
-
-  return (
-    <form
-      onSubmit={handleSubmit}
-      noValidate
-      aria-busy={busy}
-      className="border-border bg-card rounded-xl border p-6 sm:p-8"
-    >
-      <div className="grid gap-6 sm:grid-cols-2">
-        <FormField id="contact-name" label={t('contact.name')} error={errors.name}>
-          <Input
-            id="contact-name"
-            name="name"
-            type="text"
-            autoComplete="name"
-            disabled={busy || sent}
-            aria-invalid={Boolean(errors.name)}
-            aria-describedby={errors.name ? 'contact-name-error' : undefined}
-          />
-        </FormField>
-
-        <FormField id="contact-email" label={t('contact.email')} error={errors.email}>
-          <Input
-            id="contact-email"
-            name="email"
-            type="email"
-            autoComplete="email"
-            disabled={busy || sent}
-            aria-invalid={Boolean(errors.email)}
-            aria-describedby={errors.email ? 'contact-email-error' : undefined}
-          />
-        </FormField>
-
-        <div className="sm:col-span-2">
-          <FormField id="contact-message" label={t('contact.message')} error={errors.message}>
-            <Textarea
-              id="contact-message"
-              name="message"
-              rows={5}
-              disabled={busy || sent}
-              aria-invalid={Boolean(errors.message)}
-              aria-describedby={errors.message ? 'contact-message-error' : undefined}
-            />
-          </FormField>
-        </div>
-      </div>
-
-      <div className="mt-8 flex flex-wrap items-center gap-x-4 gap-y-3">
-        <Button
-          type="submit"
-          size="lg"
-          disabled={busy || sent}
-          className={cn('group', state === 'invalid' && 'ring-destructive/40 ring-[3px]')}
-        >
-          {busy ? <Spinner /> : null}
-          {sent ? <Check /> : null}
-          <Text value={t('contact.submit')} />
-          {!busy && !sent ? (
-            <ArrowUpRight className="transition-transform group-hover:translate-x-0.5 group-hover:-translate-y-0.5" />
-          ) : null}
-        </Button>
-
-        {/* Both regions stay mounted and empty: a live region inserted at the same
-            moment as its text is announced unreliably. */}
-        <p role="status" className="text-muted-foreground text-sm">
-          {sent ? <Text value={t('contact.sent')} /> : null}
-        </p>
-        <p role="alert" className="text-destructive text-sm">
-          {state === 'failed' ? <Text value={t('contact.failed')} /> : null}
-        </p>
-      </div>
-    </form>
-  );
-}
-
-function FormField({
-  id,
-  label,
-  error,
-  children,
-}: {
-  id: string;
-  label: FimoString;
-  error?: string;
-  children: ReactNode;
-}) {
-  return (
-    <div className="grid gap-2">
-      <Label htmlFor={id} className="text-muted-foreground text-[11px] font-medium tracking-[0.16em] uppercase">
-        <Text value={label} />
-      </Label>
-      {children}
-      {error ? (
-        <p id={`${id}-error`} role="alert" className="text-destructive text-xs">
-          {error}
-        </p>
-      ) : null}
-    </div>
-  );
-}

package/assets/starters/fimo-site/template/src/pages/Index.tsx

@@ -1,27 +0,0 @@
-import HomePageContent from '@/schemas/HomePage';
-
-import { Contact } from './Contact';
-import { ContentFallback, Hero, SiteHeader, Stories } from './SiteContent';
-
-const Index = () => {
-  const { data: page, isLoading } = HomePageContent.useGet();
-
-  return (
-    <div className="bg-background text-foreground min-h-screen">
-      <SiteHeader />
-      <main>
-        {page ? (
-          <>
-            <Hero page={page} />
-            <Stories items={page.featured ?? []} />
-          </>
-        ) : (
-          <ContentFallback loading={isLoading} />
-        )}
-        <Contact page={page} loading={isLoading} />
-      </main>
-    </div>
-  );
-};
-
-export default Index;