fimo 2.8.0-staging.5 → 2.8.0-staging.7

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.
Files changed (49) hide show
  1. package/README.md +3 -3
  2. package/assets/skills/fimo/SKILL.md +3 -3
  3. package/assets/skills/fimo-cli/SKILL.md +9 -10
  4. package/assets/skills/fimo-cli/references/agents.md +9 -8
  5. package/assets/skills/fimo-cli/references/branches.md +1 -1
  6. package/assets/skills/fimo-cli/references/credits.md +2 -2
  7. package/assets/skills/fimo-cli/references/deploy.md +1 -1
  8. package/assets/skills/fimo-cli/references/describe.md +2 -2
  9. package/assets/skills/fimo-cli/references/init.md +7 -7
  10. package/assets/skills/fimo-cli/references/integrations.md +2 -2
  11. package/assets/skills/fimo-cli/references/invite.md +1 -1
  12. package/assets/skills/fimo-cli/references/locales.md +1 -1
  13. package/assets/skills/fimo-cli/references/mcp.md +1 -1
  14. package/assets/skills/fimo-cli/references/project-vars-and-secrets.md +1 -1
  15. package/assets/skills/fimo-cli/references/projects.md +3 -3
  16. package/assets/skills/fimo-cli/references/schedules.md +1 -1
  17. package/assets/skills/fimo-cli/references/support.md +1 -1
  18. package/assets/skills/fimo-studio/SKILL.md +8 -8
  19. package/assets/skills/fimo-studio/references/agents.md +4 -4
  20. package/assets/skills/fimo-studio/references/ai-chat.md +5 -5
  21. package/assets/skills/fimo-studio/references/analytics.md +1 -1
  22. package/assets/skills/fimo-studio/references/billing-and-credits.md +3 -3
  23. package/assets/skills/fimo-studio/references/cms.md +1 -1
  24. package/assets/skills/fimo-studio/references/command-palette.md +3 -4
  25. package/assets/skills/fimo-studio/references/connections.md +9 -9
  26. package/assets/skills/fimo-studio/references/custom-domains.md +1 -1
  27. package/assets/skills/fimo-studio/references/drawing-and-wireframing.md +2 -4
  28. package/assets/skills/fimo-studio/references/media-library.md +4 -0
  29. package/assets/skills/fimo-studio/references/preview-and-responsive.md +2 -2
  30. package/assets/skills/fimo-studio/references/project-creation.md +8 -8
  31. package/assets/skills/fimo-studio/references/publish-and-deploy.md +7 -7
  32. package/assets/skills/fimo-studio/references/schedules.md +5 -5
  33. package/assets/skills/fimo-studio/references/sharing-and-collaboration.md +10 -10
  34. package/assets/skills/fimo-studio/references/version-history.md +4 -4
  35. package/assets/skills/fimo-studio/references/visual-editing.md +7 -5
  36. package/assets/skills/fimo-studio/references/webhooks.md +6 -6
  37. package/dist/cli/bundle.json +1 -1
  38. package/dist/cli/index.js +64 -79
  39. package/package.json +12 -12
  40. package/templates/astro/package.json +4 -3
  41. package/templates/nextjs/package.json +7 -6
  42. package/templates/react-router/package.json +5 -5
  43. package/templates/sveltekit/package.json +4 -3
  44. package/templates/vite/package.json +7 -6
  45. package/templates/welcome/manifest.json +4 -4
  46. package/templates/welcome/template/.fimo/config.json +1 -1
  47. package/templates/welcome/template/src/pages/SiteContent.tsx +1 -1
  48. package/templates/welcome/template/src/pages/fallback-content.ts +2 -2
  49. package/assets/skills/fimo-cli/references/inbox.md +0 -86
@@ -6,15 +6,15 @@ Press **Cmd+K** on macOS or **Ctrl+K** on Windows and Linux to open the command
6
6
 
7
7
  The palette includes the destinations you are allowed to use:
8
8
 
9
- - Organizations, projects, and the main Studio workspaces
9
+ - Organizations, sites, and the main Studio workspaces
10
10
  - Preview pages
11
11
  - CMS Collections, Singles, Pages, Forms, Labels, and content types
12
12
  - Individual page templates and forms
13
13
  - Agent runs, definitions, and individual agents
