Pages
Publish standalone HTML files to a hosted, gated URL under your creator handle.
buildspace pages publishes a single HTML file to a hosted URL under your creator handle — no project, build step, or deploy required. Buildspace stores and serves the file as-is; it never generates, rewrites, or executes it.
Publish
buildspace pages publish index.html
buildspace pages publish report.html --visibility login --openThe first publish prompts you to claim a creator handle if you don't have one yet — this is the name your pages publish under (https://pages.buildspace.studio/<handle>/<slug>).
Publishing is idempotent by content: publishing unchanged bytes reports already published (vN) instead of creating a new version, so it's safe to run repeatedly from CI or a watch script.
Options
| Flag | Description |
|---|---|
--slug <slug> | Page slug (default: filename, then the document <title>) |
--title <title> | Page title (default: document <title>) |
--visibility <v> | public | login | org | private (default: private, prompted interactively) |
--message "..." | What changed in this version |
--allow-secrets | Publish despite a detected credential |
--open | Open the URL when done |
--json | Machine-readable output |
A publish is blocked if the file appears to contain a credential — pass --allow-secrets only if that's a false positive. A publish also warns (but does not block) if the HTML references local files, since asset upload isn't supported yet — those references won't resolve on the hosted page.
Visibility
| Value | Who can view |
|---|---|
public | Anyone with the link |
login | Anyone signed in to Buildspace |
org | Members of your organization |
private | You and your org admins |
buildspace pages visibility my-report publicList, open, and versions
buildspace pages list
buildspace pages open my-report
buildspace pages versions my-reportlist shows every page's visibility, current version, size, view count, and URL, plus your quota usage.
Roll back
Every publish creates a new immutable version; rolling back is a pointer flip, not a rewrite.
buildspace pages rollback my-report --version 2Delete
buildspace pages delete my-report --yesDeletes the page and all of its versions. --yes skips the confirmation prompt (required for non-interactive use).
Creator handle
buildspace pages handle # show your current handle
buildspace pages handle acme-studio # claim oneA handle can only be claimed once and is shared across all of your published pages.