Skip to content

Put the whole help center on kite.ai's blue sky - #22

Merged
salevine merged 2 commits into
mainfrom
docs/sky-card-layout
Oct 26, 2026
Merged

salevine merged 2 commits into
mainfrom
docs/sky-card-layout

Conversation

@salevine

Copy link
Copy Markdown
Contributor

Summary

#21 restyled the navbar and footer, but the page stayed off-white, so the docs still did not feel like kite.ai. This puts the whole help center on kite.ai's blue sky.

  • The page sits on a blue gradient. Sidebar, table of contents and footer are white text on the sky.
  • The article is a rounded white card, so long pages, screenshots and code stay easy to read.
  • Search, 404 and generated category pages (such as /website-building) use the same card.
  • Dark mode uses a night-sky gradient with a navy card.
  • The current page in the sidebar and table of contents gets a glass pill, like kite.ai's nav.
  • Everything on the sky has a white keyboard focus ring.

The sky is a little deeper than kite.ai's. Its lighter colors fail contrast for white text. This one passes WCAG AA everywhere (5.1:1 or better).

Notes for reviewers

  • The card selectors use stable markup (main > .container > .row > .col:first-child), not Docusaurus's hashed module classes. Pages without a table of contents keep the card. Re-check the card after Docusaurus upgrades or if DocItem/Layout or DocRoot is swizzled.
  • The navbar has no backdrop-filter on purpose. It would clip the mobile drawer to the navbar's height.
  • The mobile drawer menu stays on the light background.

Validation

  • npm run build passes.
  • A script applied the card selectors to all 67 built pages. Each has exactly one card, with nothing left on the sky. With the old selectors, the same script flagged /website-building.
  • Contrast script: every text and background pair on the sky passes AA in light and dark mode.
  • Checked in Chrome:
    • Desktop, light and dark mode.
    • 390px wide: doc, search and 404 pages, with no sideways scroll.
    • The open mobile drawer fills the full height.
    • /website-building in a card.
  • No test suite exists for this site.

🤖 Generated with Claude Code

The first restyle kept an off-white page, so the docs still did not
feel like kite.ai. Now the whole page sits on a blue gradient:

- Sidebar, table of contents and footer are white text on the sky.
- The article is a rounded white card, so long pages, screenshots and
  code stay easy to read.
- Search, 404 and generated category pages use the same card.
- Dark mode uses a night-sky gradient with a navy card.

The sky is a little deeper than kite.ai's so white text passes WCAG AA
everywhere on it (5.1:1 or better). The current page in the sidebar
and table of contents gets a glass pill, and everything on the sky has
a white focus ring.

The card selectors use stable markup, not Docusaurus's hashed module
classes, so pages without a table of contents keep the card. The navbar
has no backdrop-filter: it would clip the fixed mobile drawer to the
navbar's height.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vercel

vercel Bot commented Oct 26, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
kite-docs Ready Ready Preview Oct 26, 2026 8:01pm UTC

Request Review

The docs blue was deeper than kite.ai's, and dark mode showed a near-black
card. Now:

- The page uses kite.ai's own sky: four soft white cloud glows over its
  blue gradient. It is 3300px tall like kite.ai's pricing page, does not
  repeat, and long pages continue in the sky's last color.
- The sidebar, table of contents and footer copyright sit on navy glass
  panels. kite.ai's blue is too light for white text on its own (as low
  as 2:1 under the clouds). On the glass, white text is at least 4.9:1.
  Navy, not black, so the panels stay blue.
- The navbar is solid sky blue. The search pill uses kite.ai's 0.3 nav
  pill glass.
- Light only, like kite.ai: no theme toggle, and Docusaurus clears any
  dark-mode choice a visitor saved. All dark-mode CSS is removed.

Fixes:

- "Try Kite" lost its right padding once it became the last navbar item.
- The Coming soon badge dropped below AA when Ask AI was hovered.
- The table of contents focus ring is drawn inside the link so it stays
  on the glass.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@salevine
salevine merged commit 3e85cea into main Oct 26, 2026
2 checks passed

This branch was successfully deployed

1 active deployment
Preview — a9f2a239 Deployed Oct 26, 2026 by vercel[bot]
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