Sync Accelevents

Sync Accelevents Speaker Data (Europe)

Pulls speaker headshots and social data from the Accelevents API into the Europe conference schedule.

Prerequisites

• ACCELEVENTS_API_KEY environment variable must be set (stored as a Devin secret)
• Python 3 with Pillow installed (pip install Pillow) for image optimization

Steps

1. Checkout a new branch

   cd /home/ubuntu/repos/aiecode2025
   git checkout main && git pull origin main
   git checkout -b devin/$(date +%s)-sync-accelevents
   

2. Run the sync script

   cd /home/ubuntu/repos/aiecode2025/src/pages/europe/source/_scripts
   python3 sync_accelevents.py --save-snapshot
   

   This will:

   • Fetch all speakers from the Accelevents API
   • Download/replace headshots that speakers uploaded to the portal
   • Optimize oversized images (>200KB) for the grid view, keeping originals in large/
   • Update schedule.json with social/bio data (only fills blanks, doesn't overwrite)
   • Save an API snapshot to _accelevents/accelevents_speakers_latest.json

   Flags:

   • --dry-run — show what would change without writing anything
   • --headshots-only — skip social/bio updates
   • --data-only — skip headshot downloads
   • --save-snapshot — save raw API response
   • --optimize-existing --data-only — optimize oversized existing photos

3. Re-export the CSV

   cd /home/ubuntu/repos/aiecode2025/src/pages/europe/source
   python3 _scripts/export_csv.py
   

4. Run typecheck

   cd /home/ubuntu/repos/aiecode2025
   SKIP_ENV_VALIDATION=1 npx tsc --noEmit
   

5. Commit all changes

   cd /home/ubuntu/repos/aiecode2025
   git add public/speakers/europe/ src/pages/europe/source/schedule.json src/pages/europe/source/_accelevents/ src/pages/europe/source/schedule_export.csv
   git commit -m "sync: pull speaker headshots + social data from Accelevents API"
   git push origin HEAD
   

6. Create PR and verify

   • Create PR into main
   • Start the dev server: SKIP_ENV_VALIDATION=1 pnpm dev
   • Navigate to http://localhost:3000/europe#speakers
   • Verify the speaker globe renders with updated headshots, no broken images
   • Take a screenshot and share with the user

Key Paths

• Script: src/pages/europe/source/_scripts/sync_accelevents.py
• Schedule source of truth: src/pages/europe/source/schedule.json
• Photos (optimized for grid): public/speakers/europe/
• Photos (full-size for lightbox): public/speakers/europe/large/
• API snapshot: src/pages/europe/source/_accelevents/accelevents_speakers_latest.json
• CSV export: src/pages/europe/source/schedule_export.csv

Notes

• The script matches API speakers to schedule speakers by: acceleventsSpeakerId > email > name
• Only 8 of 109 speakers had uploaded headshots as of the first run — this number will grow over time
• pnpm lint does not work on Next.js 16; use npx tsc --noEmit for type checking instead
• The europe:source:sync-public script referenced in some docs does not exist; the sync script writes directly to public/speakers/europe/