fimo 2.8.0-staging.6 → 2.8.0-staging.8

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 (51) hide show
  1. package/README.md +3 -3
  2. package/assets/skills/fimo/SKILL.md +11 -4
  3. package/assets/skills/fimo-cli/SKILL.md +15 -8
  4. package/assets/skills/fimo-cli/references/agents.md +3 -3
  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/knowledge.md +48 -0
  13. package/assets/skills/fimo-cli/references/locales.md +1 -1
  14. package/assets/skills/fimo-cli/references/mcp.md +1 -1
  15. package/assets/skills/fimo-cli/references/project-vars-and-secrets.md +1 -1
  16. package/assets/skills/fimo-cli/references/projects.md +3 -3
  17. package/assets/skills/fimo-cli/references/schedules.md +1 -1
  18. package/assets/skills/fimo-cli/references/support.md +1 -1
  19. package/assets/skills/fimo-code/SKILL.md +7 -0
  20. package/assets/skills/fimo-migration/SKILL.md +7 -0
  21. package/assets/skills/fimo-studio/SKILL.md +36 -28
  22. package/assets/skills/fimo-studio/references/agents.md +4 -4
  23. package/assets/skills/fimo-studio/references/ai-chat.md +5 -5
  24. package/assets/skills/fimo-studio/references/analytics.md +1 -1
  25. package/assets/skills/fimo-studio/references/billing-and-credits.md +3 -3
  26. package/assets/skills/fimo-studio/references/cms.md +1 -1
  27. package/assets/skills/fimo-studio/references/command-palette.md +3 -3
  28. package/assets/skills/fimo-studio/references/connections.md +9 -9
  29. package/assets/skills/fimo-studio/references/custom-domains.md +1 -1
  30. package/assets/skills/fimo-studio/references/drawing-and-wireframing.md +2 -4
  31. package/assets/skills/fimo-studio/references/knowledge.md +9 -0
  32. package/assets/skills/fimo-studio/references/preview-and-responsive.md +2 -2
  33. package/assets/skills/fimo-studio/references/project-creation.md +8 -8
  34. package/assets/skills/fimo-studio/references/publish-and-deploy.md +7 -7
  35. package/assets/skills/fimo-studio/references/schedules.md +5 -5
  36. package/assets/skills/fimo-studio/references/sharing-and-collaboration.md +10 -10
  37. package/assets/skills/fimo-studio/references/version-history.md +4 -4
  38. package/assets/skills/fimo-studio/references/visual-editing.md +1 -1
  39. package/assets/skills/fimo-studio/references/webhooks.md +6 -6
  40. package/dist/cli/bundle.json +1 -1
  41. package/dist/cli/index.js +97 -97
  42. package/package.json +12 -12
  43. package/templates/astro/package.json +3 -3
  44. package/templates/nextjs/package.json +5 -5
  45. package/templates/react-router/package.json +5 -5
  46. package/templates/sveltekit/package.json +3 -3
  47. package/templates/vite/package.json +5 -5
  48. package/templates/welcome/manifest.json +4 -4
  49. package/templates/welcome/template/.fimo/config.json +1 -1
  50. package/templates/welcome/template/src/pages/SiteContent.tsx +1 -1
  51. package/templates/welcome/template/src/pages/fallback-content.ts +2 -2
@@ -1,10 +1,10 @@
1
1
  # Agents
2
2
 
3
- Project agents are versioned bundles from the project's repository. Studio lets project members inspect their configuration and run history, while project managers can start, stop, resume, and delete them.
3
+ Site agents are versioned bundles from the site's repository. Studio lets site members inspect their configuration and run history, while site managers can start, stop, resume, and delete them.
4
4
 
5
5
  ## Open an agent
6
6
 
7
- 1. Open the project and choose **Agents**.
7
+ 1. Open the site and choose **Agents**.
8
8
  2. Select **Agents** again to see the available bundles.
9
9
  3. Choose an agent to open its **Runs** and **Settings** tabs.
10
10
 
@@ -20,11 +20,11 @@ Choose **Stop** to pause every future trigger and stop planned or running work.
20
20
 
21
21
  A stopped agent shows **Paused** in the header. **Resume** makes the same triggers live again with their previous settings.
22
22
 
23
- Only project managers see Run, Stop, and Resume. Other project members can still see schedule timing, status, settings, and run history.
23
+ Only site managers see Run, Stop, and Resume. Other site members can still see schedule timing, status, settings, and run history.
24
24
 
25
25
  ## Delete an agent
26
26
 
