How isravel/seeyesyes works
SeeYesYes is a design-system workspace and contract browser, not a deployed component package. Its main workflow is to load the authored registry, validate and adapt it for workspace views, then let users inspect components, themes, tokens, rules, accessibility, and demo validation. AI Context and the llms text routes provide export paths. The README documents several connections not fully represented in the sampled source; unsampled view internals are shown as capabilities without speculative call edges.
Main entry points: adapter.ts Data Adapter · api.ts Mock API · registry.ts Authored Registry · ThemeScope.tsx Scoped Theme Runtime
Components 26
Workspace Views
- Workspace Shell
components/shell/WorkspaceShell.tsx - Component Catalog
app/components/ComponentsCatalog.tsx - Component Detail
app/components/[component]/ComponentDetail.tsx - Theme Editor
app/system/theme/ThemeEditor.tsx - Token Browser
app/system/tokens/TokensView.tsx - AI Context
app/ai/context/ContextBuilder.tsx - Rules Browser
app/system/rules/RulesView.tsx - Accessibility View
app/accessibility/AccessibilityView.tsx - Demo Validation
app/validation/ValidationView.tsx - Theme Playground
app/playground/PlaygroundView.tsx - Theme Preview
app/system/theme/ThemePreview.tsx
Design Contract
- Authored Registry
lib/data/registry.ts - Runtime Schemas
lib/contract/schema.ts - Contract Validation
lib/contract/validate.ts - Context Export
lib/contract/context.ts - Agent Files
lib/contract/agent-files.ts - Catalog Readiness
lib/contract/readiness.ts
Data Access
- Data Adapter
lib/data/adapter.ts - Mock API
lib/data/api.ts - Read-only API Route
app/api/[...path]/route.ts - LLM Text Routes
app/llms.txt/route.ts
Theme Runtime
- Scoped Theme Runtime
components/theme/ThemeScope.tsx - Theme Resolver
lib/theme/resolve.ts - Theme Persistence
lib/theme/persistence.ts
UI Components
- UI Primitives
components/ui
Other components
- Workspace User
Connections 27
- Workspace User → Workspace Shell: uses
- Workspace Shell → Scoped Theme Runtime: provides theme
- Component Catalog → Data Adapter: loads data
app/components/page.tsx - Component Detail → Data Adapter: loads data
app/components/[component]/page.tsx - Theme Editor → Data Adapter: loads data
- Token Browser → Data Adapter: loads data
app/system/tokens/page.tsx - AI Context → Data Adapter: loads data
- Rules Browser → Data Adapter: loads data
- Accessibility View → Data Adapter: loads data
app/accessibility/page.tsx - Demo Validation → Data Adapter: loads data
app/validation/page.tsx - Theme Playground → Data Adapter: loads data
- Data Adapter → Mock API: uses schemas
lib/data/adapter.ts - Data Adapter → Contract Validation: validates registry
lib/data/adapter.ts - Mock API → Authored Registry: reads
lib/data/api.ts - Mock API → Contract Validation: validates registry
lib/data/api.ts - Mock API → Context Export: builds overview
lib/data/api.ts - Authored Registry → Runtime Schemas: defines contracts
lib/data/registry.ts - Contract Validation → Runtime Schemas: checks against
- Component Catalog → Catalog Readiness: shows readiness
app/components/ComponentsCatalog.tsx - LLM Text Routes → Data Adapter: loads registry
app/llms.txt/route.ts - LLM Text Routes → Agent Files: builds text export
app/llms.txt/route.ts - Agent Files → Context Export: uses context
lib/contract/agent-files.ts - Scoped Theme Runtime → UI Primitives: supplies defaults
components/ui/link.tsx - Scoped Theme Runtime → Theme Persistence: restores settings
- Authored Registry → Theme Resolver: resolves tokens
lib/data/registry.ts - Theme Editor → Theme Preview: previews draft
- Theme Preview → UI Primitives: renders controls
app/system/theme/ThemePreview.tsx