How hawksk2497/wildriftcodex works
Wild Rift Codex is a champion browser with an AI-backed playstyle recommender. Users browse and search the champion catalog, open entries with abilities and skins, or describe their preferences to get a recommendation that is checked against stored champion data. The README also documents champion-data ingestion into Postgres. The ingestion implementation and some UI internals were not sampled, so those relationships reflect README documentation rather than inspected source.
Main entry points: App.tsx App workflow · db/index.ts Database client · api/index.ts Express API · chat.ts Recommendation service
Components 15
Web experience
- App workflow
web/App.tsx - Champion search
web/components/ChampionSearch.tsx - Champion grid
web/components/ChampionGrid.tsx - Champion entry
web/components/ChampionCard.tsx - Playstyle finder
web/components/PlaystyleFinder.tsx - Web API client
web/api/index.ts
API services
- Express API
api/index.ts - Recommendation service
api/services/chat.ts
Champion data
- Database client
api/db/index.ts - Champion schema
api/db/schema.ts - Postgres
- Champion ingestion
api/scripts/seed.ts
External integrations
- Champion data package
- Google Gemini
Other components
- Visitor
Connections 16
- Visitor → App workflow: browses
- App workflow → Champion search: renders
- App workflow → Playstyle finder: renders
- App workflow → Champion grid: renders
- App workflow → Champion entry: renders
- App workflow → Web API client: loads catalog
- Playstyle finder → Web API client: requests recommendation
- Web API client → Express API: HTTP requests
- Express API → Database client: queries catalog
- Express API → Recommendation service: delegates recommendation
- Recommendation service → Google Gemini: generates suggestion
- Recommendation service → Database client: checks champion
- Database client → Postgres: reads and writes
- Database client → Champion schema: uses schema
- Champion ingestion → Champion data package: fetches champions
- Champion ingestion → Database client: upserts catalog