From 1e76a32a138dfd99eb932ae93a8c14dc01a3fe62 Mon Sep 17 00:00:00 2001 From: artpi Date: Tue, 17 Nov 2026 09:56:03 +0100 Subject: [PATCH 1/2] Point people to the website importer from the docs Lead the Copy a website page with the browser importer at spacefast.com/migrate, and link it from the docs home and Publishing. Say what to expect: closing the tab doesn't stop a copy, large sites can finish with only part of their pages, and links to pages that weren't copied still point at the old site. --- content/(publish)/migrate.mdx | 20 ++++++++++++++++---- content/(publish)/publish.mdx | 2 ++ content/index.mdx | 5 +++++ scripts/verify-routes.mjs | 3 ++- 4 files changed, 25 insertions(+), 5 deletions(-) diff --git a/content/(publish)/migrate.mdx b/content/(publish)/migrate.mdx index fc6af85..61d5b3d 100644 --- a/content/(publish)/migrate.mdx +++ b/content/(publish)/migrate.mdx @@ -1,13 +1,23 @@ --- title: Copy a website -description: Capture a public website with sf migrate, publish it as a static Space, and finish the move with a claim and a domain +description: Copy a public website into a static Space from your browser or with sf migrate, then finish the move with a claim and a domain sidebar: order: 3.5 --- -`sf migrate` takes the URL of a live website and publishes a static copy of it to a new Space. It does not read your current directory, and the result is a new Space every time. +Give Spacefast the URL of a live website and it publishes a static copy to a new Space. Your original site stays where it is, and copying it again makes another Space. -## Copy a site +## Copy from your browser + +Open [spacefast.com/migrate](https://spacefast.com/migrate/), paste the address, and select **Migrate**. If you're signed in, pick the team that receives the copy. + +The page shows each step and counts pages as they're copied. A small site takes about a minute. A site with hundreds of pages can take most of an hour. The copy keeps going on Spacefast's side, so closing the tab doesn't stop it. Reopening the page doesn't show its progress, though. Find the new Space in your [dashboard](https://my.spacefast.com) instead. + +When it finishes, the page links to the copy and says how many pages it copied. Check it before you move anything. See [Know what the copy contains](#know-what-the-copy-contains). + +## Copy from the CLI + +`sf migrate` does the same from a terminal. It doesn't read your current directory. ```bash sf migrate https://example.com @@ -57,7 +67,9 @@ The URL must: The capture renders the site as portable HTML and publishes those files as a static Space. If the capture produces no HTML file, the build fails. -The copy is static files only. Server-side code, accounts, stored data, and domains stay with the old site. +The copy is static files only. Server-side code, accounts, stored data, and domains stay with the old site. Forms, comments, logins, and search that depend on the old server stop working in the copy. + +A large site can finish with only part of its pages copied. The result still publishes, and it says how many pages were copied out of how many it found. Links to pages that weren't copied still point at the old site, so they break once you move your domain. Open the copy and check the pages you need before you switch. Without a login, the copy publishes as an anonymous Space and gets the anonymous limits: diff --git a/content/(publish)/publish.mdx b/content/(publish)/publish.mdx index c5f4725..27199e9 100644 --- a/content/(publish)/publish.mdx +++ b/content/(publish)/publish.mdx @@ -7,6 +7,8 @@ sidebar: A folder can be published from the CLI, dashboard, or API, and the receipt it returns tells you whether the Space is live. +Only have a public website URL? [Copy the website](/migrate) to Spacefast instead. + ## The mental model One publish is four steps. diff --git a/content/index.mdx b/content/index.mdx index 04e8afd..3721259 100644 --- a/content/index.mdx +++ b/content/index.mdx @@ -9,6 +9,8 @@ Spacefast publishes what people build with AI agents. You hand it a folder, it h Prefer a browser to a terminal? Drag a folder onto [drop.fast](https://drop.fast) instead — no install, no account required. See [Drop](/publish#publish). +Have a website already? Paste its address into the [website importer](https://spacefast.com/migrate/) and Spacefast copies it into a Space. See [Copy a website](/migrate). + ## Publish in one command ```bash @@ -52,6 +54,9 @@ In a self-serve account, your team owns the Spaces you claim, even when you are Drag a folder onto drop.fast. No install, no account required. + + Paste a public website's address and get a static copy in a Space. + Space, version, live, capsule, Ability, grant — core terms in one place. diff --git a/scripts/verify-routes.mjs b/scripts/verify-routes.mjs index 114460f..c57d02c 100644 --- a/scripts/verify-routes.mjs +++ b/scripts/verify-routes.mjs @@ -141,6 +141,7 @@ const representativePages = [ ["index.html", docsRoot, "Spacefast publishes"], ["quickstart/index.html", `${docsRoot}/quickstart`, "Before you start"], ["publish/index.html", `${docsRoot}/publish`, "What gets uploaded"], + ["migrate/index.html", `${docsRoot}/migrate`, "https://spacefast.com/migrate/"], ["versions/index.html", `${docsRoot}/versions`, "immutable"], ["agents/mcp-server/index.html", `${docsRoot}/agents/mcp-server`, "MCP"], ["api/index.html", `${docsRoot}/api`, "Response envelopes"], @@ -273,7 +274,7 @@ const sidebarOf = async (file) => { return html.slice(start, html.indexOf("", start)); }; const sidebarExpectations = [ - ["quickstart/index.html", ["/cli", "/agents"], ["/setup/vscode", "Other agents"]], + ["quickstart/index.html", ["/cli", "/agents", "/migrate"], ["/setup/vscode", "Other agents"]], ["agents/index.html", ["/agents/mcp-server", "/setup/vscode", "Other agents"], ["/setup/codex"]], ["setup/vscode/index.html", ["/agents/mcp-server", "/setup/chatgpt", "Other agents"], ["/quickstart"]], ["cli/agents/index.html", ["/cli/reference"], ["Other agents", "/setup/vscode"]], From 5e5c45af4602c74bc4eb34158766c76d8fcb73de Mon Sep 17 00:00:00 2001 From: artpi Date: Tue, 17 Nov 2026 10:00:38 +0100 Subject: [PATCH 2/2] Scope the importer's tab and team behavior Closing the tab only keeps a signed-in copy reachable; a signed-out copy's claim link lives in that tab. Reloading resumes, a new tab doesn't, and the team picker only appears for people in several teams. --- content/(publish)/migrate.mdx | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/content/(publish)/migrate.mdx b/content/(publish)/migrate.mdx index 61d5b3d..fcd32cd 100644 --- a/content/(publish)/migrate.mdx +++ b/content/(publish)/migrate.mdx @@ -9,9 +9,11 @@ Give Spacefast the URL of a live website and it publishes a static copy to a new ## Copy from your browser -Open [spacefast.com/migrate](https://spacefast.com/migrate/), paste the address, and select **Migrate**. If you're signed in, pick the team that receives the copy. +Open [spacefast.com/migrate](https://spacefast.com/migrate/), paste the address, and select **Migrate**. If you belong to more than one team, pick the one that receives the copy. -The page shows each step and counts pages as they're copied. A small site takes about a minute. A site with hundreds of pages can take most of an hour. The copy keeps going on Spacefast's side, so closing the tab doesn't stop it. Reopening the page doesn't show its progress, though. Find the new Space in your [dashboard](https://my.spacefast.com) instead. +The page shows each step and counts pages as they're copied. A small site takes about a minute. A site with hundreds of pages can take most of an hour. Reloading the tab picks the progress back up, but a new tab starts empty. + +Keep the tab open until it finishes. Signed in, the copy keeps going if you close it, and the new Space shows up in your [dashboard](https://my.spacefast.com). Signed out, the tab holds your only claim link, so if you close it you can't claim the copy. When it finishes, the page links to the copy and says how many pages it copied. Check it before you move anything. See [Know what the copy contains](#know-what-the-copy-contains).