Skip to content

feat: docs landing page — Phase platform diagram - #246

Open
nimish-ks wants to merge 1 commit into
mainfrom
feat--at-a-glance-diagram
Open

feat: docs landing page — Phase platform diagram#246
nimish-ks wants to merge 1 commit into
mainfrom
feat--at-a-glance-diagram

Conversation

@nimish-ks

Copy link
Copy Markdown
Member

The docs landing page becomes a single diagram that maps the whole platform — and doubles as a map of the docs.

What changed

/ is now The Phase platform: heading, a three-line lead, and the diagram. Removed from the page: the Import/Automate/Share/Manage bullets, the console screenshot, <About />, Integrate Phase, Self-host Phase and Ready to try (plus their now-dead imports). Get started + <Platform /> stay.

The diagram

Ported from the website's HowPhaseWorks export sheet as a native component, not an image — so it follows the docs theme toggle, stays vector-crisp at any DPI, and keeps real selectable text. Every colour token is a light/dark pair.

Four hue-coded bands, with the store as the hub:

Band Contents
Access (sky) the develop → build → deploy → run axis, with AI agents, CLI, SDK · API, CI, Terraform and the Kubernetes operator hanging off it; each drops a trace into the store
Store (emerald) app › environment › path › key/value — the three rows are the type legend (config visible, secret masked with a reveal, sealed write-only)
Automate (violet) rotation, dynamic secrets, syncs; three traces drop from the store
Control & monitor (amber) authentication, network access policies, audit logs — cross-cutting, so no traces

Twelve cell titles are links, underlined on hover/focus, so the sheet is navigable: agents → Claude Code, CLI → /cli, SDK · API → /sdks, CI → GitHub Actions, Terraform, Kubernetes, Rotation → /console/rotating-secrets, Dynamic secrets, Syncs → /integrations, Authentication, Network access policies, Audit logs → /console/apps#logs.

Semantic accents are borrowed from the website rather than invented: lease-ledger dots (active / expiring / revoked), [SYNCED] statuses, the amber sealed lock, amber prompts, and the Govern chapter's IP allow-list chips. Static — no motion.

Notes

  • Laid out for ≥1000px; below that it scrolls horizontally inside its own wrapper (same xl:max-w-none opt-out Platform/PlatformsIntegration use). No page-level overflow.
  • src/components/icons/AgentIcons.jsx carries the Claude / Cursor / OpenCode marks (no Simple Icons entries), generated from the website's paths; Tailscale is a small inline dot-grid.
  • Verified on the running docs in both themes at 1440px, and a title click navigating (CLI/cli). Lint clean.

Open questions for you

  1. The sidebar entry for / still says Introduction (Navigation.jsx:208) — rename to match the page?
  2. <Platform /> (the Console/CLI/API/SDKs cards) is kept, but the Access band now covers similar ground — keep or drop?
  3. Agents has no index page so that title lands on Claude Code, and Syncs points at /integrations — happy to repoint either.

Replaces the Introduction landing page with a single swiss drafting-sheet
diagram that maps the whole platform, ported from the website's
HowPhaseWorks export sheet as a native component (not an image), so it
follows the docs theme toggle and stays vector-crisp.

Four hue-coded bands with the store as the hub:
- Access (sky) — the develop → build → deploy → run axis with AI agents,
  CLI, SDK/API, CI, Terraform and the Kubernetes operator hanging off it
- Store (emerald) — app / environment / path / key-value, and the three
  secret types shown as the rows themselves (config, secret, sealed)
- Automate (violet) — rotation, dynamic secrets, syncs
- Control & monitor (amber) — authentication, network access policies,
  audit logs

Every cell title links to its docs section, underlined on hover, so the
sheet doubles as a map of the docs. Semantic accents mirror the website:
lease-ledger dots, sealed amber, prompt carets, IP allow-list chips.

Page trimmed to the diagram plus Get started: the lead bullets, console
screenshot, About, Integrate Phase, Self-host Phase and Ready to try
sections are removed (with their now-dead imports).
@nimish-ks nimish-ks self-assigned this Aug 17, 2026
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Aug 17, 2026

Copy link
Copy Markdown

Deploying phase-docs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1d9626f
Status: ✅  Deploy successful!
Preview URL: https://62ca1585.phase-docs.pages.dev
Branch Preview URL: https://feat--at-a-glance-diagram.phase-docs.pages.dev

View logs

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