Skip to main content

Deploy

Publishing & drafts

Keep a site private while you work on it, preview it, then publish when it's ready. A draft site is invisible to the public until you press Publish.

Every NookDocs project has a published state. Your site goes live automatically on its first successful deploy — push your docs (or edit in the browser) and once the first deploy finishes, {slug}.nookdocs.site is public. No extra publish step for a normal launch.

You stay in control after that: Unpublish anytime to take the site offline (it returns to "Site not found"), then Publish again when you're ready. Once you've unpublished, later deploys won't silently re-publish — your choice sticks.

A project's public tenant site is gated by a published flag, separate from deploy status. It is set to true automatically on the first successful deploy (last_deploy_at was previously null); subsequent deploys never change it, so an explicit Unpublish is preserved. While unpublished (draft), the public site — every page plus sitemap.xml, llms.txt, llms-full.txt, robots.txt, .md raw exports and RSS — responds as if the subdomain didn't exist ("Site not found"). Search engines and AI crawlers therefore index nothing while unpublished. Toggled by the project owner from the dashboard; there is no config-file key for it.

Draft vs. live

DraftPublished
Public visits {slug}.nookdocs.siteSees "Site not found"Sees your docs
Appears in search / AI crawlersNoYes
sitemap.xml, llms.txt, robots.txtNot servedServed
You can edit & deployYesYes
You can preview itYes (private preview)Yes (it's just live)

A draft is indistinguishable from a nonexistent site to anyone without a preview link — there's no "coming soon" page that reveals the site exists.

Publish state is separate from deploy status. A project can be deployed and building fine, yet still be a draft. And it's separate from password protection (access control if configured) — that gates an already-public site behind a password; a draft isn't public at all.

Preview a draft

While a site is a draft, open Preview draft from the project overview (or Settings → General → Visibility). It opens your site in a new tab and starts a private preview session that only works in your browser — the public still sees "Site not found".

The preview link opens the site once, then your browser holds the session for about an hour — so you can click around and refresh normally without the URL carrying anything special. After it expires, open Preview draft again for a fresh session. It's tied to your browser, not a shareable link.

If your project has a verified custom domain, both addresses stay reachable — {slug}.nookdocs.site and your custom domain. Preview draft then asks which address to preview; each one opens its own session, so you can check the draft on the exact host you'll ship on.

Publish (after unpublishing)

The first deploy publishes for you. You only press Publish to bring a site back after you've unpublished it: on the project overview or Settings → General → Visibility, press Publish — the badge flips to Live and {slug}.nookdocs.site is public again. (Publishing needs at least one successful deploy; if the button is disabled, deploy first.)

Unpublish

Need to take the site offline? Press Unpublish on the overview or Settings → General → Visibility. The public site immediately returns "Site not found" again — your content and deploys are untouched, they're just no longer served publicly. Later deploys won't re-publish it; press Publish when you're ready.

Related

Was this page helpful?

Last updated August 14, 2026