Skip to content

feat(platform): add a welcome page with connection instructions - #390

Merged
cpojer merged 2 commits into
mainfrom
platform-welcome
Oct 8, 2026
Merged

cpojer merged 2 commits into
mainfrom
platform-welcome

Conversation

@mhart

@mhart mhart commented Oct 8, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Add a useful landing page at a Void platform's API root, which previously returned 404. The page uses the same minimal, server-rendered HTML styling as first-administrator setup, with no React or client-side JavaScript.

  • Show the configured platform name, CLI installation and platform-specific connection instructions, sign-in/deployment guidance, and links to administration and the Void quickstart.
  • Retain the existing Cloudflare Access and platform lifecycle gates; escape the platform identity and derive the connection URL from the configured identity or request origin.
  • Update the platform API and first-deployment documentation, with regression coverage for the welcome page.

The first commit fixes a timezone-dependent test failure encountered during verification:

  • Persist UTC as the cached PGlite template's default timezone and invalidate previous templates.
  • Compare database timestamps in SQL rather than interpreting timezone-less strings in the JavaScript process's local timezone.
  • Add a subprocess regression that creates the template under Melbourne time and reuses it under Los Angeles time, plus maintainer guidance in TESTING.md.

Screenshot

Captured from the actual API response using Playwright with JavaScript disabled. The example API origin is https://api.example.com.

Platform welcome page

Verification

  • pnpm exec vp run build:all
  • pnpm exec vp run check
  • pnpm exec vp lint
  • pnpm exec vp run lint:platform
  • pnpm exec vp fmt --check
  • pnpm exec vp run build:docs
  • node test/check-playground-build-artifacts.mjs
  • Focused onboarding/Access regressions: 25 passed.
  • Focused timezone regressions: 52 passed in the local Melbourne timezone; the previously failing assertions also pass under UTC using the same cached template.
  • pnpm exec vp run test: 3,918 passed, 19 skipped.
  • pnpm exec vp test run: 13,065 passed, 32 skipped; the Astro dev-server suite timed out during startup. Its isolated rerun (pnpm exec vp test run packages/void/test/integration/astro.test.ts) passed all 3 tests.

Commits

  1. fix(test): make platform database tests timezone-independent
  2. feat(platform): add a welcome page with connection instructions

@cloudflare-workers-and-pages

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://platform-welcome-void-cloud.voidzero-docs.workers.dev (commit 214acda)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://23e9820e-void-cloud.voidzero-docs.workers.dev 214acda 2026-10-08T07:04:42.447Z Visit the dashboard ↗

@cpojer cpojer left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome, thank you!

@cpojer
cpojer merged commit b0f57f3 into main Oct 8, 2026
20 checks passed
@cpojer
cpojer deleted the platform-welcome branch October 8, 2026 07:13
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.

2 participants