From an empty folder to a shared site in five steps.

Pick how you work, then step through. The folder beside each step grows as you go.

Step 1

Make a folder with a home page

index.html is the page the space's link opens. Every multi-page space needs one.

my-site/index.html

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <title>My site</title>
</head>
<body>
  <h1>Welcome</h1>
</body>
</html>

Your folder

my-site/
index.htmlnew · home

Step 2

Add a file for each page, plus what they share

One HTML file per page. Styles every page uses go in one file, so a change reaches every page.

in the <head> of every page

<link rel="stylesheet" href="site.css">

Your folder

my-site/
index.htmlhome
about.htmlnew
faq.htmlnew
site.cssnew · shared

Step 3

Paste the same menu into every page

Write links relative: the file name, no leading slash. Mark the page you're on with aria-current.

in faq.html

<nav>
  <a href="index.html">Home</a>
  <a href="about.html">About</a>
  <a href="faq.html" aria-current="page">FAQ</a>
</nav>

How the pages link

Step 4

Deploy the whole folder as one space

With an agent (Claude Code, Codex or another agent with spacesheep connected), say:

say to your agent

Deploy the folder my-site to spacesheep as one space, with index.html as the home page. Keep it private.

With the command line, from inside the folder:

terminal

cd my-site
npx -y spacesheep@latest deploy . --title "My site" --emoji "🧭"

Every file in the folder goes up together. You get back one link.

You get back

spacesheep.dev/@you/my-site

index.html→ the link above

about.html→ …/my-site/-/about.html

faq.html→ …/my-site/-/faq.html

Step 5

Share the link, then deploy again to update

Whoever you share the link with can open every page. To change a page, edit its file and deploy the folder again: same link, a new version.

With an agent:

say to your agent

I changed faq.html. Update my-site on spacesheep.

With the command line: the folder remembers its space in .spacesheep.json, and only changed files upload.

terminal

npx -y spacesheep@latest deploy . -m "Updated the FAQ"

Version history

Updated the FAQfaq.html changed · all 3 pages in this version
First versionindex.html, about.html, faq.html, site.css

Step 1 of 5