Skip to content

Branded docs homepage, Sandworm announcement bar, and Materialize section#562

Draft
Corey-T1000 wants to merge 2 commits into
mainfrom
docs/promote-materialize
Draft

Branded docs homepage, Sandworm announcement bar, and Materialize section#562
Corey-T1000 wants to merge 2 commits into
mainfrom
docs/promote-materialize

Conversation

@Corey-T1000

Copy link
Copy Markdown

What

A docs refresh in three parts, all on this branch.

Homepage & top nav

  • New docs homepage (components/docs-home.*): developer-focused hero ("Everything you need to build with SpiceDB" + a standfirst that names the reference depth — schema modeling, client SDKs, gRPC/HTTP), an ambient permission-graph animation echoing the SpiceDB pitch-deck visuals (a teal node field with colored "checks" that resolve along the graph), a five-surface Docs Index, and What's New / Releases.
  • Auto light/dark via Sandworm tokens (the homepage was previously dark-only).
  • Announcement bar restyled to match the marketing site's terminal style: mono, sand-300 accents, bracketed CTA, live GitHub star count (server-fetched, cached hourly, with a static fallback), and a cli-spinners "hamburger" cursor that runs a short burst on load, rests, and reruns on hover. Now also shown on the homepage.
  • Navbar logo shows /docs; primary CTA adopts the Sandworm button style (mono, high-contrast fill, magenta on hover).

Materialize

  • Promote Materialize from a single concept page to a top-level section (getting-started / concepts / guides / api); nav (_meta.ts) and inbound links updated.

Fix

  • discovering-spicedb: the HTTP/JSON reference linked to SwaggerHub — now points to the local Swagger page (/spicedb/api/http-api).

Notes

  • Light + dark both verified; animations respect prefers-reduced-motion.
  • This bundles the Materialize promotion with the homepage work since they share _meta.ts / page.mdx; happy to split if reviewers prefer.

🤖 Generated with Claude Code

…section

Homepage & navigation
- New docs homepage (docs-home): developer-focused hero, ambient
  permission-graph animation echoing the SpiceDB pitch deck, a five-surface
  index, What's New + Releases, auto light/dark via Sandworm tokens
- Announcement bar restyled to the marketing terminal style: mono, sand-300
  accents, bracketed CTA, live (hourly-cached) GitHub star count, and a
  cli-spinners "hamburger" cursor that runs on load, rests, and reruns on hover
- Navbar logo shows "/docs"; primary CTA uses the Sandworm button style

Materialize
- Promote Materialize from a single concept page to a top-level section
  (getting-started / concepts / guides / api); update nav and inbound links

Fixes
- discovering-spicedb: HTTP/JSON reference pointed at SwaggerHub; now links to
  the local Swagger page (/spicedb/api/http-api)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@github-actions

Copy link
Copy Markdown
Contributor

CLA Assistant Lite bot:
Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.


I have read the CLA Document and I hereby sign the CLA


You can retrigger this bot by commenting recheck in this Pull Request

@github-actions

github-actions Bot commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Preview deployment status for this pull request.

Name Status Preview Updated (UTC)
docs 🟢 Ready Visit Preview Jun 16, 2026 10:30pm

- Landing-page links 404'd under the deploy's basePath (/docs): the homepage
  used plain <a href="/..."> which Next doesn't prefix. Route internal links
  through next/link (external stay anchors) so basePath is applied.
- The home takeover made the navbar fully transparent (killed the blur bg), so
  scrolled content showed through it. Restore Nextra's themed navbar background;
  only soften the border.

Co-Authored-By: Claude Opus 4.8 (1M context) <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