Iowa Opportunity Atlas

Iowa Opportunity Atlas is a full-stack heatmap app focused on Iowa. It supports point-based opportunity maps, built-in sample datasets, CSV uploads, dynamic custom fields, and presentation-friendly map exploration.

What the app includes

• Iowa map explorer with clickable hotspots
• Built-in sample datasets, including an Iowa city lending dataset
• CSV upload flow with custom numeric and text fields
• Dynamic filters, detail panels, and visual styling controls
• Hidden setup review route at /setup-check for deployment handoff

Project structure

/frontend   React app
/backend    FastAPI API
/api        Importable serverless-style Python entrypoint
/handoff    Export-ready handoff package metadata

Local development

Frontend

cd frontend
yarn install
yarn start

Backend

cd backend
pip install -r requirements.txt
uvicorn server:app --host 0.0.0.0 --port 8001

Docker option

docker compose up --build

This starts:

• frontend on http://localhost:3000
• backend on http://localhost:8001
• MongoDB on mongodb://localhost:27017

Handoff and portability

• Frontend env example: frontend/.env.example
• Backend env example: backend/.env.example
• Portability guide: PORTABILITY.md
• Handoff export manifest: handoff/export-package.json

Use /setup-check inside the app to review deployment readiness and download the export package manifest.