14
- - Project settings sections, individual schedules and webhooks, connections, and MCP servers
14
+ - Site settings sections, individual schedules and webhooks, connections, and MCP servers
15
15
  - Asset folders
16
16
 
17
- You can also open documentation, feedback, account actions, project history, invitations, and the Publish review flow. Use **Escape** to return from a searchable subpage to the main command list, then press it again to close the palette.
17
+ You can also open documentation, feedback, account actions, site history, invitations, and the Publish review flow. Use **Escape** to return from a searchable subpage to the main command list, then press it again to close the palette.
18
18
 
19
19
  ## Actions for the Current Page
20
20
 
@@ -25,7 +25,6 @@ Studio adds commands that are relevant to the page you are viewing. Depending on
25
25
  - Uploading an asset, creating a folder, or generating an image
26
26
  - Running an agent, opening its Preview result, or resolving proposed changes
27
27
  - Editing or opening the current CMS page in Preview
28
- - Marking the current Inbox item read or unread, and archiving or restoring it
29
28
  - Running, pausing, resuming, or opening runs for the current schedule
30
29
  - Sending a test or opening deliveries for the current webhook
31
30
  - Inviting a member or buying a domain from the corresponding organization page
@@ -1,28 +1,28 @@
1
1
  # Connections
2
2
 
3
- Connections let a project use external services without exposing credentials to editors, chat, or agents. Studio, the
4
- CLI, and project agents all resolve the same project-scoped connection state.
3
+ Connections let a site use external services without exposing credentials to editors, chat, or agents. Studio, the
4
+ CLI, and site agents all resolve the same project-scoped connection state.
5
5
 
6
6
  ## See what is available
7
7
 
8
- 1. Open the project.
8
+ 1. Open the site.
9
9
  2. Open **More**, then **Settings**.
10
10
  3. Choose **Connections**.
11
11
 
12
12
  The page has two groups:
13
13
 
14
14
  - **Services** are integrations maintained by Fimo, such as Firecrawl, Fal, and Slack.
15
- - **MCP servers** are remote servers installed for this project. Choose **Add MCP server** beside this group to add one.
15
+ - **MCP servers** are remote servers installed for this site. Choose **Add MCP server** beside this group to add one.
16
16
 
17
17
  Each row shows whether the connection is enabled, disabled, or needs attention. Open a row to enable or disable it for
18
- the current project, inspect its endpoint and live tools, or perform the repair appropriate to its authentication.
18
+ the current site, inspect its endpoint and live tools, or perform the repair appropriate to its authentication.
19
19
 
20
20
  ## Add an MCP server
21
21
 
22
22
  Choose **Add MCP server** to open one setup flow:
23
23
 
24
24
  1. Pick a recommended server, choose **Custom MCP server**, or, if you are an organization owner or admin, choose
25
- **Use from another project**.
25
+ **Use from another site**.
26
26
  2. Recommended servers fill their name and endpoint. A custom server asks for a name and Streamable HTTP HTTPS URL.
27
27
  3. **Connect with** offers the recommended sign-in path. Fimo checks the endpoint; public servers connect immediately,
28
28
  while OAuth servers open their provider sign-in page and return after approval.
@@ -33,8 +33,8 @@ For **Paste an access token**, enter only the token; Fimo adds the `Bearer` sche
33
33
  each complete value exactly as the server expects, including any prefix (`Authorization` with `Bearer abc123`). Fimo
34
34
  encrypts every saved grant and never shows its private value again.
35
35
 
36
- **Use from another project** does not make other projects' servers generally visible. It is an explicit admin-only
37
- picker that attaches an existing organization Connection to this project without revealing or copying its credential.
36
+ **Use from another site** does not make other sites' servers generally visible. It is an explicit admin-only
37
+ picker that attaches an existing organization Connection to this site without revealing or copying its credential.
38
38
 
39
39
  Each authentication method has one repair:
40
40
 
@@ -47,6 +47,6 @@ Only organization owners and admins can replace a shared credential. OAuth and m
47
47
  together.
48
48
 
49
49
  After the server is added, its detail shows the endpoint and the tools Fimo discovered. Only enabled servers become
50
- available to Studio chat, autonomous agents, and the Fimo CLI for this project. Agents should discover them with
50
+ available to Studio chat, autonomous agents, and the Fimo CLI for this site. Agents should discover them with
51
51
  `fimo integrations list`, inspect them with `fimo integrations info <integration>`, and run an allowed tool with
