_____ ___ ____ _
| ____|_ _/ ___| / \
| _| | | | _ / _ \
| |___ | | |_| |/ ___ \
|_____|___\____/_/ \_\
Your cinema, mapped.
EIGA turns a Letterboxd export into an interactive movie graph. Explore your viewing journey, find patterns in your ratings, and share an atlas that updates with each new upload.
- Import a Letterboxd ZIP or CSV files, or try the built-in demo without an account.
- Switch between journey, release decade, rating, and watch year; search and highlight films.
- Pan, zoom, inspect reviews and rewatches, switch themes, and export a PNG.
- Sign in with Google to save your atlas and create a reusable public link.
Director grouping is available in the demo; Letterboxd exports do not include director data.
Requires Node.js 22.18+.
npm ci
npm run devOpen localhost:3000 for local imports and the demo. Google sign-in and saved/share APIs require the backend's local setup.
Letterboxd export → browser parsing → normalized library → graph → React + D3
Next.js exports static files to out/. React manages UI state; D3 manages layout,
pan, and zoom. Pure TypeScript modules handle imports, graph construction, and statistics.
Raw exports stay in the browser. Signing in saves normalized films, viewing dates, ratings, likes, and reviews. Sharing makes that saved atlas, including reviews, available to anyone with the link. New uploads update the same link.
npm run format:check
npm run typecheck
npm run lint
npm test
npm run build -- --webpackFeature PRs run checks. Merge into staging to deploy the combined app for manual testing.
Production is released through the backend's pinned release.json after the tested
frontend reaches main; a frontend main push alone does not deploy production.