Setup image removal

Author: halogenandtoast

.gitignore

@@ -37,3 +37,21 @@ logfile
 *.hp
 
 .kamal/secrets
+
+# Large image assets (served from CloudFront CDN in both dev and prod)
+# Run `make fetch-images` to download locally if needed
+frontend/public/img/arkham/cards/
+frontend/public/img/arkham/es/
+frontend/public/img/arkham/fr/
+frontend/public/img/arkham/ita/
+frontend/public/img/arkham/ko/
+frontend/public/img/arkham/zh/
+frontend/public/img/arkham/boxes/
+frontend/public/img/arkham/portraits/
+frontend/public/img/arkham/tarot/
+frontend/public/img/arkham/encounter-sets/
+frontend/public/img/arkham/mini-cards/
+frontend/public/img/arkham/sets/
+frontend/public/img/arkham/customizations/
+frontend/public/img/arkham/seals/
+frontend/public/img/arkham/playing-cards/

Makefile

@@ -36,6 +36,33 @@ sync-images:
 	cd frontend/public && aws s3 sync . s3://arkham-horror-assets --acl public-read --exclude ".DS_Store"
 .PHONY: sync-images
 
+## Fetch images from CDN for local development
+fetch-images:
+	./scripts/fetch-assets.sh all
+.PHONY: fetch-images
+
+## Fetch only English card images from CDN
+fetch-cards:
+	./scripts/fetch-assets.sh cards
+.PHONY: fetch-cards
+
+## Regenerate image manifest (run after adding new images, before committing)
+generate-manifest:
+	node scripts/generate-manifest.cjs
+.PHONY: generate-manifest
+
+## Sync images to S3 and regenerate manifest
+sync-and-manifest:
+	./scripts/sync-and-manifest.sh
+.PHONY: sync-and-manifest
+
+## Install git hooks
+install-hooks:
+	cp scripts/check-manifest.sh .git/hooks/pre-commit
+	chmod +x .git/hooks/pre-commit
+	@echo "Pre-commit hook installed."
+.PHONY: install-hooks
+
 ## Count lines of code
 count:
 	cloc . --include-lang=Haskell,TypeScript,Vue --exclude-dir=node_modules,dist,.stack-work --timeout=0

README.md

@@ -95,6 +95,39 @@ Run `stack setup` in the `backend` directory, then run `stack build --fast` (not
 
 Run `npm install` in the `frontend` directory
 
+#### Images
+
+Image assets (~2.9 GB) are **not stored in the git repository**. They are hosted
+on CloudFront and the app loads them from the CDN by default in both development
+and production — no extra setup needed.
+
+If you need local copies (e.g. for offline development), the fetch script
+downloads directly from the public CDN using `curl` (no AWS credentials needed):
+
+```
+make fetch-images     # Download all images (~2.9 GB)
+make fetch-cards      # Download only English card images (~755 MB)
+
+# Or use the script directly for specific languages:
+./scripts/fetch-assets.sh fr    # French only
+./scripts/fetch-assets.sh en    # All English images
+```
+
+To use local images instead of CDN, create `frontend/.env.development.local`:
+```
+VITE_ASSET_HOST=
+```
+
+If you add new images, sync them to S3 and regenerate the manifest:
+```
+make sync-and-manifest
+```
+
+To install a git hook that warns if you forget to update the manifest:
+```
+make install-hooks
+```
+
 #### Database
 Create the local database: