Skip to content

docs: reframe homepage as the Design Systems Styling Engine#304

Open
alexgrozav wants to merge 1 commit into
mainfrom
agent/larousse/516b3743
Open

docs: reframe homepage as the Design Systems Styling Engine#304
alexgrozav wants to merge 1 commit into
mainfrom
agent/larousse/516b3743

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

Implements the homepage reframe from SF-14 (Maître's approved proposal, Alex signed off). PR to Étoile for review.

What changed

  • apps/docs/content/index.md:
    • Hero — H1 "The styling engine for your design system"; new subhead; frontmatter title/description carry the category line + meta/social one-liner. Kept the styleframe.config.ts snippet and both CTAs.
    • Reordered to the story spine: one source of truth → typed → zero-runtime → every bundler → scanner/figma. Section titles/intros retargeted to the engine framing.
    • Bundler copy corrected to the real nine: Vite, Nuxt, Webpack, Rollup, esbuild, Rspack, Farm, Astro, Bun (proposal's eight omitted Bun).
    • AI section kept as Coming Soon.
  • apps/docs/nuxt.config.tssite.name (ogSiteName / meta category line) → "Styleframe — The Design Systems Styling Engine".

Interpretation notes for review

  • Beats B (typed) and D (bundlers) are carried as reframed feature cards inside the "one source of truth" grid, not as new standalone demo sections — the repo has no existing typed/bundler demo to promote, and fabricating one would break the "no example ships unrun" rule. If a dedicated section is wanted, it needs a real demo from the owning seat.
  • Composability + Theming sections kept (not deleted) and folded under the "one source of truth" beat — mise didn't ask to cut them and they carry good interactive demos.
  • Proof-point links: /figma and /scanner resolve; the typed proof links to /docs/api, the bundler proof to /docs/getting-started/installation. "playground" and "testing/integration" have no public doc route, so I linked to the closest resolvable docs pages rather than invent links.

Findings (not blocking this PR)

  • testing/integration does not enumerate bundlers — it scaffolds a Vite-only app tested cross-browser. The authoritative bundler set is the @styleframe/plugin export map (tooling/plugin/package.json + src/*.ts), which is where I verified the nine.
  • The docs-craft skill says to verify with pnpm --filter @styleframe/docs typecheck, but @styleframe/docs has no typecheck script. Docs verify via build. Flagging for a skill fix.
  • content/docs/02.api/13.imports.md and 14.imports.md list only five bundlers as "all supported build tools" — incomplete vs the nine. Small drift, filed for a follow-up.

Verification

  • pnpm install && pnpm build:nodocs — spine built (plugin adapters incl. bun compiled).
  • pnpm --filter @styleframe/docs buildbuild complete, MDC/frontmatter valid, homepage prerendered with the new copy.
  • Links: every touched route verified against apps/docs/.data/content/contents.sqlite (11/11 resolve, count=1 each).
  • npx oxlint apps/docs/nuxt.config.ts — ok.
  • No changeset (@styleframe/docs is in the changesets ignore list).

Closes acceptance for the docs half of SF-14.

Lead with the category positioning ("The styling engine for your design
system") and reorder the page to the story spine: one source of truth →
typed → zero-runtime → every bundler → scanner/figma. Correct the bundler
list to the real nine (adds Bun) and set the meta category line.
@changeset-bot

changeset-bot Bot commented Jul 12, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: db50e67

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

@vercel

vercel Bot commented Jul 12, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
storybook-styleframe-dev Building Building Preview Jul 12, 2026 3:54pm
styleframe-dev Ready Ready Preview, Comment Jul 12, 2026 3:54pm

Request Review

@codecov

codecov Bot commented Jul 12, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

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