fimo 2.11.0-staging.1 → 2.11.0-staging.2

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.
@@ -2,11 +2,11 @@
2
2
 
3
3
  `fimo domains` manages every site address. There are three kinds. Find out which one the user wants before you run a command:
4
4
 
5
- | User says | Kind | Commands | Plan |
6
- | ------------------------------------------ | ----------------------------------------- | ----------------------------------- | ------------------------------------------------------------- |
7
- | "Keep the free address, but make it nicer" | default URL `<slug>.fimo.site` (one each) | `rename-default`, `suggest-default` | every plan, no DNS |
8
- | "I own example.com" | custom domain, attached through DNS | `add`, `refresh`, `remove` | Starter or higher |
9
- | "I want to buy a domain" | registered domain, bought through Fimo | `search`, `pricing`, `buy`, `owned` | purchase must be enabled; `buy` and `owned` need an org admin |
5
+ | User says | Kind | Commands | Plan |
6
+ | ------------------------------------------ | ----------------------------------------- | ---------------------------------------------------------- | ------------------------------------------------------------- |
7
+ | "Keep the free address, but make it nicer" | default URL `<slug>.fimo.site` (one each) | `rename-default`, `suggest-default` | every plan, no DNS |
8
+ | "I own example.com" | custom domain, attached through DNS | `add`, `refresh`, `primary`, `redirect`, `serve`, `remove` | Starter or higher |
9
+ | "I want to buy a domain" | registered domain, bought through Fimo | `search`, `pricing`, `buy`, `owned` | purchase must be enabled; `buy` and `owned` need an org admin |
10
10
 
11
11
  If the user is not sure, start with `fimo domains suggest-default`: it is free and takes one step. `fimo domains list --json` shows the default URL and every custom domain. Run `fimo domains <command> --help` for flags.
12
12
 
@@ -38,6 +38,8 @@ Choosing the slug does not publish the site. The URL resolves after the first su
38
38
  fimo domains add <hostname> [--redirect-www] [--wait [10m]] --json # --redirect-www: the apex redirects to www; bare --wait = 5 min (Ns or Nm)
39
39
  fimo domains refresh <hostname> # check DNS and SSL again; it polls by default
40
40
  fimo domains primary <hostname> --json # the address search engines see; list marks it (primary)
41
+ fimo domains redirect <hostname> <target> [--status 308] --json # send this domain's visitors to another domain of the site
42
+ fimo domains serve <hostname> --json # stop redirecting; the domain serves the site again
41
43
  fimo domains remove <hostname> --yes
42
44
  ```
43
45
 
@@ -45,6 +47,9 @@ fimo domains remove <hostname> --yes
45
47
  - After the user sets DNS, run `refresh` once; it polls until SSL is active or the wait ends (`--no-wait` prints one status). Read the returned status: the end of a wait does not prove the domain works. Do not run `refresh` in a loop. DNS can take from minutes to 48 hours.
46
48
  - In an interactive setup, omit `--wait` on `add` so the user gets the records at once. In CI, `--wait` polls until the domain is verified or the wait ends.
47
49
  - The primary domain is the canonical host of the published site. Fimo picks the oldest serving domain until the user chooses one with `primary`; the domain must be active with its certificate issued, else `DOMAIN_NOT_SERVING`. The canonical links change only on the next publish, so tell the user to publish again.
50
+ - Each custom domain serves the site or redirects to another domain of the same site. `redirect` defaults to 307 (temporary); use 308 or 301 only when the user says the move is permanent. `list` shows each destination (`-> 308 www.acme.com` or `serves`). The target must serve and have its certificate issued, and redirects never chain: a refusal comes back with its code (`REDIRECT_TARGET_REDIRECTS`, `REDIRECT_SOURCE_IS_TARGET`, `REDIRECT_TARGET_NOT_ACTIVE`, `REDIRECT_TARGET_NOT_IN_PROJECT`, `INVALID_REDIRECT_STATUS`), and `add --redirect-www` gets `REDIRECT_TARGET_REDIRECTS` when the site's `www` already redirects elsewhere. Tell the user what it says; never point other domains elsewhere on your own.
51
+ - `remove` also removes every domain that redirects to the one removed. Run it once without `--yes`: in a run without prompts it refuses with `NON_INTERACTIVE_REFUSAL`, and its hint names those domains. Show that list to the user, and pass `--yes` only after they agree to remove them all.
52
+ - A redirect on the primary domain, `serve` on a domain that becomes primary, or removing the primary domain moves the primary domain; the result's hint says so. Tell the user to publish again so canonical links use it.
48
53
  - A Free plan gets a `PAYWALL` 403 with the billing URL: give that URL to the user.
49
54
  - `remove` and `buy` ask for confirmation: pass `--yes` in a run without prompts, after the user agreed.
50
55
 
@@ -1,6 +1,6 @@
1
1
  ## Also available via CLI
2
2
 
3
- If you're driving Fimo from the terminal, the equivalent commands are `fimo domains add`, `fimo domains refresh`, `fimo domains primary`, and `fimo domains remove`. The default URL (the `<slug>.fimo.site` subdomain) is managed with `fimo domains rename-default` and `fimo domains suggest-default` — both free on every plan. See the `fimo-cli` skill's `references/domains.md`. Full docs: https://fimo.ai/docs/deploy/custom-domains.
3
+ If you're driving Fimo from the terminal, the equivalent commands are `fimo domains add`, `fimo domains refresh`, `fimo domains primary`, `fimo domains redirect`, `fimo domains serve`, and `fimo domains remove`. The default URL (the `<slug>.fimo.site` subdomain) is managed with `fimo domains rename-default` and `fimo domains suggest-default` — both free on every plan. See the `fimo-cli` skill's `references/domains.md`. Full docs: https://fimo.ai/docs/deploy/custom-domains.
4
4
 
5
5
  ## Before You Start
6
6
 
@@ -14,7 +14,7 @@ If you're driving Fimo from the terminal, the equivalent commands are `fimo doma
14
14
  1. Open **Settings**.