27
- Project managers can open **Agent actions** beside Run/Stop, choose **Delete agent**, and confirm. Deletion stops planned or running work and commits removal of the agent bundle from `main`. Recorded runs remain in history. Remove the bundle from a local checkout before deploying again, or that deployment recreates the agent.
27
+ Site managers can open **Agent actions** beside Run/Stop, choose **Delete agent**, and confirm. Deletion stops planned or running work and commits removal of the agent bundle from `main`. Recorded runs remain in history. Remove the bundle from a local checkout before deploying again, or that deployment recreates the agent.
28
28
 
29
29
  If a run cannot be stopped or `main` changes before deletion commits, the definition stays intact and the agent may remain paused. Reload and retry, or resume it if you want to keep it.
30
30
 
@@ -1,10 +1,10 @@
1
1
  ## Where to Find It
2
2
 
3
- Open the **Chats** tab in the project header. On a phone, the Chat tab at the bottom opens the chat list first; select a chat to open it.
3
+ Open the **Chats** tab in the site header. On a phone, the Chat tab at the bottom opens the chat list first; select a chat to open it.
4
4
 
5
5
  ## Working in Several Chats
6
6
 
7
- Chat has its own **Chats** tab in the project header; the tab shows how many chats have unread activity. A project can have several chats, shared by everyone on the project. The left list shows them most recently active first with a status (**Working** with a spinner while replying, **Done** once the reply finished) and their last words; a dot marks unread activity. Select **+** for a new chat (its name comes from the first message; an empty chat offers starter requests), the search icon to find a chat, the filter icon to show only Working or Done chats, and the list settings for ordering and showing read, unread, or archived chats. The buttons above an open chat (or a right-click on a row) mark it unread, pin, archive, or mute it, for you only; the settings icon opens the chat's settings, which rename it for everyone, hold the same pin, mute and archive switches, and delete it, stopping a running reply first. Each chat has only its own messages and context. The open chat is in the page address (`/chats?chat=<id>`), so a link or reload opens the same chat.
7
+ Chat has its own **Chats** tab in the site header; the tab shows how many chats have unread activity. A site can have several chats, shared by everyone on the site. The left list shows them most recently active first with a status (**Working** with a spinner while replying, **Done** once the reply finished) and their last words; a dot marks unread activity. Select **+** for a new chat (it joins the list when its first message is sent, and its name comes from that message; an empty chat offers starter requests), the search icon to find a chat, the filter icon to show only Working or Done chats, and the list settings for ordering and showing read, unread, or archived chats. The buttons above an open chat (or a right-click on a row) mark it unread, pin, archive, or mute it, for you only; the settings icon opens the chat's settings, which change its portrait (shape, face, color) and rename it for everyone, hold the same pin, mute and archive switches, and delete it, stopping a running reply first. Each chat has its own messages and context; when you refer to an earlier discussion, Chat searches the site's chats and answers with the messages it found. The open chat is in the page address (`/chats?chat=<id>`), so a link or reload opens the same chat.
8
8
 
9
9
  ## Sending a Message
10
10
 
@@ -41,13 +41,13 @@ To halt the AI mid-generation, use the **Stop button** in the input bar — whil
41
41
 
42
42
  ## Understanding Tool Badges
43
43
 
44
- While the AI works, you see small badges in the chat showing what it is doing. Each badge displays a tool name and its current status. Examples include reading files, writing code, searching your project, or generating images. These badges help you follow along without needing to understand the technical details.
44
+ While the AI works, you see small badges in the chat showing what it is doing. Each badge displays a tool name and its current status. Examples include reading files, writing code, searching your site, or generating images. These badges help you follow along without needing to understand the technical details.
45
45
 
46
46
  ## Reviewing Proposals
47
47
 
48
48
  Ask the AI to keep alternatives as named proposals. Open the Branch picker and choose one from **Proposals** to preview its work. Each proposal has its own changes. The picker follows visibility: internal work stays hidden even when saved, durable, or given more time. Extending retention does not show the work.
49
49
 
50
- A review request saves the selected session's current work and makes that same session visible and durable. Follow its review card to the proposal, or its Preview and Changes links from chat, Slack, or an agent report. These links open the current Branch in Studio and require project access. A review request refers to saved work: if that work changes, request a new review before merging. Exploring or merging proposal B keeps A, C, and D available unless you ask to discard them. Merging does not publish the site.
50
+ A review request saves the selected session's current work and makes that same session visible and durable. Follow its review card to the proposal, or its Preview and Changes links from chat, Slack, or an agent report. These links open the current Branch in Studio and require site access. A review request refers to saved work: if that work changes, request a new review before merging. Exploring or merging proposal B keeps A, C, and D available unless you ask to discard them. Merging does not publish the site.
51
51
 
