# isravel/seeyesyes architecture

> Architecture diagram of the GitHub repository isravel/seeyesyes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/isravel/seeyesyes
- Repository: https://github.com/isravel/seeyesyes

## Overview

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: [`lib/data/adapter.ts`](https://github.com/isravel/seeyesyes/blob/master/lib/data/adapter.ts) (Data Adapter), [`lib/data/api.ts`](https://github.com/isravel/seeyesyes/blob/master/lib/data/api.ts) (Mock API), [`lib/data/registry.ts`](https://github.com/isravel/seeyesyes/blob/master/lib/data/registry.ts) (Authored Registry), [`components/theme/ThemeScope.tsx`](https://github.com/isravel/seeyesyes/blob/master/components/theme/ThemeScope.tsx) (Scoped Theme Runtime)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspace["Workspace Views"]
  node_workspace_shell["Workspace Shell<br/>[WorkspaceShell.tsx]"]
  node_component_views["Component Catalog"]
  node_component_detail["Component Detail"]
  node_theme_editor["Theme Editor<br/>[ThemeEditor.tsx]"]
  node_tokens_view["Token Browser<br/>[TokensView.tsx]"]
  node_ai_context["AI Context<br/>[ContextBuilder.tsx]"]
  node_rules_view["Rules Browser<br/>[RulesView.tsx]"]
  node_accessibility_view["Accessibility View"]
  node_validation_view["Demo Validation<br/>[ValidationView.tsx]"]
  node_playground["Theme Playground<br/>[PlaygroundView.tsx]"]
  node_theme_preview["Theme Preview<br/>[ThemePreview.tsx]"]
end

subgraph group_contract["Design Contract"]
  node_registry[("Authored Registry<br/>[registry.ts]")]
  node_schemas["Runtime Schemas<br/>[schema.ts]"]
  node_contract_validation["Contract Validation<br/>[validate.ts]"]
  node_context_export["Context Export<br/>[context.ts]"]
  node_agent_files["Agent Files<br/>[agent-files.ts]"]
  node_readiness["Catalog Readiness<br/>[readiness.ts]"]
end

subgraph group_data["Data Access"]
  node_adapter["Data Adapter<br/>[adapter.ts]"]
  node_mock_api["Mock API<br/>[api.ts]"]
  node_api_route["Read-only API Route<br/>[route.ts]"]
  node_llms_routes["LLM Text Routes<br/>[route.ts]"]
end

subgraph group_theme["Theme Runtime"]
  node_theme_scope["Scoped Theme Runtime<br/>[ThemeScope.tsx]"]
  node_theme_resolver["Theme Resolver<br/>[resolve.ts]"]
  node_theme_state["Theme Persistence<br/>[persistence.ts]"]
end

subgraph group_ui["UI Components"]
  node_ui_primitives["UI Primitives"]
end

node_user(("Workspace User"))

node_user -->|"uses"| node_workspace_shell
node_workspace_shell -->|"provides theme"| node_theme_scope
node_component_views -->|"loads data"| node_adapter
node_component_detail -->|"loads data"| node_adapter
node_theme_editor -.->|"loads data"| node_adapter
node_tokens_view -->|"loads data"| node_adapter
node_ai_context -->|"loads data"| node_adapter
node_rules_view -.->|"loads data"| node_adapter
node_accessibility_view -->|"loads data"| node_adapter
node_validation_view -->|"loads data"| node_adapter
node_playground -.->|"loads data"| node_adapter
node_adapter -->|"uses schemas"| node_mock_api
node_adapter -->|"validates registry"| node_contract_validation
node_mock_api -->|"reads"| node_registry
node_mock_api -->|"validates registry"| node_contract_validation
node_mock_api -->|"builds overview"| node_context_export
node_registry -->|"defines contracts"| node_schemas
node_contract_validation -.->|"checks against"| node_schemas
node_component_views -->|"shows readiness"| node_readiness
node_llms_routes -->|"loads registry"| node_adapter
node_llms_routes -->|"builds text export"| node_agent_files
node_agent_files -->|"uses context"| node_context_export
node_theme_scope -->|"supplies defaults"| node_ui_primitives
node_theme_scope -.->|"restores settings"| node_theme_state
node_registry -->|"resolves tokens"| node_theme_resolver
node_theme_editor -.->|"previews draft"| node_theme_preview
node_theme_preview -->|"renders controls"| node_ui_primitives

click node_workspace_shell "https://github.com/isravel/seeyesyes/blob/master/components/shell/WorkspaceShell.tsx"
click node_component_views "https://github.com/isravel/seeyesyes/blob/master/app/components/ComponentsCatalog.tsx"
click node_component_detail "https://github.com/isravel/seeyesyes/blob/master/app/components/%5Bcomponent%5D/ComponentDetail.tsx"
click node_theme_editor "https://github.com/isravel/seeyesyes/blob/master/app/system/theme/ThemeEditor.tsx"
click node_tokens_view "https://github.com/isravel/seeyesyes/blob/master/app/system/tokens/TokensView.tsx"
click node_ai_context "https://github.com/isravel/seeyesyes/blob/master/app/ai/context/ContextBuilder.tsx"
click node_rules_view "https://github.com/isravel/seeyesyes/blob/master/app/system/rules/RulesView.tsx"
click node_accessibility_view "https://github.com/isravel/seeyesyes/blob/master/app/accessibility/AccessibilityView.tsx"
click node_validation_view "https://github.com/isravel/seeyesyes/blob/master/app/validation/ValidationView.tsx"
click node_playground "https://github.com/isravel/seeyesyes/blob/master/app/playground/PlaygroundView.tsx"
click node_registry "https://github.com/isravel/seeyesyes/blob/master/lib/data/registry.ts"
click node_schemas "https://github.com/isravel/seeyesyes/blob/master/lib/contract/schema.ts"
click node_contract_validation "https://github.com/isravel/seeyesyes/blob/master/lib/contract/validate.ts"
click node_context_export "https://github.com/isravel/seeyesyes/blob/master/lib/contract/context.ts"
click node_agent_files "https://github.com/isravel/seeyesyes/blob/master/lib/contract/agent-files.ts"
click node_readiness "https://github.com/isravel/seeyesyes/blob/master/lib/contract/readiness.ts"
click node_adapter "https://github.com/isravel/seeyesyes/blob/master/lib/data/adapter.ts"
click node_mock_api "https://github.com/isravel/seeyesyes/blob/master/lib/data/api.ts"
click node_api_route "https://github.com/isravel/seeyesyes/blob/master/app/api/%5B...path%5D/route.ts"
click node_llms_routes "https://github.com/isravel/seeyesyes/blob/master/app/llms.txt/route.ts"
click node_theme_scope "https://github.com/isravel/seeyesyes/blob/master/components/theme/ThemeScope.tsx"
click node_theme_resolver "https://github.com/isravel/seeyesyes/blob/master/lib/theme/resolve.ts"
click node_theme_state "https://github.com/isravel/seeyesyes/blob/master/lib/theme/persistence.ts"
click node_ui_primitives "https://github.com/isravel/seeyesyes/tree/master/components/ui"
click node_theme_preview "https://github.com/isravel/seeyesyes/blob/master/app/system/theme/ThemePreview.tsx"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_workspace_shell,node_component_views,node_component_detail,node_theme_editor,node_tokens_view,node_ai_context,node_rules_view,node_accessibility_view,node_validation_view,node_playground,node_theme_preview,node_user toneBlue
class node_registry,node_schemas,node_contract_validation,node_context_export,node_agent_files,node_readiness toneAmber
class node_adapter,node_mock_api,node_api_route,node_llms_routes toneMint
class node_theme_scope,node_theme_resolver,node_theme_state toneRose
class node_ui_primitives toneIndigo
```

## Components

### Workspace Views

- [Workspace Shell](https://github.com/isravel/seeyesyes/blob/master/components/shell/WorkspaceShell.tsx): `components/shell/WorkspaceShell.tsx`
- [Component Catalog](https://github.com/isravel/seeyesyes/blob/master/app/components/ComponentsCatalog.tsx): `app/components/ComponentsCatalog.tsx`
- [Component Detail](https://github.com/isravel/seeyesyes/blob/master/app/components/%5Bcomponent%5D/ComponentDetail.tsx): `app/components/[component]/ComponentDetail.tsx`
- [Theme Editor](https://github.com/isravel/seeyesyes/blob/master/app/system/theme/ThemeEditor.tsx): `app/system/theme/ThemeEditor.tsx`
- [Token Browser](https://github.com/isravel/seeyesyes/blob/master/app/system/tokens/TokensView.tsx): `app/system/tokens/TokensView.tsx`
- [AI Context](https://github.com/isravel/seeyesyes/blob/master/app/ai/context/ContextBuilder.tsx): `app/ai/context/ContextBuilder.tsx`
- [Rules Browser](https://github.com/isravel/seeyesyes/blob/master/app/system/rules/RulesView.tsx): `app/system/rules/RulesView.tsx`
- [Accessibility View](https://github.com/isravel/seeyesyes/blob/master/app/accessibility/AccessibilityView.tsx): `app/accessibility/AccessibilityView.tsx`
- [Demo Validation](https://github.com/isravel/seeyesyes/blob/master/app/validation/ValidationView.tsx): `app/validation/ValidationView.tsx`
- [Theme Playground](https://github.com/isravel/seeyesyes/blob/master/app/playground/PlaygroundView.tsx): `app/playground/PlaygroundView.tsx`
- [Theme Preview](https://github.com/isravel/seeyesyes/blob/master/app/system/theme/ThemePreview.tsx): `app/system/theme/ThemePreview.tsx`

### Design Contract

- [Authored Registry](https://github.com/isravel/seeyesyes/blob/master/lib/data/registry.ts): `lib/data/registry.ts`
- [Runtime Schemas](https://github.com/isravel/seeyesyes/blob/master/lib/contract/schema.ts): `lib/contract/schema.ts`
- [Contract Validation](https://github.com/isravel/seeyesyes/blob/master/lib/contract/validate.ts): `lib/contract/validate.ts`
- [Context Export](https://github.com/isravel/seeyesyes/blob/master/lib/contract/context.ts): `lib/contract/context.ts`
- [Agent Files](https://github.com/isravel/seeyesyes/blob/master/lib/contract/agent-files.ts): `lib/contract/agent-files.ts`
- [Catalog Readiness](https://github.com/isravel/seeyesyes/blob/master/lib/contract/readiness.ts): `lib/contract/readiness.ts`

### Data Access

- [Data Adapter](https://github.com/isravel/seeyesyes/blob/master/lib/data/adapter.ts): `lib/data/adapter.ts`
- [Mock API](https://github.com/isravel/seeyesyes/blob/master/lib/data/api.ts): `lib/data/api.ts`
- [Read-only API Route](https://github.com/isravel/seeyesyes/blob/master/app/api/%5B...path%5D/route.ts): `app/api/[...path]/route.ts`
- [LLM Text Routes](https://github.com/isravel/seeyesyes/blob/master/app/llms.txt/route.ts): `app/llms.txt/route.ts`

### Theme Runtime

- [Scoped Theme Runtime](https://github.com/isravel/seeyesyes/blob/master/components/theme/ThemeScope.tsx): `components/theme/ThemeScope.tsx`
- [Theme Resolver](https://github.com/isravel/seeyesyes/blob/master/lib/theme/resolve.ts): `lib/theme/resolve.ts`
- [Theme Persistence](https://github.com/isravel/seeyesyes/blob/master/lib/theme/persistence.ts): `lib/theme/persistence.ts`

### UI Components

- [UI Primitives](https://github.com/isravel/seeyesyes/tree/master/components/ui): `components/ui`

### Other components

- **Workspace User**

## Connections

- Workspace User → Workspace Shell: uses
- Workspace Shell → Scoped Theme Runtime: provides theme
- Component Catalog → Data Adapter: loads data (evidence: `app/components/page.tsx`)
- Component Detail → Data Adapter: loads data (evidence: `app/components/[component]/page.tsx`)
- Theme Editor → Data Adapter: loads data
- Token Browser → Data Adapter: loads data (evidence: `app/system/tokens/page.tsx`)
- AI Context → Data Adapter: loads data
- Rules Browser → Data Adapter: loads data
- Accessibility View → Data Adapter: loads data (evidence: `app/accessibility/page.tsx`)
- Demo Validation → Data Adapter: loads data (evidence: `app/validation/page.tsx`)
- Theme Playground → Data Adapter: loads data
- Data Adapter → Mock API: uses schemas (evidence: `lib/data/adapter.ts`)
- Data Adapter → Contract Validation: validates registry (evidence: `lib/data/adapter.ts`)
- Mock API → Authored Registry: reads (evidence: `lib/data/api.ts`)
- Mock API → Contract Validation: validates registry (evidence: `lib/data/api.ts`)
- Mock API → Context Export: builds overview (evidence: `lib/data/api.ts`)
- Authored Registry → Runtime Schemas: defines contracts (evidence: `lib/data/registry.ts`)
- Contract Validation → Runtime Schemas: checks against
- Component Catalog → Catalog Readiness: shows readiness (evidence: `app/components/ComponentsCatalog.tsx`)
- LLM Text Routes → Data Adapter: loads registry (evidence: `app/llms.txt/route.ts`)
- LLM Text Routes → Agent Files: builds text export (evidence: `app/llms.txt/route.ts`)
- Agent Files → Context Export: uses context (evidence: `lib/contract/agent-files.ts`)
- Scoped Theme Runtime → UI Primitives: supplies defaults (evidence: `components/ui/link.tsx`)
- Scoped Theme Runtime → Theme Persistence: restores settings
- Authored Registry → Theme Resolver: resolves tokens (evidence: `lib/data/registry.ts`)
- Theme Editor → Theme Preview: previews draft
- Theme Preview → UI Primitives: renders controls (evidence: `app/system/theme/ThemePreview.tsx`)