docs(www): draft RC blog + announcement badge + TOC progress

[yamcodes]

Summary

RC blog + site chrome for the RC window:

1. Hero announcement — sentence chip (v1 RC is out — what's new) → /blog/arkenv-v1-rc
2. Docs TOC rail — Enjoying ArkEnv? first, then v1 roadmap progress meter at the bottom
3. Blog — TanStack Start–style publishable prose at apps/www/content/blog/arkenv-v1-rc.mdx with draft: false so the hero CTA resolves in production

Pullfrog

• Draft→404: undrafted + reader-facing description (prose already shipped)
• Banner plumbing: confirmed dropped in 658168fb; no fumadocs-ui diff vs v1; threads replied + resolved

Blog sections

• Open: RC status + latest / docs apex / v0 archive
• Why this matters
• What’s in v1
• Get started or upgrade
• If you’re on v0
• Path to 1.0 stable
• Your feedback counts

Verification

• Unit tests: release-channel-badge + roadmap-progress-card
• draft: false; OG description is reader-facing
• No unused sidebar.banner pass-through reintroduced
• TOC order: star/Enjoying above roadmap progress (db12ba01)

[changeset-bot]

⚠️ No Changeset found

Latest commit: 9c2cab4

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

[pullfrog]

Important

The new hero announcement points at /blog/arkenv-v1-rc, but that post is still draft: true, so in production the homepage CTA resolves to a 404. Un-draft it (and swap the internal "Outline for…" description for public copy) before this ships, or keep the badge on the migration guide until the post is live.

Reviewed changes

• Hero announcement retargeted — ReleaseChannelBadge href moves from /docs/guides/migrating-to-v1 to /blog/arkenv-v1-rc; its unit test is updated to match.
• Roadmap meter relocated — RoadmapProgressCard stops wrapping AnnouncementBadge and becomes a bordered next/link card; the homepage hero drops it, and app/docs/layout.tsx renders it via Fumadocs sidebar.banner.
• fumadocs-ui banner plumbing — DrillInSidebar now forwards SidebarProps.banner into the desktop DrillInNav and the mobile AccordionNav instead of discarding it (_banner).
• Draft RC blog outline — apps/www/content/blog/arkenv-v1-rc.mdx added with draft: true, covering RC status, newcomer bullets, v0 migration, and links to the migration guide.

ℹ️ Nitpicks

• The MDX description (Outline for the v1 RC announcement — packages, docs cutover, migrating from v0, and what newcomers get.) is an internal note that becomes the public blog lede and OG description once the post is published — replace it with reader-facing copy along with the draft flip.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using DeepSeek Flash (free via Pullfrog for OSS) ｜ 𝕏}

[pkg-pr-new]

Open in StackBlitz

@arkenv/agent-plugin

npm i https://pkg.pr.new/@arkenv/agent-plugin@1898

arkenv

npm i https://pkg.pr.new/arkenv@1898

@arkenv/build

npm i https://pkg.pr.new/@arkenv/build@1898

@arkenv/bun-plugin

npm i https://pkg.pr.new/@arkenv/bun-plugin@1898

@arkenv/core

npm i https://pkg.pr.new/@arkenv/core@1898

@arkenv/fumadocs-ui

npm i https://pkg.pr.new/@arkenv/fumadocs-ui@1898

@arkenv/nextjs

npm i https://pkg.pr.new/@arkenv/nextjs@1898

@arkenv/nuxt

npm i https://pkg.pr.new/@arkenv/nuxt@1898

@arkenv/rsbuild-plugin

npm i https://pkg.pr.new/@arkenv/rsbuild-plugin@1898

@arkenv/standard

npm i https://pkg.pr.new/@arkenv/standard@1898

@arkenv/tanstack-addon

npm i https://pkg.pr.new/@arkenv/tanstack-addon@1898

@arkenv/vite-plugin

npm i https://pkg.pr.new/@arkenv/vite-plugin@1898

commit: a6d4cce

[pullfrog]

Important

The hero announcement still targets /blog/arkenv-v1-rc, which is draft: true — the CTA 404s in production (drafts only render under next dev). This was raised in the prior review and the rebase did not change it.

Reviewed changes

This run covers the delta since the prior pullfrog review (the branch was rebased onto newer v1 and the roadmap meter moved from the sidebar banner to the docs TOC rail).

