Skip to content

docs: rewrite the introduction around the project purpose - #688

Merged
mehdibha merged 2 commits into
mainfrom
claude/intro-rewrite-af4e9e
Sep 1, 2026
Merged

docs: rewrite the introduction around the project purpose#688
mehdibha merged 2 commits into
mainfrom
claude/intro-rewrite-af4e9e

Conversation

@mehdibha

Copy link
Copy Markdown
Owner

What changed

Rewrites the docs introduction (www/content/docs/(root)/index.mdx) with a simpler, less formal tone focused on the project's purpose rather than technical details. Tone modeled on the shadcn/ui introduction.

  • Opens with the purpose: "dotUI is not a component library. It's how you build your own design system" — the familiar problem (every app looks the same, fighting the library) before the solution.
  • Adds a 3-step "How it works" (compose → preview → export) replacing the dense feature paragraph.
  • Cuts the technical sections: "API philosophy", the primitives comparison, and the foundational-layer (Radix/Base UI/React Aria) discussion, condensed into one short "What's inside" paragraph.
  • Keeps the interactive playground demo and the example grid under "Docs that show, not tell".
  • "Built for AI" trimmed to two casual sentences as "Works great with AI".

Reviewer notes

Content-only change; the <CompositionAnimation /> component is no longer referenced from this page but its source is untouched.

@vercel

vercel Bot commented Aug 31, 2026

Copy link
Copy Markdown

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

Project Deployment Actions Updated
dotui Ready Ready Preview Sep 1, 2026 5:49pm UTC

@github-actions github-actions Bot added documentation Improvements or additions to documentation area: www The dotui.org app: site, landing, docs pages labels Aug 31, 2026
@claude

claude Bot commented Aug 31, 2026

Copy link
Copy Markdown

Code review

No issues found. Checked for bugs and CLAUDE.md compliance.

@mehdibha
mehdibha merged commit c93ea8e into main Sep 1, 2026
11 checks passed
@mehdibha
mehdibha deleted the claude/intro-rewrite-af4e9e branch September 1, 2026 19:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area: www The dotui.org app: site, landing, docs pages documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant