immich-folio/docs/ideas.md

Portfolio Backlog & Ideas

A consolidated list of features and ideas for future versions, cleaned up from everything that has already been implemented.

🏆 Quick Wins (High Impact / Low Effort)

Idea	Effort	Impact
Slideshow mode	Low	High — exhibition ready (Auto-advance 3s/5s/10s)
Fullscreen API in lightbox	Low	Medium — immersive (Chrome-free)
Download originals	Low	High — client delivery (Button in lightbox)
Photo of the Day	Low	Medium — return visits (Auto-rotate hero image)
Photo sharing	Low	Medium — "Copy link" button in lightbox

Shipped: Keyboard shortcut hints — ? opens the list in the lightbox, with a one-time nudge for first-time visitors.

---

🌍 Bigger Features & Enhancements

• ISR / Stale-While-Revalidate — Replace force-dynamic with Incremental Static Regeneration + on-demand revalidation.
• Client proofing — Let clients favorite/select photos in password-protected galleries.
• Map view — Minimal world map from EXIF city/country data, each dot links to an album.
• EXIF analytics page — Visual breakdown of shooting patterns: most-used focal lengths, aperture distribution.
• Before/After slider — Drag-to-reveal comparison component for retouching showcases.
• Watermarking — Server-side watermark overlay on proxied images.
• Internationalization (i18n) — Multi-language UI support (DE/EN). Shipped for the visitor UI; the admin panel is still English-only.

---

📖 Deep Dive Feature Plan: Photo Stories / Essays

Vertical scroll format with images + text interspersed, like a photo essay. A major portfolio differentiator.

Proposed Architecture

How it works: The photographer writes standard Markdown files in content/stories/. We extend the standard Markdown image syntax to pull images directly from Immich using the asset UUID:

# My trip to Japan

Here is some text introducing the story.

![Kyoto street at night](asset:b8c2d...)

Implementation Layers

1. Parser Layer (lib/storyParser.ts)

   • Parse markdown files using marked.
   • Identify asset:UUID image nodes.
   • Batch-fetch necessary ImmichAsset data to generate ThumbHash and Proxy-URLs.
   • Return a structured array of blocks (e.g. { type: 'text', html: '...' }, { type: 'image', assetId: '...', url: '...' }).

2. Routing Layer

   • app/stories/page.tsx: Index page showing cards for all stories (sorted by date).
   • app/stories/[slug]/page.tsx: The essay reader.

3. Design Layer

   • Immersive, single-column reading experience.
   • Consecutive images can automatically adapt to side-by-side or masonry presentation depending on aspect ratios.
   • Typography should be highly legible, matching the chosen global theme.