fimo 0.7.0 → 0.8.0-staging.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/assets/agent-templates/seo-audit/GOAL.md +7 -3
- package/assets/content-templates/hooks-template.eta +42 -605
- package/assets/skills/fimo/references/content.md +1 -1
- package/assets/skills/fimo-studio/SKILL.md +5 -4
- package/assets/skills/fimo-studio/references/cms.md +30 -14
- package/dist/cli/bundle.json +1 -1
- package/dist/cli/index.js +106 -100
- package/dist/scripts/sync-schemas.js +148 -62
- package/package.json +1 -1
- package/release.json +2 -2
- package/templates/react-router/package.json +1 -1
|
@@ -183,7 +183,7 @@ For `media` fields, prefer `source: "local"` with assets uploaded via `fimo asse
|
|
|
183
183
|
After pre-build (or `fimo deploy`), each schema generates two files:
|
|
184
184
|
|
|
185
185
|
- `src/schemas/{Uid}.types.ts` — pure TypeScript types such as `BlogPost`, `BlogPostInput`, `BlogPostQuery`, and `BlogPostResult`.
|
|
186
|
-
- `src/schemas/{Uid}.ts` — runtime helpers, React Query hooks,
|
|
186
|
+
- `src/schemas/{Uid}.ts` — exposes runtime helpers, React Query hooks, and public types.
|
|
187
187
|
|
|
188
188
|
Import from the public schema module, e.g. `import BlogPost from '@/schemas/BlogPost'` and `import type { BlogPostResult } from '@/schemas/BlogPost'`. Do not import from `.types.ts` directly in app code. There is no generated `src/schemas/index.ts` barrel.
|
|
189
189
|
|
|
@@ -5,10 +5,11 @@ description: >-
|
|
|
5
5
|
Fimo Studio / the dashboard UI — never for CLI commands or code work.
|
|
6
6
|
Triggers: "in Fimo Studio", "in the dashboard", "in the web app",
|
|
7
7
|
"how do I X in the UI", or screenshots of the dashboard. Topics
|
|
8
|
-
covered: publishing from the dashboard,
|
|
9
|
-
visual editing, version history UI,
|
|
10
|
-
dashboard chat. Never describe UI
|
|
11
|
-
memory — always read the relevant
|
|
8
|
+
covered: dashboard content and CMS, publishing from the dashboard,
|
|
9
|
+
dashboard SEO/domain settings, visual editing, version history UI,
|
|
10
|
+
dashboard sharing/billing, and dashboard chat. Never describe UI
|
|
11
|
+
locations, buttons, or panels from memory — always read the relevant
|
|
12
|
+
reference file first.
|
|
12
13
|
---
|
|
13
14
|
|
|
14
15
|
# Fimo Studio
|
|
@@ -1,23 +1,35 @@
|
|
|
1
1
|
## How the CMS Works
|
|
2
2
|
|
|
3
|
-
The CMS is where you manage your site's content. It
|
|
3
|
+
The CMS is where you manage your site's structured content. It separates content by how many documents each schema holds:
|
|
4
4
|
|
|
5
|
-
- **Collections**
|
|
6
|
-
- **
|
|
5
|
+
- **Collections** hold multiple entries of the same kind, such as Blog posts, Team members, or Testimonials.
|
|
6
|
+
- **Singles** hold one document, such as Site settings, a Homepage, or an About page.
|
|
7
|
+
- **Entries** are the individual documents inside a collection.
|
|
7
8
|
|
|
8
|
-
|
|
9
|
+
Both use schemas to define their fields. The difference is whether you edit one document or manage a repeatable list.
|
|
9
10
|
|
|
10
11
|
## Browsing Your Content
|
|
11
12
|
|
|
12
13
|
1. Click the **Content tab** (the database icon) in the top navigation bar.
|
|
13
|
-
2.
|
|
14
|
-
3.
|
|
15
|
-
4.
|
|
16
|
-
5. Click
|
|
14
|
+
2. Choose **Collections** or **Singles** in the left sidebar. **Forms** and **Labels & Text** follow them in the same list.
|
|
15
|
+
3. Hover over or focus the info icon beside any item for a short explanation.
|
|
16
|
+
4. Each destination shows cards for the schemas in that group.
|
|
17
|
+
5. Click a Collection to see its entries, then click an entry to edit it.
|
|
18
|
+
6. Click a Single to open its one document directly.
|
|
19
|
+
|
|
20
|
+
Collection cards show their entry count. Single cards are labeled **Single** instead because they always represent one document.
|
|
21
|
+
|
|
22
|
+
## Editing a Single
|
|
23
|
+
|
|
24
|
+
1. Open **Content → Singles**.
|
|
25
|
+
2. Select the Single you want, such as Site settings.
|
|
26
|
+
3. Update its fields.
|
|
27
|
+
|
|
28
|
+
Changes save automatically. A Single has no entry list, create action, bulk actions, or delete action because it always represents the same document.
|
|
17
29
|
|
|
18
30
|
## Navigating the Entry List
|
|
19
31
|
|
|
20
|
-
When you open a
|
|
32
|
+
When you open a Collection, the entry list provides several tools:
|
|
21
33
|
|
|
22
34
|
- **Search bar** at the top to filter entries by text content.
|
|
23
35
|
- **Sort** via the sort dropdown button next to the search bar: sort by Creation date, Update date, or Slug, and toggle between Ascending and Descending. Clicking column headers does not sort.
|
|
@@ -26,11 +38,11 @@ When you open a collection, the entry list provides several tools:
|
|
|
26
38
|
|
|
27
39
|
## Creating a New Entry
|
|
28
40
|
|
|
29
|
-
1. Navigate to the
|
|
30
|
-
2. Click the **+** (plus) icon button at the top of the
|
|
41
|
+
1. Navigate to the Collection you want to add content to.
|
|
42
|
+
2. Click the **+** (plus) icon button at the top of the Collection (labeled **New entry** on hover). If the Collection is empty, use the **Create entry** button in the center of the empty state instead.
|
|
31
43
|
3. Fill in the form fields (text, images, dates, whatever the collection defines).
|
|
32
44
|
|
|
33
|
-
Changes save automatically as you fill in each field (the save is debounced), so there is no Save button. The save status appears in the top bar (Saving / Saved). The entry is now part of your
|
|
45
|
+
Changes save automatically as you fill in each field (the save is debounced), so there is no Save button. The save status appears in the top bar (Saving / Saved). The entry is now part of your Collection. If the Collection is wired to a page on your site, the new content shows up automatically.
|
|
34
46
|
|
|
35
47
|
## Editing an Entry
|
|
36
48
|
|
|
@@ -49,18 +61,22 @@ Need to update or remove several entries at once?
|
|
|
49
61
|
4. For bulk edit, you select which field to update, then provide the new value for all selected entries.
|
|
50
62
|
5. Confirm in the dialog that appears.
|
|
51
63
|
|
|
64
|
+
Bulk operations are available for Collections, not Singles.
|
|
65
|
+
|
|
52
66
|
## Working with AI
|
|
53
67
|
|
|
54
68
|
The AI chat can help you manage content without navigating through menus:
|
|
55
69
|
|
|
56
|
-
- Ask the AI to **create a
|
|
70
|
+
- Ask the AI to **create a Single or Collection** (for example, "Create a Site settings Single" or "Create a Testimonials Collection with name, quote, and photo fields").
|
|
57
71
|
- Ask it to **populate entries** (for example, "Add 5 sample blog posts about web design").
|
|
58
72
|
- Use **@** in the chat to reference specific content when discussing changes.
|
|
59
73
|
- Ask the AI to **wire content to a page** so entries display on your site automatically.
|
|
60
74
|
|
|
61
75
|
## Key Concepts
|
|
62
76
|
|
|
63
|
-
- **
|
|
77
|
+
- **Collections** are best for repeatable content. Open one to search, sort, create, and manage its entries.
|
|
78
|
+
- **Singles** are best for one-off documents. Open one and edit it directly.
|
|
79
|
+
- **Content appears automatically** if its schema is connected (wired) to a page on your site. You do not need to manually link each entry.
|
|
64
80
|
- **Forms tab**: View and manage form submissions collected from your site's forms.
|
|
65
81
|
- **Labels & Text tab**: Edit your site's UI labels and static text strings as key-and-value rows. This is for your site's interface copy, not for translated copies of collection entries.
|
|
66
82
|
- **Search and sort**: Use the search bar to filter entries and the sort dropdown to order them quickly.
|