52
52
  `fimo integrations run <integration> <tool>`.
@@ -5,7 +5,7 @@ If you're driving Fimo from the terminal, the equivalent commands are `fimo doma
5
5
  ## Before You Start
6
6
 
7
7
  - You need a **premium plan**. Without it, the Domains option shows an "Upgrade" label.
8
- - Your project must be **published at least once**. An alert appears if it has not been published yet.
8
+ - Your site must be **published at least once**. An alert appears if it has not been published yet.
9
9
  - You need access to your **domain registrar** (GoDaddy, Namecheap, Cloudflare, etc.).
10
10
  - Both **subdomains** (e.g., `blog.example.com`) and **apex/root domains** (e.g., `example.com`) are supported. A subdomain uses a single CNAME record; an apex domain uses two A records, with an optional automatic redirect to its `www` subdomain. The redirect direction can be reversed later without changing DNS.
11
11
 
@@ -1,8 +1,6 @@
1
1
  ## Opening the Drawing Tool
2
2
 
3
- Inside an existing project, open the wireframe canvas from the chat attachment dropdown: click the add-attachments (**+**) button next to the chat input, then choose **Draw**. (This option is hidden on mobile.)
4
-
5
- <!-- TODO(audit 2026-06-03): The previously documented "pen icon in the project creation form" entry point could not be confirmed in apps/ui. The drawing dialog there is only opened from the chat attachment dropdown. If a creation-form pen icon exists on the landing/home surface, document it here. -->
3
+ Inside an existing site, open the wireframe canvas from the chat attachment dropdown: click the add-attachments (**+**) button next to the chat input, then choose **Draw**. (This option is hidden on mobile.)
6
4
 
7
5
  Selecting **Draw** opens a large drawing canvas powered by Excalidraw, displayed in a centered dialog.
8
6
 
@@ -54,7 +52,7 @@ When you are happy with your sketch:
54
52
 
55
53
  Click the **clear canvas** button to start fresh. A confirmation dialog appears before clearing to prevent accidental loss.
56
54
 
57
- Your work is retained while you close and reopen the canvas within the same session, so you can step away and come back to it. It is cleared once you attach the drawing, and it is not persisted across page reloads or navigating away from the project.
55
+ Your work is retained while you close and reopen the canvas within the same session, so you can step away and come back to it. It is cleared once you attach the drawing, and it is not persisted across page reloads or navigating away from the site.
58
56
 
59
57
  ## Getting the Best Results
60
58
 
@@ -28,6 +28,10 @@ Click any file to open a preview dialog:
28
28
 
29
29
  The preview shows file metadata (size, dimensions, upload date) and editable fields for **name**, **alt text**, and **caption**. Alt text and captions are generated automatically by AI after upload -- you'll see a **Generating with AI** indicator, then an **AI generated** badge once they're ready, and you can edit the suggested text inline. From here you can also **copy the link** or **send the file to chat**. To **move**, **rename**, or **delete** a file, use its right-click menu in the grid instead.
30
30
 
31
+ ## Replacing a File in Content
32
+
33
+ In a file's details, choose **Replace file**, pick a replacement, then select **Continue** to review the Current Branch reference count. **Back** or **Escape** returns to the picker with the choice preserved; closing the picker returns to the file's details. Only confirming the replacement changes references. Main, the live site, other Branches, and the original file stay unchanged.
34
+
31
35
  ## AI Image Generation
32
36
 
33
37
  1. Click the **Plus (+) dropdown** in the media library and select **Generate Image**.
@@ -38,8 +38,8 @@ You may see different overlays depending on what is happening:
38
38
  - **"Recovering preview…"** -- The visible preview is reloading after a refresh or a recoverable development-server failure.
39
39
  - **"Editing unavailable"** -- The site remains visible, but its Fimo integration did not connect in time. Visual editing and the route selector stay unavailable; preview and refresh still work.
40
40
  - **Error overlay** -- Something went wrong. The overlay shows details about the issue, and the AI can often auto-fix it for you.
