templates/index.html: source template for the main gallery page
templates/rankings.html: source template for the rankings page
index.html: generated static gallery page
rankings.html: generated static rankings page
assets/: site CSS, JavaScript, fonts, and audio
images/fulls/: full-size gallery images
images/thumbs/: gallery thumbnails
data/meals.json: source of truth for gallery entries
data/elo.json: Elo ratings, record totals, and ranking settings
scripts/build.js: renders static pages from templates and data
scripts/generate-thumbnails.js: regenerates thumbnails from the full-size images
scripts/ingest-meal.js: ingests a new meal image and metadata in one command
scripts/lib/elo.js: validates and syncs Elo data against the meal list
package.json: minimal Node build entrypoint

Content Workflow

Gallery entries live in data/meals.json, and the build generates both index.html and rankings.html from the template and data files.

After editing content or templates, rebuild the site with:

npm run build

The gallery build keeps the existing Lens thumbnail markup intact, so the current client-side viewer code continues to work.

To ingest a new meal image and update the site in one command, run:

npm run ingest -- --image /path/to/photo.jpg --title "meal title" --description "notes"

Optional ingestion flags:

--position "left center" sets the viewer image alignment
--focus-x 0.35 --focus-y 0.45 sets the thumbnail crop focal point

If you only need to regenerate thumbnails, run:

npm run build:thumbs

To force a full thumbnail rebuild, run:

npm run build:thumbs:force

Rankings Data

data/elo.json stores the seed rating, Elo kFactor, and a win-loss record for each meal. The page build keeps this file aligned with data/meals.json, so new meals automatically appear in rankings.html with the default seed rating.

Image Conventions

Full-size images and thumbnails share the same numeric ID
Full-size images live at images/fulls/<id>.jpg
Thumbnails live at images/thumbs/<id>.jpg
position controls the full-screen viewer image alignment
thumbnail.focus optionally overrides the default center crop for generated thumbnails

Thumbnail Focus

Thumbnails are generated from images/fulls with sharp at 240x320. The generator auto-rotates images using EXIF orientation, skips unchanged files by default, and removes stale thumbnail .jpg files that no longer map to a meal entry.

For images that should crop away from the center, add optional thumbnail focus metadata to the meal entry:

{
  "id": "34",
  "title": "example",
  "description": "example",
  "thumbnail": {
    "focus": {
      "x": 0.35,
      "y": 0.45
    }
  }
}

The x and y values are normalized from 0 to 1, where 0.5, 0.5 is the center of the image.

Planned Features

A pairwise voting page that shows two food images at a time and updates Elo rankings based on the selected winner.
General cleanup and history cleanup once the bigger structural changes are in place.