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.
@@ -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, default export, and re-exported public types.
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, dashboard SEO/domain settings,
9
- visual editing, version history UI, dashboard sharing/billing,
10
- dashboard chat. Never describe UI locations, buttons, or panels from
11
- memory — always read the relevant reference file first.
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 is built around two ideas:
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** are the structure or template for a type of content. Think of a collection as a blueprint. For example, a "Blog Post" collection defines that every blog post has a title, body, author, and cover image.
6
- - **Entries** are the actual pieces of content. Each individual blog post is an entry inside the Blog Post collection.
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
- If your site has a blog, a team page, and a FAQ, you would have three collections. Each one holds its own entries.
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. The left sidebar shows three sub-tabs: **Collections**, **Forms**, and **Labels & Text**.
14
- 3. Collection cards display the collection name and how many entries it has.
15
- 4. Click a collection to see a table of all its entries.
16
- 5. Click any entry to open it for editing.
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 collection, the entry list provides several tools:
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 collection you want to add content to.
30
- 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.
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 collection. If the collection is wired to a page on your site, the new content shows up automatically.
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 new content type** (for example, "Create a Testimonials collection with name, quote, and photo fields").
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
- - **Content appears automatically** if the collection is connected (wired) to a page on your site. You do not need to manually link each entry.
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.
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-07-21T11:42:21.521Z",
4
+ "bundledAt": "2026-07-22T13:43:06.930Z",
5
5
  "cliVersion": "0.7.0",
6
6
  "external": [
7
7
  "oxc-parser",