How dinil-thilakarathne/sona-ui works
Sona UI combines a component catalog and documentation site with a source-owned React component registry that users install by copying code through the shadcn CLI. The primary journey is browse the catalog, inspect documentation and live previews, then install a selected component. Separate capabilities include AI-agent discovery resources, Motion Lab tuning, and GitHub-backed site data. The graph uses README statements and the supplied source index; unsampled modules are represented only where their role is documented or evident from the tree.
Main entry points: component-preview.tsx Live Preview · sonaui Component Sources · component-preview-server.tsx Preview Resolver · page.tsx Component Catalog
Components 23
Catalog and Docs
- Component Catalog
src/app/components/page.tsx - Docs Navigation
src/config/components.ts - Documentation Search
src/hooks/useSearch.ts - Component Documentation
src/components/docs-focus/docs-focus-shell.tsx - Component Showcase
src/components/component-showcase/component-showcase.tsx
Preview and Tuning
- Preview Resolver
src/components/common/component-preview-server.tsx - Live Preview
src/components/common/component-preview.tsx - Dialog Tuning
src/components/docs-focus/animated-dialog-tuning.tsx - Motion Lab
src/components/motion-lab/motion-lab.tsx - Motion Presets
src/lib/motion-lab/dialog-motion.ts
Component Registry
- Component Sources
src/registry/sonaui - Registry Index
src/registry/index.ts - Source File API
src/app/api/read-file/route.ts
Agent Resources
- Agent Catalog
src/registry/agent-metadata.ts - Agent Markdown
src/lib/agent-markdown.ts - Agent Routes
src/proxy.ts
Site Services
- Contributions API
src/app/api/github-contributions/route.ts - Contribution Data
src/lib/github-contributions.ts - Star History API
src/app/api/github-star-history/route.ts - Star History Data
src/lib/github-star-history.ts
Other components
- Developer
- shadcn CLI
- GitHub
Connections 23
- Developer → Component Catalog: browses
README.md - Component Catalog → Component Showcase: renders
src/app/components/page.tsx - Developer → Component Documentation: opens docs
README.md - Component Documentation → Docs Navigation: uses navigation
- Developer → Documentation Search: searches docs
- Documentation Search → Docs Navigation: filters slugs
src/hooks/useSearch.ts - Component Showcase → Registry Index: loads registry preview
- Preview Resolver → Registry Index: resolves component
src/components/common/component-preview-server.tsx - Preview Resolver → Live Preview: renders preview
src/components/common/component-preview-server.tsx - Live Preview → Dialog Tuning: uses tuning controls
src/components/common/component-preview.tsx - Live Preview → Component Sources: previews component
src/components/common/component-preview.tsx - Developer → Motion Lab: tunes motion
README.md - Motion Lab → Motion Presets: uses presets
- Developer → shadcn CLI: installs component
README.md - shadcn CLI → Component Sources: copies source
README.md - Developer → Agent Catalog: discovers components
README.md - Agent Routes → Agent Markdown: serves markdown
src/proxy.ts - Developer → Source File API: requests source
src/app/api/read-file/route.ts - Source File API → Component Sources: reads source
src/app/api/read-file/route.ts - Contributions API → Contribution Data: fetches data
src/app/api/github-contributions/route.ts - Star History Data → GitHub: requests history
- Star History API → Star History Data: fetches history
src/app/api/github-star-history/route.ts - Contribution Data → GitHub: requests contributions