52
52
  Delete a proposal from the Branch picker when you no longer need it. Pull is unavailable for proposals; ask the AI to update the proposal instead. New Branch defaults to the proposal's upstream. Merge the proposal first if you want to create a Branch from its changes.
53
53
 
@@ -55,7 +55,7 @@ Delete a proposal from the Branch picker when you no longer need it. Pull is una
55
55
 
56
56
  Chat changes are prepared separately and then applied to the environment you are viewing. Most changes merge automatically.
57
57
 
58
- If the project changed in the same place while the AI was working, the response shows a **Review changes** card and an attention banner above the chat input.
58
+ If the site changed in the same place while the AI was working, the response shows a **Review changes** card and an attention banner above the chat input.
59
59
 
60
60
  Choose **Auto fix** or keep chatting to let Fimo continue in the retained proposal, resolve the conflict, and retry the merge. Choose **Review manually** to inspect and resolve the proposal yourself. Discarding leaves the current environment unchanged and permanently removes the proposal.
61
61
 
@@ -1,6 +1,6 @@
1
1
  # Analytics
2
2
 
3
- Open **Analytics** in the project's workspace navigation. It may be inside
3
+ Open **Analytics** in the site's workspace navigation. It may be inside
4
4
  **More** at narrower desktop widths. This workspace reports the published site,
5
5
  regardless of the editing branch currently selected.
6
6
 
@@ -15,14 +15,14 @@ Look for the **coin icon with a number** near the chat send button. That number
15
15
  - Click it to open a detailed breakdown showing how many credits you have in each category.
16
16
  - When your balance is low, opening that breakdown shows an alert-triangle warning ("No credits left" or "_N_ credits left") at the bottom.
17
17
 
18
- From a linked project directory, `fimo credits` shows the same organization balance in the CLI. Its "Available now" total already includes the visible buckets.
18
+ From a linked site directory, `fimo credits` shows the same organization balance in the CLI. Its "Available now" total already includes the visible buckets.
19
19
 
20
20
  ## Referral progress
21
21
 
22
- Open **Earn free credits** from the project header (or the project menu on mobile), then use **Copy** inside the link field.
22
+ Open **Earn free credits** from the site header (or the site menu on mobile), then use **Copy** inside the link field.
23
23
 
24
24
  - **Signed up** counts people who registered through your link, including those who later published. Link visits do not count.
25
- - **Published** counts people who published their first project, not the number of projects they publish.
25
+ - **Published** counts people who published their first site, not the number of sites they publish.
26
26
  - **AI credits earned** shows inviter rewards already credited to you. It excludes your own bonus for joining through someone else's link; a publication can appear before its reward is credited.
27
27
 
28
28
  Each signup uses one of the five referral slots. Publishing unlocks the reward but does not reopen a slot. The dialog shows signups used and how many people have not published yet. **Terms and Conditions** opens the program terms; **Close** dismisses the dialog.
@@ -55,7 +55,7 @@ When you open a Collection, the entry list provides several tools:
55
55
 
56
56
  ## Completing Missing Translations
57
57
 
58
- Localized Collections show only entries for the locale selected beside the Collection name. When that locale is missing translations that exist in the project's default locale:
58
+ Localized Collections show only entries for the locale selected beside the Collection name. When that locale is missing translations that exist in the site's default locale:
59
59
 
60
60
  1. Click the amber **N missing** warning beside the locale selector.
61
61
  2. Review the source and target languages in the popover.
@@ -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
 
@@ -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
 
@@ -0,0 +1,9 @@
1
+ # Site knowledge
2
+
3
+ Open **Settings → Knowledge**. This is shared guidance for the whole site: brand, audience, goals, rules, tone of voice, and design preferences.
4
+
5
+ Managers can write Markdown directly, or click **Draft from website**. The AI action runs in the background and fills the same text field. Read or edit the result, then click **Save knowledge**. Only Save changes the shared setting; Cancel restores the saved text. An empty setting is valid.
6
+
7
+ Viewers and ordinary editors can read knowledge. Managers and explicitly authorized agents can save it. Agent writes require an explicit user request. Each save replaces the current text; there is no knowledge version history or conflict workflow.
8
+
9
+ Agents use saved guidance when proposing, planning, designing, coding, or writing for the site. Changes apply on the next context refresh. Do not ask users to fill an empty setting unless their current task needs missing information.
@@ -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. 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 an email that opens this panel, 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,6 +1,6 @@
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
 
@@ -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-06T12:40:39.311Z",
4
+ "bundledAt": "2026-10-08T08:47:47.864Z",
5
5
  "cliVersion": "2.7.1",
6
6
  "external": [
7
7
  "oxc-parser",