41
- - **"Some installed packages need approval"** -- Choose **Fix with Fimo** to send the complete repair context to the coding agent, or **Copy details** to handle it elsewhere. Review every named package, commit only trusted package-specific approvals, and retry Preview. Never replace the project policy with a blanket allow-all setting.
42
- - **First generation progress** -- When your project is being built for the first time, a progress overlay shows the current status.
41
+ - **"Some installed packages need approval"** -- Choose **Fix with Fimo** to send the complete repair context to the coding agent, or **Copy details** to handle it elsewhere. Review every named package, commit only trusted package-specific approvals, and retry Preview. Never replace the site policy with a blanket allow-all setting.
42
+ - **First generation progress** -- When your site is being built for the first time, a progress overlay shows the current status.
43
43
 
44
44
  ## Switching Workspaces
45
45
 
@@ -1,16 +1,16 @@
1
- ## Create a Project
1
+ ## Create a Site
2
2
 
3
- 1. Open **Projects** in Fimo Studio.
4
- 2. Select **Create project**. If the button is unavailable, ask an organization admin for project creation permission.
5
- 3. Enter a project name and select **Create**.
6
- 4. Studio opens the new project's **Getting started** view.
3
+ 1. Open **Sites** in Fimo Studio.
4
+ 2. Select **Create site**. If the button is unavailable, ask an organization admin for site creation permission.
5
+ 3. Enter a site name and select **Create**.
6
+ 4. Studio opens the new site's **Getting started** view.
7
7
 
8
- ## Set Up the Project
8
+ ## Set Up the Site
9
9
 
10
- The **For agents** tab is the default. Copy its prompt into your coding agent, or use one of the available agent shortcuts. The prompt identifies this as a newly created Fimo project, gives the agent the exact `fimo init` command, pins the selected CLI channel for every `fimo` command in the setup, and links to the coding-agent guide. Following that guide, the agent initializes the project and creates its first hosted preview with one plain preview deploy — unless you tell it not to deploy.
10
+ The **For agents** tab is the default. Copy its prompt into your coding agent, or use one of the available agent shortcuts. The prompt identifies this as a newly created Fimo site, gives the agent the exact `fimo init` command, pins the selected CLI channel for every `fimo` command in the setup, and links to the coding-agent guide. Following that guide, the agent initializes the site and creates its first hosted preview with one plain preview deploy — unless you tell it not to deploy.
11
11
 
12
12
  Use **Manual setup** when you want to run the steps yourself. It provides the exact `fimo init` command, coding-agent shortcuts, and the final `fimo deploy` command.
13
13
 
14
- The first deploy completes onboarding and removes **Getting started** from the project. You can also select **Dismiss getting started** to hide it without deploying.
14
+ The first deploy completes onboarding and removes **Getting started** from the site. You can also select **Dismiss getting started** to hide it without deploying.
15
15
 
16
16
  Deploying creates a preview. It does not publish the site. Publishing is a separate action in Fimo Studio; see **Publish & Deploy** when the site is ready to go live.
@@ -2,15 +2,15 @@
2
2
 
3
3
  1. Look for the **Publish** button in the top-right of the header bar.
4
4
  2. Click it to open the publish panel. This shows your current status, your live URL (once you have one), any custom domains, and a **SEO Settings** shortcut.
5
- 3. Click **Publish** inside the panel to start the deploy. A toast notification says "Publishing project..." and the panel's status badge switches to **Publishing** with a spinner.
5
+ 3. Click **Publish** inside the panel to start the deploy. A toast notification says "Publishing site..." and the panel's status badge switches to **Publishing** with a spinner.
6
6
  4. Once done, the panel shows a **Published** status, your live URL under a **Published site** heading, and a **Last published** date and time.
7
7
  5. Click the URL to open your live site in a new tab.
8
8
 
9
- > **Next step:** After publishing, consider inviting teammates to collaborate using the **Invite** button in the project header. You can grant them Full, Edit, Comment, or View access.
9
+ > **Next step:** After publishing, consider inviting teammates to collaborate using the **Invite** button in the site header. You can grant them Full, Edit, Comment, or View access.
10
10
 
11
11
  ## Re-publishing After Changes
12
12
 
13
- Every change you make is automatically saved to your project, but saved changes are not live yet. Think of it like writing a draft: it is saved, but nobody sees it until you publish.
13
+ Every change you make is automatically saved to your site, but saved changes are not live yet. Think of it like writing a draft: it is saved, but nobody sees it until you publish.
14
14
 
15
15
  To push your latest changes live, open the publish panel from the header **Publish** button and click **Publish** inside it again. It redeploys with your latest code and content.
16
16
 
