# proyecto/framework architecture

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

- Interactive diagram: https://gitdiagram.com/proyecto/framework
- Repository: https://github.com/proyecto/framework

## Overview

This monorepo is a reusable MVC app framework with canonical Expo and web shells, shared UI, domain packages, and interchangeable local/cloud persistence. A user interacts with MintMox through its Expo screen; its controller delegates commands to the domain model and uses Scryfall integration, while framework data packages provide local-first storage and sync. The README documents the reusable server and adapter options. Unsampled modules are represented only where the README or source index establishes their role; edges avoid assuming unshown calls.

Main entry points: [`apps/mintmox-expo/src/MintMoxScreen.tsx`](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/MintMoxScreen.tsx) (MintMox screen), [`packages/data/src/entityStore.ts`](https://github.com/proyecto/framework/blob/main/packages/data/src/entityStore.ts) (SQL entity store), [`apps/mintmox-expo/App.tsx`](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/App.tsx) (MintMox app root), [`packages/mintmox-domain/src/MintmoxController.ts`](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/MintmoxController.ts) (MintMox controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_apps["Apps and UI"]
  node_mintmox["MintMox screen<br/>[MintMoxScreen.tsx]"]
  node_thumbnail["Card thumbnails<br/>[CardThumbnail.tsx]"]
  node_image_loader["Image loading<br/>[cardImageLoader.ts]"]
  node_mint_app["MintMox app root<br/>[App.tsx]"]
  node_base_expo["Expo base shell"]
  node_base_web["Web base app<br/>[BaseWebApp.tsx]"]
  node_ui_kit["Shared UI kit<br/>[tokens.ts]"]
end

subgraph group_domain["Domain Applications"]
  node_mint_controller["MintMox controller"]
  node_mint_model["MintMox model<br/>[MintmoxModel.ts]"]
  node_scryfall_client["Scryfall client"]
  node_scryfall_mapping["Scryfall mapping<br/>[scryfall.ts]"]
  node_price_history["Price history<br/>[priceHistory.ts]"]
  node_card_sets["Card set data<br/>[sets.ts]"]
  node_import_export["Inventory import/export<br/>[importExport.ts]"]
  node_preset_domain["FocusScenes domain"]
end

subgraph group_persistence["Persistence and Sync"]
  node_repo["Hybrid repository"]
  node_entity_store["SQL entity store<br/>[entityStore.ts]"]
  node_migrations["Migration runner<br/>[migrations.ts]"]
  node_http_transport["HTTP sync transport<br/>[httpTransport.ts]"]
  node_libsql["libSQL adapter<br/>[index.ts]"]
  node_expo_sqlite["Expo SQLite adapter<br/>[index.ts]"]
end

subgraph group_backend["Sync Backend"]
  node_server_router["Sync router<br/>[router.ts]"]
  node_sync_service["Cloud sync service<br/>[syncService.ts]"]
  node_server_schema["Server schema<br/>[schema.ts]"]
  node_server_factory["Server factory<br/>[createServer.ts]"]
end

subgraph group_framework["MVC Framework"]
  node_mvc_core["MVC and data contracts<br/>[storage.ts]"]
  node_react_adapter["React MVC adapter<br/>[index.ts]"]
  node_base_domain["Base app domain"]
end

node_user(("App user"))

node_user -->|"opens"| node_mint_app
node_mint_app -->|"renders"| node_mintmox
node_mintmox -.->|"uses controller"| node_mint_controller
node_mint_controller -->|"delegates commands"| node_mint_model
node_mint_controller -->|"queries cards"| node_scryfall_client
node_scryfall_client -->|"maps responses"| node_scryfall_mapping
node_scryfall_client -.->|"requests data"| node_user
node_mintmox -->|"renders"| node_thumbnail
node_thumbnail -->|"loads images"| node_image_loader
node_mintmox -->|"uses components"| node_ui_kit
node_mintmox -.->|"shows valuation history"| node_price_history
node_mintmox -.->|"uses set data"| node_card_sets
node_mintmox -.->|"supports inventory transfer"| node_import_export
node_mintmox -.->|"persists inventory"| node_repo
node_repo -->|"stores entities"| node_entity_store
node_entity_store -->|"runs migrations"| node_migrations
node_repo -.->|"syncs remotely"| node_http_transport
node_entity_store -.->|"uses SQL driver"| node_libsql
node_entity_store -.->|"uses SQL driver"| node_expo_sqlite
node_http_transport -.->|"sends sync requests"| node_server_router
node_server_factory -->|"configures routes"| node_server_router
node_server_router -->|"dispatches sync"| node_sync_service
node_sync_service -->|"uses schema"| node_server_schema
node_sync_service -.->|"uses SQL driver contract"| node_libsql
node_base_expo -->|"binds controller"| node_react_adapter
node_base_web -.->|"uses MVC adapter"| node_react_adapter
node_mint_app -->|"configures theme"| node_ui_kit
node_base_domain -->|"uses contracts"| node_mvc_core
node_preset_domain -.->|"uses MVC contracts"| node_mvc_core

click node_mintmox "https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/MintMoxScreen.tsx"
click node_thumbnail "https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/CardThumbnail.tsx"
click node_image_loader "https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/cardImageLoader.ts"
click node_mint_app "https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/App.tsx"
click node_base_expo "https://github.com/proyecto/framework/blob/main/apps/base-expo/src/BaseShellScreen.tsx"
click node_base_web "https://github.com/proyecto/framework/blob/main/apps/base-web/src/BaseWebApp.tsx"
click node_ui_kit "https://github.com/proyecto/framework/blob/main/packages/ui/src/tokens.ts"
click node_mint_controller "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/MintmoxController.ts"
click node_mint_model "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/MintmoxModel.ts"
click node_scryfall_client "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/ScryfallApiClient.ts"
click node_scryfall_mapping "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/scryfall.ts"
click node_price_history "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/priceHistory.ts"
click node_card_sets "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/sets.ts"
click node_import_export "https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/importExport.ts"
click node_preset_domain "https://github.com/proyecto/framework/blob/main/packages/example-domain/src/PresetController.ts"
click node_repo "https://github.com/proyecto/framework/blob/main/packages/data/src/hybridRepository.ts"
click node_entity_store "https://github.com/proyecto/framework/blob/main/packages/data/src/entityStore.ts"
click node_migrations "https://github.com/proyecto/framework/blob/main/packages/data/src/migrations.ts"
click node_http_transport "https://github.com/proyecto/framework/blob/main/packages/data/src/httpTransport.ts"
click node_libsql "https://github.com/proyecto/framework/blob/main/packages/data-libsql/src/index.ts"
click node_expo_sqlite "https://github.com/proyecto/framework/blob/main/packages/expo-adapter/src/index.ts"
click node_server_router "https://github.com/proyecto/framework/blob/main/packages/server/src/router.ts"
click node_sync_service "https://github.com/proyecto/framework/blob/main/packages/server/src/syncService.ts"
click node_server_schema "https://github.com/proyecto/framework/blob/main/packages/server/src/schema.ts"
click node_server_factory "https://github.com/proyecto/framework/blob/main/packages/server/src/createServer.ts"
click node_mvc_core "https://github.com/proyecto/framework/blob/main/packages/core/src/storage.ts"
click node_react_adapter "https://github.com/proyecto/framework/blob/main/packages/react/src/index.ts"
click node_base_domain "https://github.com/proyecto/framework/blob/main/packages/base-domain/src/BaseAppController.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_mintmox,node_thumbnail,node_image_loader,node_mint_app,node_base_expo,node_base_web,node_ui_kit,node_user toneBlue
class node_mint_controller,node_mint_model,node_scryfall_client,node_scryfall_mapping,node_price_history,node_card_sets,node_import_export,node_preset_domain toneAmber
class node_repo,node_entity_store,node_migrations,node_http_transport,node_libsql,node_expo_sqlite toneMint
class node_server_router,node_sync_service,node_server_schema,node_server_factory toneRose
class node_mvc_core,node_react_adapter,node_base_domain toneIndigo
```

## Components

### Apps and UI

- [MintMox screen](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/MintMoxScreen.tsx): `apps/mintmox-expo/src/MintMoxScreen.tsx`
- [Card thumbnails](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/CardThumbnail.tsx): `apps/mintmox-expo/src/CardThumbnail.tsx`
- [Image loading](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/src/cardImageLoader.ts): `apps/mintmox-expo/src/cardImageLoader.ts`
- [MintMox app root](https://github.com/proyecto/framework/blob/main/apps/mintmox-expo/App.tsx): `apps/mintmox-expo/App.tsx`
- [Expo base shell](https://github.com/proyecto/framework/blob/main/apps/base-expo/src/BaseShellScreen.tsx): `apps/base-expo/src/BaseShellScreen.tsx`
- [Web base app](https://github.com/proyecto/framework/blob/main/apps/base-web/src/BaseWebApp.tsx): `apps/base-web/src/BaseWebApp.tsx`
- [Shared UI kit](https://github.com/proyecto/framework/blob/main/packages/ui/src/tokens.ts): `packages/ui/src/tokens.ts`

### Domain Applications

- [MintMox controller](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/MintmoxController.ts): `packages/mintmox-domain/src/MintmoxController.ts`
- [MintMox model](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/MintmoxModel.ts): `packages/mintmox-domain/src/MintmoxModel.ts`
- [Scryfall client](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/ScryfallApiClient.ts): `packages/mintmox-domain/src/ScryfallApiClient.ts`
- [Scryfall mapping](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/scryfall.ts): `packages/mintmox-domain/src/scryfall.ts`
- [Price history](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/priceHistory.ts): `packages/mintmox-domain/src/priceHistory.ts`
- [Card set data](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/sets.ts): `packages/mintmox-domain/src/sets.ts`
- [Inventory import/export](https://github.com/proyecto/framework/blob/main/packages/mintmox-domain/src/importExport.ts): `packages/mintmox-domain/src/importExport.ts`
- [FocusScenes domain](https://github.com/proyecto/framework/blob/main/packages/example-domain/src/PresetController.ts): `packages/example-domain/src/PresetController.ts`

### Persistence and Sync

- [Hybrid repository](https://github.com/proyecto/framework/blob/main/packages/data/src/hybridRepository.ts): `packages/data/src/hybridRepository.ts`
- [SQL entity store](https://github.com/proyecto/framework/blob/main/packages/data/src/entityStore.ts): `packages/data/src/entityStore.ts`
- [Migration runner](https://github.com/proyecto/framework/blob/main/packages/data/src/migrations.ts): `packages/data/src/migrations.ts`
- [HTTP sync transport](https://github.com/proyecto/framework/blob/main/packages/data/src/httpTransport.ts): `packages/data/src/httpTransport.ts`
- [libSQL adapter](https://github.com/proyecto/framework/blob/main/packages/data-libsql/src/index.ts): `packages/data-libsql/src/index.ts`
- [Expo SQLite adapter](https://github.com/proyecto/framework/blob/main/packages/expo-adapter/src/index.ts): `packages/expo-adapter/src/index.ts`

### Sync Backend

- [Sync router](https://github.com/proyecto/framework/blob/main/packages/server/src/router.ts): `packages/server/src/router.ts`
- [Cloud sync service](https://github.com/proyecto/framework/blob/main/packages/server/src/syncService.ts): `packages/server/src/syncService.ts`
- [Server schema](https://github.com/proyecto/framework/blob/main/packages/server/src/schema.ts): `packages/server/src/schema.ts`
- [Server factory](https://github.com/proyecto/framework/blob/main/packages/server/src/createServer.ts): `packages/server/src/createServer.ts`

### MVC Framework

- [MVC and data contracts](https://github.com/proyecto/framework/blob/main/packages/core/src/storage.ts): `packages/core/src/storage.ts`
- [React MVC adapter](https://github.com/proyecto/framework/blob/main/packages/react/src/index.ts): `packages/react/src/index.ts`
- [Base app domain](https://github.com/proyecto/framework/blob/main/packages/base-domain/src/BaseAppController.ts): `packages/base-domain/src/BaseAppController.ts`

### Other components

- **App user**

## Connections

- App user → MintMox app root: opens
- MintMox app root → MintMox screen: renders (evidence: `apps/mintmox-expo/App.tsx`)
- MintMox screen → MintMox controller: uses controller
- MintMox controller → MintMox model: delegates commands (evidence: `packages/mintmox-domain/src/MintmoxController.ts`)
- MintMox controller → Scryfall client: queries cards (evidence: `packages/mintmox-domain/src/MintmoxController.ts`)
- Scryfall client → Scryfall mapping: maps responses (evidence: `packages/mintmox-domain/src/ScryfallApiClient.ts`)
- Scryfall client → App user: requests data
- MintMox screen → Card thumbnails: renders (evidence: `apps/mintmox-expo/src/MintMoxScreen.tsx`)
- Card thumbnails → Image loading: loads images (evidence: `apps/mintmox-expo/src/CardThumbnail.tsx`)
- MintMox screen → Shared UI kit: uses components (evidence: `apps/mintmox-expo/src/MintMoxScreen.tsx`)
- MintMox screen → Price history: shows valuation history
- MintMox screen → Card set data: uses set data
- MintMox screen → Inventory import/export: supports inventory transfer
- MintMox screen → Hybrid repository: persists inventory
- Hybrid repository → SQL entity store: stores entities (evidence: `packages/data/src/hybridRepository.ts`)
- SQL entity store → Migration runner: runs migrations (evidence: `packages/data/src/entityStore.ts`)
- Hybrid repository → HTTP sync transport: syncs remotely
- SQL entity store → libSQL adapter: uses SQL driver
- SQL entity store → Expo SQLite adapter: uses SQL driver
- HTTP sync transport → Sync router: sends sync requests
- Server factory → Sync router: configures routes
- Sync router → Cloud sync service: dispatches sync (evidence: `packages/server/src/router.ts`)
- Cloud sync service → Server schema: uses schema (evidence: `packages/server/src/syncService.ts`)
- Cloud sync service → libSQL adapter: uses SQL driver contract
- Expo base shell → React MVC adapter: binds controller (evidence: `apps/base-expo/src/BaseShellScreen.tsx`)
- Web base app → React MVC adapter: uses MVC adapter
- MintMox app root → Shared UI kit: configures theme (evidence: `apps/mintmox-expo/App.tsx`)
- Base app domain → MVC and data contracts: uses contracts (evidence: `packages/base-domain/src/BaseAppController.ts`)
- FocusScenes domain → MVC and data contracts: uses MVC contracts
