Skip to content

feat(docs): add full-screen maintenance page#482

Merged
philmerrell merged 1 commit into
developfrom
feature/docs-maintenance-page
Jun 17, 2026
Merged

feat(docs): add full-screen maintenance page#482
philmerrell merged 1 commit into
developfrom
feature/docs-maintenance-page

Conversation

@philmerrell

Copy link
Copy Markdown
Contributor

What

Adds a standalone, full-screen maintenance splash to the docs site at /maintenance, to route users to during downtime for migrations.

New file: docs-site/src/pages/maintenance.astro

Why this location

The page lives in src/pages/ rather than src/content/docs/, which means it's outside Starlight's content collection. As a result it:

  • Never appears in the sidebar/menu or any autogenerated nav — it's only reachable by navigating directly to the URL (the explicit ask).
  • Renders without Starlight chrome (no header, sidebar, or TOC), so it's genuinely full-screen.
  • Is excluded from the Pagefind search index, and carries <meta name="robots" content="noindex, nofollow">.

Design

Self-contained markup + styles (no dependency on the Starlight CSS, so it renders even if nothing else on the site loads), matching the docs/SPA house style:

  • Boise State brand blue (#0033a0) on brand-tinted near-black
  • Drifting lava-lamp blob field + graph-paper grid backdrop (lifted from the docs theme)
  • Frosted-glass panel, compass-star brand mark, gradient-ink Bricolage Grotesque headline
  • "Scheduled maintenance" pill with a pulsing Bronco-orange status orb
  • Indeterminate progress shimmer, a "Try again" button (reloads), and a "Status & updates" link
  • Responsive (buttons stack on mobile) and honors prefers-reduced-motion

Verification

  • npm run build succeeds (51 pages); emits to dist/maintenance/index.html
  • Route returns 200, no console errors
  • Verified via preview (desktop + mobile screenshots)
  • Confirmed no page in the built site links to the route — only directly navigable

Reviewer notes

  • Starlight's auto-sitemap does list the URL (sitemaps include all routes); the noindex, nofollow meta is the standard guard there. The menu — the actual requirement — is clean. Happy to add an explicit @astrojs/sitemap filter to strip it from sitemap.xml if preferred.
  • Wording/copy is easy to tweak if you'd like a different tone or an ETA field.

🤖 Generated with Claude Code

Adds a standalone, directly-navigable maintenance splash at
/maintenance for use during migration downtime. It lives in
src/pages/ (outside Starlight's content collection), so it never
appears in the sidebar/nav and renders without Starlight chrome —
reachable only by navigating to the URL directly.

Self-contained markup + styles (works even if nothing else loads)
matching the docs/SPA house style: Boise blue, frosted glass,
lava-lamp blob field, graph-paper grid, Bricolage display type, a
pulsing Bronco-orange status orb, and an indeterminate progress
shimmer. Responsive, honors prefers-reduced-motion, and carries
noindex/nofollow so crawlers skip it.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@philmerrell philmerrell merged commit d2b9502 into develop Jun 17, 2026
1 check passed
philmerrell added a commit that referenced this pull request Jun 17, 2026
The maintenance splash (added in #482) is purely informational, so
the "Try again" reload button and "Status & updates" link add no
real value on a static page. Drop both buttons along with the now-
unused click handler script and the .actions/.btn CSS, leaving the
status pill, headline, message, progress shimmer, and sign-off.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
philmerrell added a commit that referenced this pull request Jun 17, 2026
The maintenance splash (added in #482) is purely informational, so
the "Try again" reload button and "Status & updates" link add no
real value on a static page. Drop both buttons along with the now-
unused click handler script and the .actions/.btn CSS, leaving the
status pill, headline, message, progress shimmer, and sign-off.

Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant