fimo 2.2.0-staging.10 → 2.2.0-staging.12

package/templates/welcome/template/src/pages/fallback-content.ts

@@ -0,0 +1,133 @@
+import type { Article } from '@/schemas/Article';
+import type { HomePage } from '@/schemas/HomePage';
+
+// Generated from the starter seed (../../manifest.json): the loading
+// fallback renders the real TutorialPage with this data so the live CMS
+// values swap in without any visible change. Regenerate when the seed
+// copy changes — a drifted fallback flashes different text on load.
+// Rich-text values carry { content: <tiptap doc> } like FimoRichText;
+// the missing source symbol simply disables inline editing until the
+// live values arrive.
+
+export const FALLBACK_PAGE = {
+  title: 'This site is yours to change.',
+  intro: {
+    content: {
+      type: 'doc',
+      content: [
+        {
+          type: 'paragraph',
+          content: [
+            {
+              type: 'text',
+              text: 'Four actions, five minutes. Every change is safe to make in this tutorial project.',
+            },
+          ],
+        },
+      ],
+    },
+  },
+  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: [
+    {
+      _key: 'fallback-step-1',
+      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',
+    },
+    {
+      _key: 'fallback-step-2',
+      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',
+    },
+    {
+      _key: 'fallback-step-3',
+      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',
+    },
+    {
+      _key: 'fallback-step-4',
+      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: {
+    content: {
+      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: {
+    content: {
+      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.',
+} as unknown as HomePage;
+
+// Covers are omitted: the card's image box keeps its own aspect ratio, so
+// the live images arrive without shifting the layout.
+export const FALLBACK_ARTICLES = [
+  {
+    id: 'fallback-article-1',
+    slug: 'create-your-first-agent',
+    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.',
+  },
+  {
+    id: 'fallback-article-2',
+    slug: 'branches-and-environments',
+    title: 'How branches and environments work',
+    summary: 'Branches isolate changes. Environments group related branches under shared deployment configuration.',
+  },
+  {
+    id: 'fallback-article-3',
+    slug: 'discover-the-analytics',
+    title: 'Discover the analytics',
+    summary: 'See who visits your website: pageviews, top pages, sources, devices, and countries.',
+  },
+] as unknown as Article[];

package/templates/welcome/template/src/routes.ts

@@ -0,0 +1,9 @@
+import type { RouteConfig } from '@react-router/dev/routes';
+import { layout, route } from '@react-router/dev/routes';
+
+export default [
+  layout('./pages/LocaleLayout.tsx', [
+    route(':locale?', './pages/Index.tsx', { id: 'home' }),
+    route(':locale?/articles/:slug', './pages/ArticleDetail.tsx', { id: 'article' }),
+  ]),
+] satisfies RouteConfig;

package/templates/welcome/template/src/schemas/Article.json

@@ -0,0 +1,12 @@
+{
+  "uid": "Article",
+  "name": "Articles",
+  "isSingleton": false,
+  "i18n": { "enabled": false },
+  "fields": {
+    "title": { "type": "string", "required": true },
+    "summary": { "type": "text", "required": true },
+    "body": { "type": "richtext", "required": true },
+    "cover": { "type": "media", "required": true }
+  }
+}

package/templates/welcome/template/src/schemas/Article.ts

@@ -0,0 +1,59 @@
+// AUTO-GENERATED by `fimo` from src/schemas/Article.json - DO NOT EDIT.
+// Change content fields in the schema, then run `fimo validate`.
+// Runtime implementation lives in the project-local fimo-react package.
+import { createContentClient } from 'fimo-react';
+import type { CollectionContentClient } from 'fimo-react';
+import type { ContentSchema } from 'fimo-react';
+
+import schema from './Article.json';
+import type { Article, ArticleFields, ArticleInput, ArticlePopulate, ArticleQuery } from './Article.types';
+
+export type {
+  Article,
+  ArticleFields,
+  ArticleFimoMeta,
+  ArticleInput,
+  ArticlePopulate,
+  ArticleQuery,
+  ArticleReferences,
+  ArticleResult,
+  ArticleSort,
+  ArticleWhere,
+} from './Article.types';
+export type { CollectionPage, CollectionPageInfo, InfiniteListResult } from 'fimo-react';
+export type InfiniteListQuery<
+  TFields extends ArticleFields | undefined = undefined,
+  TPopulate extends ArticlePopulate | undefined = undefined,
+> = Omit<ArticleQuery<TFields, TPopulate>, 'offset'>;
+
+const client: CollectionContentClient<Article, ArticleInput> = createContentClient<Article, ArticleInput>({
+  schema: schema as unknown as ContentSchema,
+});
+
+export const {
+  wrapWithSource,
+  meta,
+  getById,
+  getBySlug,
+  getByField,
+  list,
+  get,
+  create,
+  update,
+  remove,
+  useGetById,
+  useGetBySlug,
+  useGetByField,
+  useList,
+  useInfiniteList,
+  useGet,
+  useSuspenseGetById,
+  useSuspenseGet,
+  useSuspenseGetByField,
+  useSuspenseGetBySlug,
+  useCreate,
+  useUpdate,
+  useRemove,
+} = client;
+
+export default client;

package/templates/welcome/template/src/schemas/Article.types.ts

@@ -0,0 +1,73 @@
+// AUTO-GENERATED ⚠️ – do not edit by hand
+import {
+  type Fields,
+  type FimoBoolean,
+  type FimoMedia,
+  type FimoPolymorphicReference,
+  type FimoReference,
+  type FimoRichText,
+  type FimoRichTextContent,
+  type FimoString,
+  type Populate,
+  type PopulatedResult,
+  type ProjectedWithPopulate,
+  type Query,
+  type Sort,
+  type Where,
+  type WithReferences,
+} from 'fimo-react';
+
+/*───────────────────────────────────────────────────────────────*/
+/*  ────────────  📄  Type definitions  ────────────             */
+/*───────────────────────────────────────────────────────────────*/
+
+/**
+ * Article entity interface
+ */
+export interface ArticleFimoMeta {
+  contentType: 'Article';
+}
+
+export interface Article extends WithReferences<ArticleReferences> {
+  id: string;
+  entryId: string;
+  documentId: string;
+  slug: FimoString;
+  locale: string;
+  createdAt: string;
+  updatedAt: string;
+  __fimo: ArticleFimoMeta;
+  title: FimoString;
+  summary: FimoString;
+  body: FimoRichText;
+  cover: FimoMedia;
+}
+
+export interface ArticleInput {
+  slug?: string;
+  documentId?: string;
+  title: string;
+  summary: string;
+  body: FimoRichTextContent;
+  cover: Pick<FimoMedia, 'url' | 'alt' | 'name' | 'mime' | 'width' | 'height'>;
+}
+
+export type ArticleReferences = Record<never, never>;
+
+export type ArticlePopulate = Populate<Article>;
+
+/*───────────────────────────────────────────────────────────────*/
+/*  ────────────  🔎  Query types  ────────────                  */
+/*───────────────────────────────────────────────────────────────*/
+
+export type ArticleWhere = Where<Article>;
+export type ArticleSort = Sort<Article>;
+export type ArticleFields = Fields<Article>;
+export type ArticleQuery<
+  TFields extends ArticleFields | undefined = ArticleFields | undefined,
+  TPopulate extends ArticlePopulate | undefined = ArticlePopulate | undefined,
+> = Query<Article, TFields, TPopulate>;
+export type ArticleResult<
+  TFields extends ArticleFields | undefined = undefined,
+  TPopulate extends ArticlePopulate | undefined = undefined,
+> = ProjectedWithPopulate<PopulatedResult<Article, TPopulate>, TFields, TPopulate>;

package/templates/welcome/template/src/schemas/HomePage.json

@@ -0,0 +1,39 @@
+{
+  "uid": "HomePage",
+  "name": "Home page",
+  "isSingleton": true,
+  "i18n": { "enabled": false },
+  "fields": {
+    "title": { "type": "string", "required": true },
+    "intro": { "type": "richtext", "required": true },
+    "heroImage": { "type": "media", "required": true },
+    "heroImageHint": { "type": "string", "required": true },
+    "startLabel": { "type": "string", "required": true },
+    "tourTitle": { "type": "string", "required": true },
+    "tourIntro": { "type": "text", "required": true },
+    "steps": {
+      "type": "blocks",
+      "min": 4,
+      "max": 4,
+      "schema": {
+        "fields": {
+          "number": { "type": "string", "required": true },
+          "title": { "type": "string", "required": true },
+          "body": { "type": "text", "required": true },
+          "highlight": { "type": "text" },
+          "actionLabel": { "type": "string", "required": true },
+          "action": { "type": "string", "required": true }
+        }
+      }
+    },
+    "articlesTitle": { "type": "string", "required": true },
+    "articlesIntro": { "type": "text", "required": true },
+    "migrationTitle": { "type": "string", "required": true },
+    "migrationBody": { "type": "richtext", "required": true },
+    "migrationPrompt": { "type": "text", "required": true },
+    "buildTitle": { "type": "string", "required": true },
+    "buildBody": { "type": "richtext", "required": true },
+    "closingTitle": { "type": "string", "required": true },
+    "closingBody": { "type": "text", "required": true }
+  }
+}

package/templates/welcome/template/src/schemas/HomePage.types.ts

@@ -0,0 +1,114 @@
+// AUTO-GENERATED ⚠️ – do not edit by hand
+import {
+  type Fields,
+  type FimoBoolean,
+  type FimoMedia,
+  type FimoPolymorphicReference,
+  type FimoReference,
+  type FimoRichText,
+  type FimoRichTextContent,
+  type FimoString,
+  type Populate,
+  type PopulatedResult,
+  type ProjectedWithPopulate,
+  type Query,
+  type Sort,
+  type Where,
+  type WithReferences,
+} from 'fimo-react';
+
+/*───────────────────────────────────────────────────────────────*/
+/*  ────────────  📄  Type definitions  ────────────             */
+/*───────────────────────────────────────────────────────────────*/
+
+/**
+ * HomePage entity interface
+ */
+export interface HomePageFimoMeta {
+  contentType: 'HomePage';
+}
+
+export interface HomePage extends WithReferences<HomePageReferences> {
+  id: string;
+  entryId: string;
+  documentId: string;
+  slug: FimoString;
+  locale?: string;
+  createdAt: string;
+  updatedAt: string;
+  __fimo: HomePageFimoMeta;
+  title: FimoString;
+  intro: FimoRichText;
+  heroImage: FimoMedia;
+  heroImageHint: FimoString;
+  startLabel: FimoString;
+  tourTitle: FimoString;
+  tourIntro: FimoString;
+  steps: {
+    _key: string;
+    number: FimoString;
+    title: FimoString;
+    body: FimoString;
+    highlight?: FimoString;
+    actionLabel: FimoString;
+    action: FimoString;
+  }[];
+  articlesTitle: FimoString;
+  articlesIntro: FimoString;
+  migrationTitle: FimoString;
+  migrationBody: FimoRichText;
+  migrationPrompt: FimoString;
+  buildTitle: FimoString;
+  buildBody: FimoRichText;
+  closingTitle: FimoString;
+  closingBody: FimoString;
+}
+
+export interface HomePageInput {
+  slug?: string;
+  title: string;
+  intro: FimoRichTextContent;
+  heroImage: Pick<FimoMedia, 'url' | 'alt' | 'name' | 'mime' | 'width' | 'height'>;
+  heroImageHint: string;
+  startLabel: string;
+  tourTitle: string;
+  tourIntro: string;
+  steps: {
+    _key?: string;
+    number: string;
+    title: string;
+    body: string;
+    highlight?: string;
+    actionLabel: string;
+    action: string;
+  }[];
+  articlesTitle: string;
+  articlesIntro: string;
+  migrationTitle: string;
+  migrationBody: FimoRichTextContent;
+  migrationPrompt: string;
+  buildTitle: string;
+  buildBody: FimoRichTextContent;
+  closingTitle: string;
+  closingBody: string;
+}
+
+export type HomePageReferences = Record<never, never>;
+
+export type HomePagePopulate = Populate<HomePage>;
+
+/*───────────────────────────────────────────────────────────────*/
+/*  ────────────  🔎  Query types  ────────────                  */
+/*───────────────────────────────────────────────────────────────*/
+
+export type HomePageWhere = Where<HomePage>;
+export type HomePageSort = Sort<HomePage>;
+export type HomePageFields = Fields<HomePage>;
+export type HomePageQuery<
+  TFields extends HomePageFields | undefined = HomePageFields | undefined,
+  TPopulate extends HomePagePopulate | undefined = HomePagePopulate | undefined,
+> = Query<HomePage, TFields, TPopulate>;
+export type HomePageResult<
+  TFields extends HomePageFields | undefined = undefined,
+  TPopulate extends HomePagePopulate | undefined = undefined,
+> = ProjectedWithPopulate<PopulatedResult<HomePage, TPopulate>, TFields, TPopulate>;