# digitalaidseattle/component-library architecture

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

- Interactive diagram: https://gitdiagram.com/digitalaidseattle/component-library
- Repository: https://github.com/digitalaidseattle/component-library

## Overview

This is a reusable React component and service library for DAS ventures, accompanied by three example applications. The principal user workflow is to enter an app, navigate to a domain page, and use its components and services to manage data or generate project content. The packages provide shared UI, service contracts, and backend integrations. The tree and excerpts establish the broad capabilities and several key connections; some domain implementations are indexed but unsampled, so those links are omitted where their call paths are not shown.

Main entry points: [`apps/das-admin/src/routes.tsx`](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/routes.tsx) (Admin routes), [`apps/das-firebase/src/App.tsx`](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/App.tsx) (Firebase app), [`apps/das-firebase/src/routes.tsx`](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/routes.tsx) (Firebase routes), [`packages/core/src/api/StorageService.ts`](https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/api/StorageService.ts) (Storage contract)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Example apps"]
  node_admin["Admin demo<br/>[App.tsx]"]
  node_admin_routes["Admin routes<br/>[routes.tsx]"]
  node_ticket_pages["Ticket management"]
  node_storage_page["Storage demo"]
  node_map_page["Mapping demo<br/>[MapPage.tsx]"]
  node_airtable_app["Airtable app<br/>[App.tsx]"]
  node_airtable_routes["Airtable routes<br/>[routes.tsx]"]
  node_venture_page["Venture views<br/>[index.tsx]"]
  node_venture_service["Venture data<br/>[ventureService.ts]"]
  node_firebase_app["Firebase app<br/>[App.tsx]"]
  node_firebase_routes["Firebase routes<br/>[routes.tsx]"]
  node_institution_pages["Institution management<br/>[index.tsx]"]
  node_ai_projects["AI project views<br/>[ProjectPage.tsx]"]
end

subgraph group_ui["Shared UI"]
  node_mui["UI and layouts<br/>[MainLayout.tsx]"]
  node_dragdrop["Drag and drop<br/>[DragAndDrop.tsx]"]
end

subgraph group_services["Service packages"]
  node_core_services["Core service contracts<br/>[EntityService.ts]"]
  node_storage_contract["Storage contract<br/>[StorageService.ts]"]
  node_storage_context["Storage injection"]
  node_content_services["Content service contracts"]
  node_transactions["Project transactions"]
end

subgraph group_integrations["Backend integrations"]
  node_gemini["Gemini AI service<br/>[GeminiAiService.ts]"]
  node_airtable_entity["Airtable entity adapter"]
  node_firebase_storage["Firebase storage"]
  node_firebase_auth["Firebase authentication"]
  node_supabase_storage["Supabase storage"]
end

node_admin -->|"routes through"| node_admin_routes
node_admin_routes -->|"routes to"| node_ticket_pages
node_admin_routes -->|"routes to"| node_storage_page
node_admin_routes -->|"routes to"| node_map_page
node_storage_page -->|"uses"| node_storage_contract
node_storage_context -->|"provides"| node_storage_contract
node_airtable_app -->|"routes through"| node_airtable_routes
node_airtable_routes -->|"routes to"| node_venture_page
node_venture_page -->|"uses"| node_venture_service
node_venture_service -->|"uses"| node_airtable_entity
node_firebase_app -->|"routes through"| node_firebase_routes
node_firebase_routes -->|"routes to"| node_institution_pages
node_firebase_routes -->|"routes to"| node_ai_projects
node_firebase_app -->|"configures"| node_firebase_storage
node_firebase_app -->|"configures"| node_firebase_auth
node_firebase_app -->|"configures"| node_gemini
node_firebase_app -->|"configures"| node_transactions
node_firebase_storage -->|"implements"| node_storage_contract
node_supabase_storage -->|"implements"| node_storage_contract
node_gemini -->|"implements"| node_content_services
node_transactions -->|"uses"| node_content_services
node_airtable_entity -->|"uses"| node_core_services
node_ticket_pages -->|"uses"| node_core_services
node_admin_routes -->|"routes to"| node_dragdrop
node_admin_routes -->|"uses"| node_mui
node_airtable_routes -->|"uses"| node_mui
node_firebase_routes -->|"uses"| node_mui

