← setup-guides

Unsplash — Family Wall backgrounds & Ken Burns screensaver

The wall's Rotating photos (Unsplash) background and the Ken Burns screensaver (migration 581) fetch photos from the Unsplash API. Without a key they silently degrade — the wall falls back to its solid/gradient background — so this is optional.

Setup

  1. Create a (free) developer app at https://unsplash.com/oauth/applications.
  2. Copy the Access Key.
  3. Set it on the backend (Railway): UNSPLASH_ACCESS_KEY=<access key>.

That's it — the toggle in the wall's Background picker (and the Ken Burns screensaver) light up. Demo apps are rate-limited (50 req/hr); results are cached 30 min per query, so a handful of walls stays well under it. Apply for production access if you scale up.

Compliance (already handled in code)

family-unsplash.ts follows the Unsplash API guidelines: it hotlinks the hosted image URLs (never re-hosts), shows photographer attribution with a UTM-tagged profile link, and fires the per-photo download event when a set is served.

UNSPLASH — Docs | HiveJournal