Donation World's

Global intelligence dashboard for public donations.

Live 3D globe, country heatmaps, country drill-downs, search, and a safe demo simulation that keeps the app usable even without external API keys.

What it does

• Interactive globe with live donation arcs
• Country heat coloring by donation volume
• Side panel with totals, last 24h, top donor countries, top recipient countries, and live feed
• Click any country to inspect sent / received totals, history, and related organizations
• Modular connectors for ProPublica, IRS, OpenAlex, and Candid
• SQLite + Prisma local persistence

Tech

• Next.js 16
• TypeScript
• Tailwind CSS 4
• Prisma + SQLite
• globe.gl

Run locally

cd "C:\Users\LeDono420\Desktop\Donation World's"
npm install
npm run dev

Environment

Copy .env.example to .env if you want to change defaults:

DATABASE_URL="file:./dev.db"
CANDID_API_KEY=""
PROPUBLICA_API_KEY=""
OPENALEX_EMAIL=""
NEXT_PUBLIC_SITE_URL="https://your-domain.example"
ENABLE_LIVE_SIMULATION=true
REFRESH_INTERVAL_MS=3000

SEO / sharing

• Canonical metadata in app/layout.tsx
• Sitemap in app/sitemap.ts
• Robots in app/robots.ts
• Social preview image in app/opengraph-image.tsx

APIs

• GET /api/donations?limit=50
• GET /api/donations?country=CAN
• GET /api/stats
• GET /api/countries

GitHub repo

• Repository: https://github.com/ArthureCodage/donation-worlds

Notes

• The live feed is simulated locally by default.
• Public connectors fail safely and fall back to demo data when keys are missing or the upstream source is unavailable.