Skip to content

docs: refresh the 'Why Panda' page - #3681

Merged
segunadebayo merged 1 commit into
chakra-ui:v2from
Adebesin-Cell:docs/refresh-why-panda
Jul 24, 2026
Merged

docs: refresh the 'Why Panda' page#3681
segunadebayo merged 1 commit into
chakra-ui:v2from
Adebesin-Cell:docs/refresh-why-panda

Conversation

@Adebesin-Cell

@Adebesin-Cell Adebesin-Cell commented Jul 23, 2026

Copy link
Copy Markdown
Collaborator

📝 Description

Refreshes and expands the Why Panda front-door page to make the full case for Panda, in TONE_OF_VOICE.md — lead with the point, show instead of sell, cut the hype.

⛳️ Current behavior (updates)

The page is short and off-tone. It opens with hype the tone guide tells us to cut — "powerful features", "unique approach", "optimized for performance and readability", "great developer experience" — and still frames Panda around v1: "static analysis + PostCSS plugins" and "any framework that supports PostCSS".

🚀 New behavior

Rewrites the page to argue the whole system, each pillar shown with a real example:

  • What it is and the problem it solves — the runtime CSS-in-JS cost, the RSC/server-first break, and the trade-offs of utility-class frameworks.
  • A design system, not just a styling library — tokens, semantic tokens, recipes, patterns, conditions, and shipping the whole thing as a package with panda lib + designSystem.
  • Write it your way — the css function or JSX style props, both extracting to the same atoms.
  • Type-safe from your config — autocomplete for your tokens, strictTokens, recipe-variant prop types.
  • Output you can reason about — atomic CSS that plateaus, predictable cascade-layer overrides, optimize pruning of unused tokens/keyframes, a runtime that can disappear on pre-render.
  • Fast, native builds — the Rust/Oxc hot path, one parse per file, smaller install, same CSS, WASM for the browser.
  • Works with your stack — frameworks + bundler plugins + CLI, plus compiled-JSX and .vue/.svelte/.astro extraction.
  • Dynamic styles when you need them, the honest "when not to use Panda", and the token-generator use case.

Prose only — no API or behavior changes.

💣 Is this a breaking change (Yes/No):

No. Docs only.

📝 Additional Information

All internal links resolve on v2. None of the tone guide's flagged hype words remain. velite --clean builds green.

Note: PR #3679 also edits why-panda.mdx (a small pointer to the new "Thinking in Panda" page). Whichever lands second needs a trivial rebase on this file.

@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated (UTC)
panda-docs Error Error Jul 23, 2026 4:27pm

Request Review

@vercel

vercel Bot commented Jul 23, 2026

Copy link
Copy Markdown

@Adebesin-Cell is attempting to deploy a commit to the Chakra UI Team on Vercel.

A member of the Team first needs to authorize it.

@changeset-bot

changeset-bot Bot commented Jul 23, 2026

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 63a4c56

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

Rewrite the front-door page to make the full case for Panda in
tone-of-voice. Cover every value pillar with a real example: the design
system (tokens, semantic tokens, recipes, patterns, shipping via
panda lib), css vs JSX style props, type safety, atomic output and
optimize pruning, the Rust/Oxc build path, framework/bundler reach
including compiled JSX and SFCs, and dynamic-style escape hatches. Drop
the v1 PostCSS-engine framing and the hype words the tone guide flags.
@Adebesin-Cell
Adebesin-Cell force-pushed the docs/refresh-why-panda branch from 6eff22d to 63a4c56 Compare July 23, 2026 16:26
@segunadebayo
segunadebayo merged commit b3c78e6 into chakra-ui:v2 Jul 24, 2026
5 of 9 checks passed
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.

2 participants