Afilmory

Afilmory (/əˈfɪlməri/, "uh-FIL-muh-ree") is a term created for personal photography websites, blending Auto Focus (AF), aperture (light control), film (vintage medium), and memory (captured moments).

A modern photo gallery website built with React + TypeScript, supporting automatic photo synchronization from multiple storage sources (S3, GitHub), featuring high-performance WebGL rendering, masonry layout, EXIF information display, thumbnail generation, and more.

Live Photo Galleries:

• https://afilmory.innei.in
• https://gallery.mxte.cc
• https://photography.pseudoyu.com
• https://afilmory.magren.cc

🌟 Features

Core Functionality

• 🖼️ High-Performance WebGL Image Renderer - Custom WebGL component with smooth zoom and pan operations
• 📱 Responsive Masonry Layout - Powered by Masonic, adapts to different screen sizes
• 🎨 Modern UI Design - Built with Tailwind CSS and Radix UI component library
• ⚡ Incremental Sync - Smart change detection, processes only new or modified photos
• 🌐 i18n - Multi-language support
• 🔗 OpenGraph - OpenGraph metadata for social media sharing

Image Processing

• 🔄 HEIC/HEIF Format Support - Automatic conversion of Apple device HEIC format
• 📷 TIFF Format Support - Automatic conversion of TIFF format
• 🖼️ Smart Thumbnail Generation - Multi-size thumbnails for optimized loading performance
• 📊 EXIF Information Display - Complete shooting parameters including camera model, focal length, aperture, etc.
• 🌈 Blurhash Placeholders - Elegant image loading experience
• 📱 Live Photo Support - Detection and display of iPhone Live Photos
• ☀️ HDR Image Support - Display HDR images

Advanced Features

• 🎛️ Fujifilm Recipe - Read and display Fujifilm camera film simulation settings
• 🔍 Fullscreen Viewer - Image viewer with gesture support
• 🏷️ File System Tags - Auto-generated tags based on file system
• ⚡ Concurrent Processing - Multi-process/multi-thread concurrent processing support
• 🗂️ Multi-Storage Support - S3, GitHub, and other storage backends
• 📷 Share Image - Share image to social media or embed iframe to your website
• 🗺️ Interactive Map Explorer - Geographic visualization of photos with GPS coordinates from EXIF data using MapLibre

🏗️ Technical Architecture

Frontend Tech Stack

• React 19 - Latest React version with Compiler
• TypeScript - Complete type safety
• Vite - Modern build tool
• Tailwind CSS - Atomic CSS framework
• Radix UI - Accessible component library
• Jotai - State management
• TanStack Query - Data fetching and caching
• React Router 7 - Routing management
• i18next - Internationalization

Build System

• Node.js - Server-side runtime
• Sharp - High-performance image processing
• AWS SDK - S3 storage operations
• Worker Threads/Cluster - Concurrent processing
• EXIF-Reader - EXIF data extraction

Storage Architecture

Designed with adapter pattern, supporting multiple storage backends:

• S3-Compatible Storage - AWS S3, MinIO, Alibaba Cloud OSS, etc.
• GitHub Storage - Using GitHub repository as image storage
• Eagle Storage - Using Eagle app library as image storage
• Local File System - Local storage for development and testing

🚀 Quick Start

Docker Deployment

Docker Deployment

⚙️ Configuration Options

Remote Repository Configuration (repo)

To achieve incremental builds in CI, it is necessary to configure a cache repository, which will pull the cache before each build and upload the build results after the build.

{
  "repo": {
    "enable": true,
    "url": "https://github.com/username/gallery-assets"
  }
}

This will automatically pull resources from the remote repository, avoiding rebuilds each time.

In order to achieve uploading to the git repository, you need to provide a GIT_TOKEN and write it in the .env file.

Storage Configuration (storage)

• provider: Storage provider (s3 | github)
• bucket: S3 bucket name
• region: S3 region
• endpoint: S3 endpoint (optional)
• prefix: File prefix
• customDomain: Custom domain
• excludeRegex: Regular expression to exclude files (optional)

System Processing (system.processing)

• defaultConcurrency: Default concurrency
• digestSuffixLength: The length of the SHA-256 digest appended to the photo ID
• enableLivePhotoDetection: Enable Live Photo detection
• supportedFormats: Optional allowlist of file extensions to process

System Observability (system.observability)

• showProgress: Show build progress
• showDetailedStats: Show detailed statistics
• logging.verbose: Verbose logging
• logging.level: Log level (info | warn | error | debug)
• logging.outputToFile: Output to file
• performance.worker.workerCount: Number of worker processes
• performance.worker.timeout: Worker timeout (milliseconds)
• performance.worker.useClusterMode: Enable cluster mode

📋 CLI Commands

Build Commands

# View help
pnpm run build:manifest -- --help

# Incremental update (default)
pnpm run build:manifest

# Force full update
pnpm run build:manifest -- --force

# Only regenerate thumbnails
pnpm run build:manifest -- --force-thumbnails

# Only regenerate manifest
pnpm run build:manifest -- --force-manifest

Development Commands

# Start development server
pnpm dev

# Build production version
pnpm build

Notes

• Ensure your S3 bucket already contains photo files
• If using remote repository, configure builder.config.ts first

🔧 Advanced Usage

Custom Storage Provider

Implement the StorageProvider interface to support new storage backends:

import { StorageProvider } from './src/core/storage/interfaces'

class MyStorageProvider implements StorageProvider {
  async getFile(key: string): Promise<Buffer | null> {
    // Implement file retrieval logic
  }

  async listImages(): Promise<StorageObject[]> {
    // Implement image list retrieval logic
  }

  // ... other methods
}

Custom Image Processing

Add custom processors in the src/core/image/ directory:

export async function customImageProcessor(buffer: Buffer) {
  // Custom image processing logic
  return processedBuffer
}

📄 License

Attribution Network License (ANL) v1.0 © 2025 Afilmory Team. See LICENSE for more details.

🔗 Related Links

• Live Demo
• Personal Website
• GitHub

---

If this project helps you, please give it a ⭐️ Star for support!