Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
22 changes: 18 additions & 4 deletions content/(publish)/migrate.mdx
Original file line number Diff line number Diff line change
@@ -1,13 +1,25 @@
---
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 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. 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).
Comment thread
indent[bot] marked this conversation as resolved.
Resolved

## 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
Expand Down Expand Up @@ -57,7 +69,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:

Expand Down
2 changes: 2 additions & 0 deletions content/(publish)/publish.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
5 changes: 5 additions & 0 deletions content/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -52,6 +54,9 @@ In a self-serve account, your team owns the Spaces you claim, even when you are
<Card title="Drop" href="/publish#publish" icon="mouse-pointer-click">
Drag a folder onto drop.fast. No install, no account required.
</Card>
<Card title="Copy a website" href="/migrate" icon="globe">
Paste a public website's address and get a static copy in a Space.
</Card>
<Card title="Glossary" href="/glossary" icon="book-open">
Space, version, live, capsule, Ability, grant — core terms in one place.
</Card>
Expand Down
3 changes: 2 additions & 1 deletion scripts/verify-routes.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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"],
Expand Down Expand Up @@ -273,7 +274,7 @@ const sidebarOf = async (file) => {
return html.slice(start, html.indexOf("</aside>", 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"]],
Expand Down
Loading