• Roadmap meter → docs TOC rail — app/docs/[[...slug]]/page.tsx now awaits fetchRoadmap and passes the percent/stale into DocsTocLinks, which renders RoadmapProgressCard between the page-actions nav and DocsStarCard.
• Hero announcement rewritten — ReleaseChannelBadge reads "v1 RC is out — what's new" and links to /blog/arkenv-v1-rc; the export is added to the page barrel and the homepage consumes it.
• Homepage slimmed — app/(home)/page.tsx drops RoadmapProgressCard, fetchRoadmap, and revalidate, becoming a sync component.
• fumadocs-ui banner pass-through retained — DrillInSidebar/AccordionNav render SidebarProps.banner, but the only consumer was removed with the sidebar-banner approach.
• Draft RC blog — arkenv-v1-rc.mdx (unchanged, draft: true).

⚠️ Hero announcement points at an unpublished route

ReleaseChannelBadge links to /blog/arkenv-v1-rc, but the post is draft: true, so getBlogPages() omits it from generateStaticParams/listing and blog/[slug]/page.tsx calls notFound() outside development. Since RELEASE_TAG defaults to "rc", the badge renders in production and the homepage's primary announcement navigates to a 404 — the dev-server check passed only because drafts are visible under next dev.

Technical details

# Announcement CTA points at an unpublished route

## Affected sites
- `apps/www/components/page/release-channel-badge.tsx:14` — `<AnnouncementBadge href="/blog/arkenv-v1-rc" new>`
- `apps/www/content/blog/arkenv-v1-rc.mdx:6` — `draft: true`
- `apps/www/lib/blog-published.ts:10` — drafts published only under `development`
- `apps/www/app/(home)/blog/[slug]/page.tsx:26` — `notFound()` for drafts outside dev
- `apps/www/lib/source.tsx:46` — `getBlogPages()` drives `generateStaticParams`, listing, RSS, sitemap

## Required outcome
- The hero announcement resolves to a real page in the production deployment, or it is not the only announcement.

## Suggested approach
- Flip `draft: false` in this PR and replace the outline-only body/`description` with publishable copy, or point the badge back at `/docs/guides/migrating-to-v1` until the post is live.

ℹ️ drill-in-sidebar.tsx banner support has no consumer

With the meter now in the TOC rail, nothing passes sidebar.banner anywhere in the repo, so the SidebarProps.banner plumbing added to @arkenv/fumadocs-ui is unused here — and the PR description still advertises the sidebar banner. If this is intended as package-level parity with the default Fumadocs sidebar, it needs a changeset; otherwise the change can be dropped from this PR. See the inline note.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using DeepSeek Flash (free via Pullfrog for OSS) ｜ 𝕏}

[arkenv-bot]

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

Project	Deployment	Review	Updated (Asia/Almaty)
arkenv	Ready	Preview, Comment	Sep 21 2026, 4:08 PM (Asia/Almaty)

[pullfrog]

Caution

The hero announcement's /blog/arkenv-v1-rc CTA still 404s in production: the post remains draft: true at 0ab98b8a, even though the prior thread was resolved with a claim of draft: false. See the inline note.

Reviewed changes

This run covers the delta since the prior pullfrog review — the RC blog rewrite in 0ab98b8a (one commit).

• RC blog rewritten to publishable prose — arkenv-v1-rc.mdx replaces the outline with TanStack Start–style sections (why this matters, what's in v1, get started/upgrade, if you're on v0, path to 1.0, feedback) and swaps the internal "Outline for…" description for reader-facing OG copy. Internal doc links and the TanStack Start / CLI init/check claims all check out against the repo.

  ^{｜ Fix all ➔ ｜ Fix 👍s ➔ ｜ View workflow run ｜ Using DeepSeek Flash (free via Pullfrog for OSS) ｜ 𝕏}

[pullfrog]

✅ No new issues found.

Reviewed changes

This run covers the one commit pushed since the prior pullfrog review.

• RC blog published — arkenv-v1-rc.mdx flips draft: true → draft: false, so /blog/arkenv-v1-rc now resolves in production and the hero announcement CTA is no longer a 404. The post is included in generateStaticParams, listing, RSS, and sitemap via isPublishedBlogPage.

  ^{｜ View workflow run ｜ Using DeepSeek Flash (free via Pullfrog for OSS) ｜ 𝕏}

[pullfrog]

✅ No new issues found.

Reviewed changes

This run covers the single commit pushed since the prior pullfrog review.

• TOC rail order — RoadmapProgressCard moved below DocsStarCard, so "Enjoying ArkEnv?" now sits above the roadmap meter at the bottom of the rail; the JSDoc in toc-links.tsx and roadmap-progress-card.tsx was updated to match. The reorder is pure sibling ordering in a flex flex-col gap-3 container with no first:/last: layout coupling, so no spacing or border regression.

  ^{｜ View workflow run ｜ Using DeepSeek Flash (free via Pullfrog for OSS) ｜ 𝕏}