click node_admin "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/App.tsx"
click node_admin_routes "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/routes.tsx"
click node_ticket_pages "https://github.com/digitalaidseattle/component-library/tree/master/apps/das-admin/src/pages/crud/pages"
click node_storage_page "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/pages/storage/StorageExamplePage.tsx"
click node_map_page "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/pages/maps/MapPage.tsx"
click node_airtable_app "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/App.tsx"
click node_airtable_routes "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/routes.tsx"
click node_venture_page "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/pages/venture/index.tsx"
click node_venture_service "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/pages/services/ventureService.ts"
click node_firebase_app "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/App.tsx"
click node_firebase_routes "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/routes.tsx"
click node_institution_pages "https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/pages/institutions/index.tsx"
click node_ai_projects "https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/pages/ProjectPage.tsx"
click node_mui "https://github.com/digitalaidseattle/component-library/blob/master/packages/mui/src/layout/MainLayout/MainLayout.tsx"
click node_dragdrop "https://github.com/digitalaidseattle/component-library/blob/master/packages/draganddrop/src/components/DragAndDrop.tsx"
click node_core_services "https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/api/EntityService.ts"
click node_storage_contract "https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/api/StorageService.ts"
click node_storage_context "https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/components/StorageServiceContext.tsx"
click node_content_services "https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/contentGenerationServices.ts"
click node_transactions "https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/transactions/TransactionService.ts"
click node_gemini "https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/gemini/GeminiAiService.ts"
click node_airtable_entity "https://github.com/digitalaidseattle/component-library/blob/master/packages/airtable/src/airtableEntityService.ts"
click node_firebase_storage "https://github.com/digitalaidseattle/component-library/blob/master/packages/firebase/src/FirebaseStorageService.ts"
click node_firebase_auth "https://github.com/digitalaidseattle/component-library/blob/master/packages/firebase/src/FirebaseAuthService.ts"
click node_supabase_storage "https://github.com/digitalaidseattle/component-library/blob/master/packages/supabase/src/SupabaseStorageService.ts"

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_admin,node_admin_routes,node_ticket_pages,node_storage_page,node_map_page,node_airtable_app,node_airtable_routes,node_venture_page,node_venture_service,node_firebase_app,node_firebase_routes,node_institution_pages,node_ai_projects toneBlue
class node_mui,node_dragdrop toneAmber
class node_core_services,node_storage_contract,node_storage_context,node_content_services,node_transactions toneMint
class node_gemini,node_airtable_entity,node_firebase_storage,node_firebase_auth,node_supabase_storage toneRose
```

## Components

### Example apps

- [Admin demo](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/App.tsx): `apps/das-admin/src/App.tsx`
- [Admin routes](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/routes.tsx): `apps/das-admin/src/routes.tsx`
- [Ticket management](https://github.com/digitalaidseattle/component-library/tree/master/apps/das-admin/src/pages/crud/pages): `apps/das-admin/src/pages/crud/pages`
- [Storage demo](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/pages/storage/StorageExamplePage.tsx): `apps/das-admin/src/pages/storage/StorageExamplePage.tsx`
- [Mapping demo](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-admin/src/pages/maps/MapPage.tsx): `apps/das-admin/src/pages/maps/MapPage.tsx`
- [Airtable app](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/App.tsx): `apps/das-airtable/src/App.tsx`
- [Airtable routes](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/routes.tsx): `apps/das-airtable/src/routes.tsx`
- [Venture views](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/pages/venture/index.tsx): `apps/das-airtable/src/pages/venture/index.tsx`
- [Venture data](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-airtable/src/pages/services/ventureService.ts): `apps/das-airtable/src/pages/services/ventureService.ts`
- [Firebase app](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/App.tsx): `apps/das-firebase/src/App.tsx`
- [Firebase routes](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/routes.tsx): `apps/das-firebase/src/routes.tsx`
- [Institution management](https://github.com/digitalaidseattle/component-library/blob/master/apps/das-firebase/src/pages/institutions/index.tsx): `apps/das-firebase/src/pages/institutions/index.tsx`
- [AI project views](https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/pages/ProjectPage.tsx): `packages/content-generation/src/pages/ProjectPage.tsx`

### Shared UI

- [UI and layouts](https://github.com/digitalaidseattle/component-library/blob/master/packages/mui/src/layout/MainLayout/MainLayout.tsx): `packages/mui/src/layout/MainLayout/MainLayout.tsx`
- [Drag and drop](https://github.com/digitalaidseattle/component-library/blob/master/packages/draganddrop/src/components/DragAndDrop.tsx): `packages/draganddrop/src/components/DragAndDrop.tsx`

### Service packages

- [Core service contracts](https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/api/EntityService.ts): `packages/core/src/api/EntityService.ts`
- [Storage contract](https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/api/StorageService.ts): `packages/core/src/api/StorageService.ts`
- [Storage injection](https://github.com/digitalaidseattle/component-library/blob/master/packages/core/src/components/StorageServiceContext.tsx): `packages/core/src/components/StorageServiceContext.tsx`
- [Content service contracts](https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/contentGenerationServices.ts): `packages/content-generation/src/services/contentGenerationServices.ts`
- [Project transactions](https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/transactions/TransactionService.ts): `packages/content-generation/src/services/transactions/TransactionService.ts`

### Backend integrations

- [Gemini AI service](https://github.com/digitalaidseattle/component-library/blob/master/packages/content-generation/src/services/gemini/GeminiAiService.ts): `packages/content-generation/src/services/gemini/GeminiAiService.ts`
- [Airtable entity adapter](https://github.com/digitalaidseattle/component-library/blob/master/packages/airtable/src/airtableEntityService.ts): `packages/airtable/src/airtableEntityService.ts`
- [Firebase storage](https://github.com/digitalaidseattle/component-library/blob/master/packages/firebase/src/FirebaseStorageService.ts): `packages/firebase/src/FirebaseStorageService.ts`
- [Firebase authentication](https://github.com/digitalaidseattle/component-library/blob/master/packages/firebase/src/FirebaseAuthService.ts): `packages/firebase/src/FirebaseAuthService.ts`
- [Supabase storage](https://github.com/digitalaidseattle/component-library/blob/master/packages/supabase/src/SupabaseStorageService.ts): `packages/supabase/src/SupabaseStorageService.ts`

## Connections

- Admin demo → Admin routes: routes through (evidence: `apps/das-admin/src/App.tsx`)
- Admin routes → Ticket management: routes to (evidence: `apps/das-admin/src/routes.tsx`)
- Admin routes → Storage demo: routes to (evidence: `apps/das-admin/src/routes.tsx`)
- Admin routes → Mapping demo: routes to (evidence: `apps/das-admin/src/routes.tsx`)
- Storage demo → Storage contract: uses (evidence: `apps/das-admin/src/pages/storage/StorageExamplePage.tsx`)
- Storage injection → Storage contract: provides (evidence: `packages/core/src/components/StorageServiceContext.tsx`)
- Airtable app → Airtable routes: routes through (evidence: `apps/das-airtable/src/App.tsx`)
- Airtable routes → Venture views: routes to (evidence: `apps/das-airtable/src/routes.tsx`)
- Venture views → Venture data: uses (evidence: `apps/das-airtable/src/pages/venture/index.tsx`)
- Venture data → Airtable entity adapter: uses (evidence: `apps/das-airtable/src/pages/services/ventureService.ts`)
- Firebase app → Firebase routes: routes through (evidence: `apps/das-firebase/src/App.tsx`)
- Firebase routes → Institution management: routes to (evidence: `apps/das-firebase/src/routes.tsx`)
- Firebase routes → AI project views: routes to (evidence: `apps/das-firebase/src/routes.tsx`)
- Firebase app → Firebase storage: configures (evidence: `apps/das-firebase/src/App.tsx`)
- Firebase app → Firebase authentication: configures (evidence: `apps/das-firebase/src/App.tsx`)
- Firebase app → Gemini AI service: configures (evidence: `apps/das-firebase/src/App.tsx`)
- Firebase app → Project transactions: configures (evidence: `apps/das-firebase/src/App.tsx`)
- Firebase storage → Storage contract: implements (evidence: `packages/firebase/src/FirebaseStorageService.ts`)
- Supabase storage → Storage contract: implements (evidence: `packages/supabase/src/SupabaseStorageService.ts`)
- Gemini AI service → Content service contracts: implements (evidence: `packages/content-generation/src/services/gemini/GeminiAiService.ts`)
- Project transactions → Content service contracts: uses (evidence: `packages/content-generation/src/services/transactions/TransactionService.ts`)
- Airtable entity adapter → Core service contracts: uses (evidence: `packages/airtable/src/airtableEntityService.ts`)
- Ticket management → Core service contracts: uses (evidence: `apps/das-admin/src/pages/crud/pages/TicketsPage.tsx`)
- Admin routes → Drag and drop: routes to (evidence: `apps/das-admin/src/routes.tsx`)
- Admin routes → UI and layouts: uses (evidence: `apps/das-admin/src/routes.tsx`)
- Airtable routes → UI and layouts: uses (evidence: `apps/das-airtable/src/routes.tsx`)
- Firebase routes → UI and layouts: uses (evidence: `apps/das-firebase/src/routes.tsx`)
