Jacky's Photography

Jacky's Photography is a customized, statically deployed photo gallery based on Afilmory. This documentation focuses on operating and extending this repository.

The public source repository does not include Jacky's private photos. Originals, generated thumbnails, OG images and other media derived from those photos remain copyrighted works and are not reusable sample assets.

Choose a Task

Understand the System

• Architecture is the authority for workspace ownership, package boundaries and the generated photo-data flow.
• Performance explains thumbnail, manifest and JavaScript loading decisions.
• Interaction and Accessibility records keyboard, focus, sharing and public-data behavior.

Maintain Photos and Metadata

• Photo Metadata covers human-written titles, localized descriptions, tags, SEO output and location privacy.
• Storage Providers covers the active local-photo setup, public R2 layout and supported provider alternatives.

Build and Deploy

• Deployment is the entry point for production CI and preview deployments.
• GitHub Action Deployment documents validation gates, secrets and external writes.
• Vercel Preview Deployment documents private photo checkout behavior in previews.

Maintain Documentation

• Docs Site explains MDX frontmatter, route generation and documentation verification.

Essential Workflow

For maintainers with access to the private photo repository:

pnpm install
git clone git@github.com:Jackyhq/Photography-Photos.git photos
pnpm run build:manifest
pnpm dev

The production path is deliberately simple:

1. Standardize incoming photos.
2. Build the manifest and thumbnail variants.
3. Build the static gallery in apps/web/dist/.
4. Validate, publish photos to Cloudflare R2 and mirror the static site through GitHub Actions.

Public Links

• Gallery: photo.jackyw.cn
• Documentation: docs.photo.jackyw.cn
• Source: github.com/Jackyhq/Photography

License Boundary

Code and documentation follow the repository license. The private photo repository and all media derived from Jacky's photographs are excluded from the open documentation and code grants described there.