Refresh homepage copy, add home styles, and reorganize sidebar

[ldoubil]

Motivation

• Refresh the homepage messaging and layout to better explain Astral as a P2P/VPN-style virtual LAN tool and highlight common scenarios.
• Add a dedicated homepage style sheet to support scenario cards, platform pills, and sponsor visuals for a more polished landing experience.
• Improve quick-start and install copy so steps are clearer and platform support is explicit.
• Reorganize the Starlight sidebar to surface core sections and FAQs for easier navigation.

Description

• Update src/content/docs/index.mdx to rewrite hero copy, add intro/scenario/platform sections, and replace inline sponsor markup with a structured sponsor card.
• Add src/styles/home.css containing styles for the homepage intro, scenarios grid, platform pills, and sponsor card.
• Tweak quick-start docs in src/content/docs/quick-start/what-is-astral.mdx and download-install.mdx to clarify purpose, platforms, and installation steps.
• Rework astro.config.mjs sidebar structure and fix FAQ slugs (changed to faq/nat and faq/ping-issues) so Starlight navigation resolves correctly.

Testing

• Ran the dev server with npm run dev which reported the site ready (astro v5.9.3 ready) after resolving an initial sidebar slug error.
• Fixed the slug mismatch (FAQ/Nat → faq/nat) and re-ran the dev server to confirm content sync succeeded.
• Captured an automated Playwright screenshot of the homepage which produced artifacts/astral-home.png, indicating the page rendered successfully.
• Changes were committed and no automated test failures occurred during the above validation steps.

---

Codex Task

[vercel]

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

Project	Deployment	Review	Updated (UTC)
astral-github-io	Ready	Preview, Comment	Jan 7, 2026 10:33am