@@ -27,11 +27,11 @@ When the AI requested publication, the review dialog offers **Merge and publish*
27
27
  The header **Publish** button itself only shows the label "Publish" (or a spinner while a deploy is running). Open the panel to see the current state:
28
28
 
29
29
  - **"Not published yet"** — Your site has never been published. Use **Publish** inside the panel when it is enabled.
30
- - **"This project uses an older version of Fimo"** — Upgrade the project's Production source before publishing new changes. **Upgrade project** opens its Preview, where you can request the migration in the existing chat. Your previously published site stays online.
30
+ - **"This site uses an older version of Fimo"** — Upgrade the site's Production source before publishing new changes. **Upgrade site** opens its Preview, where you can request the migration in the existing chat. Your previously published site stays online.
31
31
  - **"Publishing"** — Publishing is in progress. A spinner and a **Publishing** status badge show while it builds, and the button is disabled.
32
32
  - **"Published"** — Your site is live. A **Published** status badge appears, your live URL is listed under a **Published site** heading as a clickable link, and a **Last published** date and time is shown.
33
- - **"Couldn't publish · N issues"** — Project validation found issues that must be fixed first. Choose **Fix with Fimo** to send the safe issue list to the project chat and ask Fimo to repair it.
34
- - **"Latest update failed"** — The newest publication did not finish. The panel says what went wrong and, for a site that was published before, that the previous version remains the active release — so it can appear beside **Published**. It stays until a newer publication finishes. **View details** opens the reader's Inbox item about the failure, which offers **Open publishing** and **Contact support**. Studio never shows the build output; read it with `fimo publish logs <id>`, taking the id from `fimo publish list`. The person who published and the project's managers get that Inbox item, plus an email unless they turned off **Publication failures** in Account settings → Notifications.
33
+ - **"Couldn't publish · N issues"** — Site validation found issues that must be fixed first. Choose **Fix with Fimo** to send the safe issue list to the site chat and ask Fimo to repair it.
34
+ - **"Latest update failed"** — The newest publication did not finish. The panel says what went wrong and, for a site that was published before, that the previous version remains the active release — so it can appear beside **Published**. It stays until a newer publication finishes. Studio never shows the build output; read it with `fimo publish logs <id>`, taking the id from `fimo publish list`. The person who published and the site's managers get an email that opens this panel, unless they turned off **Publication failures** in Account settings → Notifications.
35
35
 
36
36
  ## Key Concepts
37
37
 
