Skip to content

feat(site): make quickstart the first-success path#43

Draft
frankxai wants to merge 1 commit into
mainfrom
agent/claude/starlight-proof-first-night-20260717
Draft

feat(site): make quickstart the first-success path#43
frankxai wants to merge 1 commit into
mainfrom
agent/claude/starlight-proof-first-night-20260717

Conversation

@frankxai

Copy link
Copy Markdown
Owner

Why

The homepage already proves the Starlight system with a real release-room console, but its primary action skipped the existing first-success path. This makes /quickstart the clear next step without redesigning the proof surface.

Changes

  • route the mobile and desktop primary hero action to /quickstart
  • keep the starter download as the secondary action
  • add Quickstart to the product-route grid with a factual outcome
  • replace internal/changelog-style product-route copy with public-facing guidance

Verification

  • node_modules/.bin/eslint src/app/page.tsx — pass
  • node_modules/.bin/tsc --noEmit — pass
  • git diff --check — pass
  • verified /quickstart and /download route files exist
  • pre-push Vercel check: no in-flight deployment; latest deployments were Ready

Resource gate

Local production build was intentionally held because Yogabook remains in CRITICAL storage mode (<50 GiB). The draft preview/build is the cloud boundary; do not mark ready until it and visual QA pass.

Scope

One source file. No dependencies, media, lockfile, private telemetry, DNS, or production mutation.

@vercel

vercel Bot commented Jul 17, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
site Ready Ready Preview, Comment Jul 17, 2026 3:44am

@coderabbitai

coderabbitai Bot commented Jul 17, 2026

Copy link
Copy Markdown

Important

Review skipped

Draft detected.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 345fe016-b59d-41a8-8181-7102780e90ff

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

  • 🔍 Trigger review
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch agent/claude/starlight-proof-first-night-20260717

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Code Review

This pull request updates the home page to promote the new Quickstart guide, replacing the primary "Download starter" call-to-action with a "Start in 5 minutes" link to /quickstart and shifting the download link to the secondary action. Feedback on these changes suggests using the Zap icon instead of Terminal for the Quickstart card to avoid duplication with the Cockpit card, and updating the button copy to "Start in 2 minutes" to maintain consistency with the Quickstart page's own time estimates.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread site/src/app/page.tsx
href: "/quickstart",
title: "Quickstart",
desc: "Install the MCP server, configure your tool, and write your first vault entry.",
icon: Terminal,

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

The Terminal icon is already used for the Cockpit route card in the same grid (line 195). To avoid visual repetition and improve clarity, consider using a distinct icon such as Zap for the Quickstart route.

Note: Remember to add Zap to the lucide-react imports at the top of the file.

Suggested change
icon: Terminal,
icon: Zap,

Comment thread site/src/app/page.tsx
className="inline-flex min-h-12 w-full items-center justify-center gap-2 rounded-md bg-slate-950 px-5 py-3 text-sm font-semibold text-white shadow-[0_12px_32px_rgba(15,23,42,0.25)] transition-micro hover:bg-slate-800"
>
Download starter
Start in 5 minutes

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

There is a discrepancy in the estimated time for the quickstart process. The button here says "Start in 5 minutes", whereas the Quickstart page (site/src/app/quickstart/page.tsx) repeatedly references 2 minutes (e.g., "Two minutes to compound intelligence", "Install Starlight Intelligence in 2 minutes").

To maintain consistency in user expectations and brand messaging, consider aligning this to 2 minutes.

Suggested change
Start in 5 minutes
Start in 2 minutes

Comment thread site/src/app/page.tsx
className="inline-flex min-h-12 items-center justify-center gap-2 rounded-md bg-slate-950 px-5 py-3 text-sm font-semibold text-white shadow-[0_12px_32px_rgba(15,23,42,0.25)] transition-micro hover:bg-slate-800"
>
Download starter
Start in 5 minutes

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

medium

Aligning this button copy with the Quickstart page's 2-minute estimate for consistency.

Suggested change
Start in 5 minutes
Start in 2 minutes

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