The Awards Index is a free public reference site for film-awards history. It ranks actors and directors by nominations, wins, raw score, and era-adjusted score across the major award bodies currently covered by the dataset.

The app is generated from offline source snapshots and exported as a static Next.js site.

The current public site shows:

• actors leaderboard
• directors leaderboard
• person pages with award-by-award history
• raw score and era-adjusted score
• methodology and coverage context

The current public ranking counts only personal acting and directing nominations and wins.

• Next.js App Router
• TypeScript
• Tailwind CSS
• static export build
• build-time data generation from cached source files

1. Fetch cached award pages into data/raw/wikipedia/.
2. Normalize raw source pages into award events, entries, films, people, and credits.
3. Optionally enrich film credits locally from TMDb.
4. Generate static JSON artifacts under src/generated/ and public/data/.
5. Export the site into out/.

npm install
npm run fetch-awards
npm run build-data
npm run dev

The dev server regenerates derived data before startup.

TMDb is not part of the default public build path.

1. Copy .env.example to .env.local.
2. Add your local TMDB_API_KEY.
3. Refresh the local cache:

npm run enrich-tmdb

4. If you explicitly want a TMDb-enriched local build, run:

INCLUDE_TMDB_ENRICHMENT=1 npm run build-data

Do not commit data/tmdb/ or .env.local.

Run the standard checks before publishing:

npm run test
npm run typecheck
npm run build

This repo is set up for Railway with a static export plus a lightweight Node file server.

• build command: npm run build
• start command: npm run start
• export directory: out/
• Railway config: railway.json

After connecting the repo in Railway, the default Railpack flow should build and run without additional platform-specific changes.

Award bodies are included only when the configured category set for that body is complete and parseable. A fully complete higher-priority body is preferred over a partial multi-body build.

Current priority order:

1. Oscars
2. SAG
3. BAFTA
4. Golden Globes

• Cached Wikipedia-derived source snapshots live under data/raw/wikipedia/.
• See NOTICE.md for source and attribution notes before redistributing raw source snapshots or enabling TMDb-enriched public builds.
• The default public build path is designed to avoid committing TMDb cache data.

The Awards Index is an independent fan-made reference. It is not affiliated with, endorsed by, or sponsored by the Academy of Motion Picture Arts and Sciences, BAFTA, SAG Awards, Golden Globes, TMDb, or any other award body or data provider referenced in this project.