@@ -43,5 +43,5 @@ The header **Publish** button itself only shows the label "Publish" (or a spinne
43
43
  ## Troubleshooting
44
44
 
45
45
  - **Changes not showing on the live site**: Try clearing your browser cache or opening the site in an incognito/private window.
46
- - **Publish button is disabled or missing**: Check the upgrade explanation and your publish permissions. If the button shows a tooltip about permissions, ask the project owner to check your role.
46
+ - **Publish button is disabled or missing**: Check the upgrade explanation and your publish permissions. If the button shows a tooltip about permissions, ask the site owner to check your role.
47
47
  - **On mobile**: The header **Publish** button opens a drawer with the same status and confirmation action as the desktop panel.
@@ -1,10 +1,10 @@
1
1
  # Schedules
2
2
 
3
- Schedules run recurring project commands in one environment. Use the Studio surface to review configuration, pause or resume automatic runs, start work now, and inspect what happened afterward.
3
+ Schedules run recurring site commands in one environment. Use the Studio surface to review configuration, pause or resume automatic runs, start work now, and inspect what happened afterward.
4
4
 
5
5
  ## Open schedules
6
6
 
7
- 1. Open the project and choose **Settings**.
7
+ 1. Open the site and choose **Settings**.
8
8
  2. Select **Schedules**.
9
9
  3. Choose the environment whose schedules you want to manage.
10
10
 
@@ -16,10 +16,10 @@ Choose **New schedule** to set:
16
16
 
17
17
  - A human-readable name
18
18
  - A standard five-field cron expression
19
- - The command to run from the project root
20
- - The project secret keys the command is allowed to use
19
+ - The command to run from the site root
20
+ - The site secret keys the command is allowed to use
21
21
 
22
- A schedule with no selected secret keys receives no project secrets. Studio displays key names only and never reveals secret values.
22
+ A schedule with no selected secret keys receives no site secrets. Studio displays key names only and never reveals secret values.
23
23
 
24
24
  Open a schedule to change its configuration. Use **Pause** to prevent future cron runs without deleting its history, and **Resume** to make the cron active again.
25
25
 
@@ -1,19 +1,19 @@
1
- ## Inviting People to Your Project
1
+ ## Inviting People to Your Site
2
2
 
3
- 1. Click the **Invite** button in the project header.
3
+ 1. Click the **Invite** button in the site header.
4
4
  2. A sharing panel opens showing your current team. On desktop this appears as a popover; on mobile it opens as a drawer.
5
5
  3. Type the email address of the person you want to invite.
6
6
  4. Choose an access level for them:
7
- - **Full access** -- complete control over the project, including settings and member management.
8
- - **Can edit** -- can edit content and assets, and use the AI chat to change code. Cannot change project settings.
9
- - **Can comment** -- can view the project and leave comments but cannot make edits.
10
- - **Can view** -- can see the project but cannot make any changes or comments.
7
+ - **Full access** -- complete control over the site, including settings and member management.
8
+ - **Can edit** -- can edit content and assets, and use the AI chat to change code. Cannot change site settings.
9
+ - **Can comment** -- can view the site and leave comments but cannot make edits.
10
+ - **Can view** -- can see the site but cannot make any changes or comments.
11
11
  5. Click **Invite**.
12
12
  6. The invite appears in the member list marked **Pending invitation** until the person accepts it.
13
13
 
14
14
  ## Managing Members
15
15
 
16
- Open the sharing panel to see everyone who has access to your project. Each member appears with their avatar, name, and current access level.
16
+ Open the sharing panel to see everyone who has access to your site. Each member appears with their avatar, name, and current access level.
17
17
 
18
18
  - **Change access**: Click the role dropdown next to a member's name and pick a new level.
19
19
  - **Remove someone**: Open the role dropdown next to their name and choose **Delete** to revoke access.
@@ -21,15 +21,15 @@ Open the sharing panel to see everyone who has access to your project. Each memb
21
21
 
22
22
  ## Real-Time Collaboration
23
23
 
24
- When multiple people are working on the same project at the same time, you can see each other's activity:
24
+ When multiple people are working on the same site at the same time, you can see each other's activity:
25
25
 
26
26
  - Each person's cursor is labeled with their name in the preview, so you can tell who is who.
27
27
  - CMS content changes appear in real time.
28
28
 
29
29
  ## Organization Access
30
30
 
31
- If your project belongs to an organization, some members may already have access based on their organization role.
31
+ If your site belongs to an organization, some members may already have access based on their organization role.
32
32
 
33
33
  - At the bottom of the sharing panel, below the invite field and the member list, an **Everyone in <your organization>** row lets you set the default access level for all org members. This control also offers **No access** to turn org-wide access off.
34
- - When org-wide access is set, all organization members can see the project at that level.
34
+ - When org-wide access is set, all organization members can see the site at that level.
35
35
  - You can still invite people individually for more specific access.
@@ -1,10 +1,10 @@
1
1
  ## Where to Find Version History
2
2
 
3
- Click your **project name** in the top bar to open the project dropdown menu, then select **History**. This opens the version history panel showing all your saved versions.
3
+ Click your **site name** in the top bar to open the site dropdown menu, then select **History**. This opens the version history panel showing all your saved versions.
4
4
 
5
5
  ## How Versions Are Created
6
6
 
7
- Versions are created automatically as you work — you don't create them by hand. Whenever the AI makes meaningful changes to your project, it captures a restore point for the current environment that you can browse, rename, and restore. A restore point includes the project code and CMS data, including schemas, entries, translations, and forms. There is no "create version" button in the panel; the history list only shows the restore points that already exist.
7
+ Versions are created automatically as you work — you don't create them by hand. Whenever the AI makes meaningful changes to your site, it captures a restore point for the current environment that you can browse, rename, and restore. A restore point includes the site code and CMS data, including schemas, entries, translations, and forms. There is no "create version" button in the panel; the history list only shows the restore points that already exist.
8
8
 
9
9
  ## Browsing Versions
10
10
 
@@ -25,7 +25,7 @@ Find the version you want to update, click the **three-dot menu**, select **Edit
25
25
 
26
26
  ## Key Concepts
27
27
 
28
- - **Automatic versions** -- The AI creates these whenever it makes significant changes to your project. You do not need to do anything for these to appear.
28
+ - **Automatic versions** -- The AI creates these whenever it makes significant changes to your site. You do not need to do anything for these to appear.
29
29
  - **Studio is browse and restore** -- Studio does not create restore points manually. Developers can use `fimo history create "Name"` from the CLI.
30
30
  - **Environment-scoped history** -- Each environment has its own restore points. Restoring one environment does not change another.
31
31
  - **Safe restore** -- Fimo records the current code and CMS data as a safety point before replacing them.
@@ -33,7 +33,7 @@ Find the version you want to update, click the **three-dot menu**, select **Edit
33
33
 
34
34
  ## Quick Restore from Chat
35
35
 
36
- Each AI message in the chat that made changes to your project shows an **undo button** (↩ icon) on the right side. Click it and a **"Restore version?"** prompt appears; confirm it to restore the current environment to the state it was in at that message. Fimo saves a safety point first, so CMS work completed after that message remains recoverable. This is the fastest way to undo a recent change without opening the full version history panel.
36
+ Each AI message in the chat that made changes to your site shows an **undo button** (↩ icon) on the right side. Click it and a **"Restore version?"** prompt appears; confirm it to restore the current environment to the state it was in at that message. Fimo saves a safety point first, so CMS work completed after that message remains recoverable. This is the fastest way to undo a recent change without opening the full version history panel.
37
37
 
38
38
  The undo button is disabled on the most recent change (you can't restore the version you're already on) and is only available to members with permission to manage history.
39
39
 
@@ -1,16 +1,18 @@
1
1
  ## Entering Edit Mode
2
2
 
3
- Click the **Edit mode** icon in the preview header, next to Share, or press **Alt+E** (⌥+E on Mac). You can also hold **Alt** (**Option** on Mac); the icon stays active without opening a panel. Select an element, release the key, and continue editing. Releasing without a selection leaves temporary edit mode. Shortcuts are inactive while typing in a field. The preview must be visible and your project fully loaded before edit mode is available. Note: edit mode is not available on mobile.
3
+ Click the **Edit mode** icon in the preview header, next to Share, or press **Alt+E** (⌥+E on Mac). You can also hold **Alt** (**Option** on Mac); the icon stays active without opening a panel. Select an element, release the key, and continue editing. Releasing without a selection leaves temporary edit mode. Shortcuts are inactive while typing in a field. The preview must be visible and your site fully loaded before edit mode is available. Note: edit mode is not available on mobile.
4
4
 
5
5
  ## Selecting and Editing Elements
6
6
 
7
- Once in edit mode, click an element in the preview. An orange outline highlights it. Plain CMS-managed text edits in place; images, rich text, and structured fields open the side editor.
7
+ Once in edit mode, click an element in the preview. An orange outline highlights it. CMS-managed text, images, rich text, and structured fields open the side editor.
8
8
 
9
9
  ### Editing Content
10
10
 
11
- Type directly into selected CMS-managed text, then press **Enter** or choose **Done** above it to save. **Escape** discards the text edit; **Shift+Enter** inserts a newline. **Ask Fimo** opens chat with the selected element as context. Selecting an image opens its image editor. Image and structured-field changes save automatically; inline text is saved only with Enter or Done. Failed text saves keep the toolbar open for correction or retry. Text and images written directly in the site code remain selectable for chat context; ask the AI chat to change them.
11
+ Update the selected field in the sidebar. Changes save automatically and appear in the preview. Failed saves keep the draft available for correction or retry. Use AI chat to change text and images written directly in the site code.
12
12
 
13
- The link icon in the selected element's toolbar opens its label or CMS entry. Choose **All fields** in the side editor to open the complete entry form. Studio keeps the content type's field order, scrolls to the field you selected, and focuses it in place. Loading appears only while Studio fetches this additional entry data or moves to another entry.
13
+ The link icon beside the field in the sidebar opens its label or CMS entry. Choose **All fields** in the side editor to open the complete entry form. Studio keeps the content type's field order, scrolls to the field you selected, and focuses it in place. Loading appears only while Studio fetches this additional entry data or moves to another entry.
14
+
15
+ Incomplete JSON drafts stay local. Leaving an empty JSON field saves `null` and updates the preview without reloading the page.
14
16
 
15
17
  ### References and Components
16
18
 
@@ -26,7 +28,7 @@ Selecting an element with nothing editable (a container, a spacer, a decorative
26
28
 
27
29
  ## Exiting Edit Mode
28
30
 
29
- Choose **Done** above selected text or click the **Edit mode** icon again to return to preview mode. Closing the side panel dismisses its selected field.
31
+ Click the **Edit mode** icon again to return to preview mode. Closing the side panel dismisses its selected field.
30
32
 
31
33
  ## When to Use Edit Mode vs. Chat
32
34
 
@@ -2,26 +2,26 @@
2
2
 
3
3
  > Test each destination and review its delivery history before depending on it in production.
4
4
 
5
- Webhooks send project activity to an external HTTPS endpoint. Use them for focused reactions such as adding a waitlist submission to an email tool, notifying Slack after a publish, or starting a GitHub workflow after an agent review.
5
+ Webhooks send site activity to an external HTTPS endpoint. Use them for focused reactions such as adding a waitlist submission to an email tool, notifying Slack after a publish, or starting a GitHub workflow after an agent review.
6
6
 
7
- Only project members with Full Access can see Webhooks in Settings or manage its destinations and delivery history.
7
+ Only site members with Full Access can see Webhooks in Settings or manage its destinations and delivery history.
8
8
 
9
9
  ## Create one
10
10
 
11
- 1. Open the project and choose **Settings**.
11
+ 1. Open the site and choose **Settings**.
12
12
  2. Select **Webhooks**.
13
13
  3. Choose **New webhook**.
14
14
  4. Name it, select one event, and enter the destination URL.
15
15
  5. Optionally narrow form, agent, media, or entry events with the filter shown for that event.
16
16
  6. Review the request and select **Save**.
17
17
 
18
- The event groups are Entries, Forms, Publish, Agents, Analytics, Media, Domains, Labels, Locales, and Environments. Webhooks belong to the project, with up to 20 configurations. Choose the Main Branch, All Branches, Production, Preview, or one custom Environment. Main Branch is the default.
18
+ The event groups are Entries, Forms, Publish, Agents, Analytics, Media, Domains, Labels, Locales, and Environments. Webhooks belong to the site, with up to 20 configurations. Choose the Main Branch, All Branches, Production, Preview, or one custom Environment. Main Branch is the default.
19
19
 
20
20
  Entry webhooks send one delivery per committed write. A bulk edit or environment merge may contain a bounded batch, and wider changes split into separately delivered batches.
21
21
 
22
22
  ## Configure the request
23
23
 
24
- The default payload is the complete Fimo event, including its type, project, scalar Environment and Branch context, timestamp, and event-specific data. The legacy `env.name` Branch field remains available. Keep the complete payload when the destination can accept it.
24
+ The default payload is the complete Fimo event, including its type, site, scalar Environment and Branch context, timestamp, and event-specific data. The legacy `env.name` Branch field remains available. Keep the complete payload when the destination can accept it.
25
25
 
26
26
  Choose **Custom template** when a service expects a specific JSON shape. Use **Insert variable** to pick fields for the selected event. Variables use paths such as `{{ event.data.submission.data.email }}`. The preview catches invalid JSON and missing variables before save.
27
27
 
@@ -29,7 +29,7 @@ When Studio recognizes a Resend, Slack, or GitHub URL, it offers a request setup
29
29
 
30
30
  ## Add authentication
31
31
 
32
- Under **Headers**, add a header name and type any non-secret prefix, such as `Bearer `. Choose **Insert secret** to select an existing project secret or create one without leaving the webhook editor. Creating a secret never replaces an existing secret with the same name; select the existing secret instead. Fixed values are suitable only for non-sensitive headers.
32
+ Under **Headers**, add a header name and type any non-secret prefix, such as `Bearer `. Choose **Insert secret** to select an existing site secret or create one without leaving the webhook editor. Creating a secret never replaces an existing secret with the same name; select the existing secret instead. Fixed values are suitable only for non-sensitive headers.
33
33
 
34
34
  Fimo signs requests by default. Save the signing secret shown after creation so a custom receiver can verify `X-Fimo-Signature`. Rotate it from the webhook configuration if it is exposed.
35
35
 
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-10-06T07:22:24.727Z",
4
+ "bundledAt": "2026-10-08T06:10:28.838Z",
5
5
  "cliVersion": "2.7.1",
6
6
  "external": [
7
7
  "oxc-parser",