How proyecto/framework works
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: MintMoxScreen.tsx MintMox screen · entityStore.ts SQL entity store · App.tsx MintMox app root · MintmoxController.ts MintMox controller
Components 29
Apps and UI
- MintMox screen
apps/mintmox-expo/src/MintMoxScreen.tsx - Card thumbnails
apps/mintmox-expo/src/CardThumbnail.tsx - Image loading
apps/mintmox-expo/src/cardImageLoader.ts - MintMox app root
apps/mintmox-expo/App.tsx - Expo base shell
apps/base-expo/src/BaseShellScreen.tsx - Web base app
apps/base-web/src/BaseWebApp.tsx - Shared UI kit
packages/ui/src/tokens.ts
Domain Applications
- MintMox controller
packages/mintmox-domain/src/MintmoxController.ts - MintMox model
packages/mintmox-domain/src/MintmoxModel.ts - Scryfall client
packages/mintmox-domain/src/ScryfallApiClient.ts - Scryfall mapping
packages/mintmox-domain/src/scryfall.ts - Price history
packages/mintmox-domain/src/priceHistory.ts - Card set data
packages/mintmox-domain/src/sets.ts - Inventory import/export
packages/mintmox-domain/src/importExport.ts - FocusScenes domain
packages/example-domain/src/PresetController.ts
Persistence and Sync
- Hybrid repository
packages/data/src/hybridRepository.ts - SQL entity store
packages/data/src/entityStore.ts - Migration runner
packages/data/src/migrations.ts - HTTP sync transport
packages/data/src/httpTransport.ts - libSQL adapter
packages/data-libsql/src/index.ts - Expo SQLite adapter
packages/expo-adapter/src/index.ts
Sync Backend
- Sync router
packages/server/src/router.ts - Cloud sync service
packages/server/src/syncService.ts - Server schema
packages/server/src/schema.ts - Server factory
packages/server/src/createServer.ts
MVC Framework
- MVC and data contracts
packages/core/src/storage.ts - React MVC adapter
packages/react/src/index.ts - Base app domain
packages/base-domain/src/BaseAppController.ts
Other components
- App user
Connections 29
- App user → MintMox app root: opens
- MintMox app root → MintMox screen: renders
apps/mintmox-expo/App.tsx - MintMox screen → MintMox controller: uses controller
- MintMox controller → MintMox model: delegates commands
packages/mintmox-domain/src/MintmoxController.ts - MintMox controller → Scryfall client: queries cards
packages/mintmox-domain/src/MintmoxController.ts - Scryfall client → Scryfall mapping: maps responses
packages/mintmox-domain/src/ScryfallApiClient.ts - Scryfall client → App user: requests data
- MintMox screen → Card thumbnails: renders
apps/mintmox-expo/src/MintMoxScreen.tsx - Card thumbnails → Image loading: loads images
apps/mintmox-expo/src/CardThumbnail.tsx - MintMox screen → Shared UI kit: uses components
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
packages/data/src/hybridRepository.ts - SQL entity store → Migration runner: runs migrations
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
packages/server/src/router.ts - Cloud sync service → Server schema: uses schema
packages/server/src/syncService.ts - Cloud sync service → libSQL adapter: uses SQL driver contract
- Expo base shell → React MVC adapter: binds controller
apps/base-expo/src/BaseShellScreen.tsx - Web base app → React MVC adapter: uses MVC adapter
- MintMox app root → Shared UI kit: configures theme
apps/mintmox-expo/App.tsx - Base app domain → MVC and data contracts: uses contracts
packages/base-domain/src/BaseAppController.ts - FocusScenes domain → MVC and data contracts: uses MVC contracts