15
15
  2. Select **Domains** (globe icon).
16
16
  3. Click the **Add domain** button (+ icon) in the top-right of the panel. (When domain purchase is enabled, a **Buy domain** button with a shopping-cart icon sits next to it.)
17
- 4. A drawer opens. Type or select a domain — you can enter a subdomain or an apex domain. Domains your organization already owns appear in an autocomplete dropdown, and Fimo checks availability live as you type. For an apex domain, a checkbox lets you also redirect it to the `www` subdomain (on by default). Confirm to add it.
17
+ 4. A drawer opens. Type or select a domain — you can enter a subdomain or an apex domain. Domains your organization already owns appear in an autocomplete dropdown, and Fimo checks availability live as you type. For an apex domain, a checkbox lets you also redirect it to the `www` subdomain (on by default), unless the site's `www` already redirects elsewhere; for a free `www` domain whose apex is free, the checkbox adds the apex too and redirects it to the `www`. When the site already has a primary domain, the drawer asks where the new domain goes: **Redirect to another domain** (preselected: the primary domain, with 307) or **Serve the site**. With the apex and `www` pair, **Serve the site** keeps the apex redirecting to the `www`, and a redirect sends both straight to the chosen domain. Confirm to add it.
18
18
  5. A DNS table appears showing the record(s) you need to add. For a **subdomain** it's a single CNAME record:
19
19
  - **Type**: CNAME
20
20
  - **Name**: The subdomain part (e.g., "blog") — has a copy button
@@ -42,8 +42,9 @@ Each domain shows a small status icon with a tooltip on hover (there is no inlin
42
42
 
43
43
  - **Open your domain**: Click the three-dot menu on a domain and select "Open URL" to visit it in a new tab.
44
44
  - **See the primary domain**: The domain search engines see carries a **Primary** badge. Until you choose one, it is the first domain you added that is active with its certificate issued.
45
- - **Change the primary domain**: Click the three-dot menu on another domain and select **Make primary**. On the redirecting half of an apex and `www` pair, confirm the new direction: Fimo keeps both domains connected and permanently redirects the other hostname while preserving its path and query string. On any other domain, confirm the choice: your other domains keep serving the site. The hostname must be active with its certificate issued first; otherwise the action is disabled or Studio asks you to retry once the certificate is ready. Publish again so canonical links use the new primary domain.
46
- - **Remove a domain**: Click the three-dot menu and select "Remove". A confirmation dialog appears before deleting.
45
+ - **Change the primary domain**: Click the three-dot menu on another domain and select **Make primary**. On the redirecting half of an apex and `www` pair, confirm the new direction: Fimo keeps both domains connected and permanently redirects the other hostname while preserving its path and query string. On any other domain, confirm the choice: your other domains keep serving the site. The hostname must be active with its certificate issued first; until then the menu does not offer **Make primary**, or Studio asks you to retry once the certificate is ready. Publish again so canonical links use the new primary domain.
46
+ - **Redirect a domain or make it serve again**: Click the three-dot menu and select **Edit**. Choose **Serve the site**, or **Redirect to another domain** with a target (only domains of this site that serve the site, primary first) and a status: 308 or 301 (permanent), 307 or 302 (temporary). Each row shows its destination, for example `308 www.acme.com`, or "Serves the site". A domain other domains redirect to cannot redirect itself; the editor says which domains to point elsewhere first.
47
+ - **Remove a domain**: Click the three-dot menu and select "Remove". A confirmation dialog appears before deleting. When other domains redirect to it, the dialog lists them and the button reads **Remove N domains**: they are removed too.
47
48
  - **Refresh status**: Click the refresh button (circular arrow) to re-check DNS propagation.
48
49
 
49
50
  ## Troubleshooting
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "bundled": true,
3
3
  "bundler": "esbuild",
4
- "bundledAt": "2026-11-04T12:44:55.412Z",
4
+ "bundledAt": "2026-11-04T17:56:30.123Z",
5
5
  "cliVersion": "2.10.3",
6
6
  "external": [
7
7
  "oxc-parser",