How ackermanngue/aoe4-game-reviewer works
AOE4 Game Reviewer is a local browser application for gathering AoE4 match data, preparing it for a ChatGPT-assisted review, and viewing or exporting the resulting report. The main workflow runs from player and game selection through match-data collection and JSON assembly, then prompt generation, external analysis, and Markdown report import. The README documents charting, PDF, saved-report, and theme capabilities; paths for these are included, though some wiring is not shown in the sampled excerpts.
Main entry points: app.js Application workflow · server.js Local server and proxy · api.js API client · prompts.js Prompt generation
Components 18
Player and Match Discovery
- Application workflow
js/app.js - Game and player views
js/render.js
Match Data and Export
- API client
js/api.js - Build-order parser
js/build-order.js - Game JSON assembly
js/exporter.js
Analysis and Reports
- Prompt generation
js/prompts.js - Analysis template
prompts/analysis.md - PDF task template
prompts/pdf-task.md - Report viewer and charts
js/report.js - Saved reports
js/app.js
Local Runtime
- Local server and proxy
server.js - Theme system
js/theme.js
Other components
- Player
- Browser UI
- AoE4World API
- ChatGPT
- Analysis Markdown
- Coolors palette service
Connections 23
- Player → Browser UI: searches
- Browser UI → Application workflow: provides input
- Application workflow → API client: requests player and game data
- API client → Local server and proxy: fetches proxied data
- Local server and proxy → AoE4World API: proxies requests
- AoE4World API → Local server and proxy: returns match data
- Local server and proxy → API client: returns responses
- Application workflow → Game and player views: renders selection
- Application workflow → Build-order parser: retrieves build order
- Build-order parser → Local server and proxy: fetches game page
- Application workflow → Game JSON assembly: assembles match data
- Application workflow → Prompt generation: requests analysis prompt
- Prompt generation → Analysis template: loads
- Prompt generation → PDF task template: loads
- Browser UI → ChatGPT: pastes prompt
- ChatGPT → Analysis Markdown: produces analysis
- Browser UI → Application workflow: loads report file
- Application workflow → Report viewer and charts: renders report
- Report viewer and charts → API client: fetches player profiles
- Application workflow → Saved reports: saves and reloads reports
- Application workflow → Theme system: applies themes
- Theme system → Coolors palette service: requests palette
- ChatGPT → Browser UI: provides PDF download