Community pages: mandatory files vs optional media

Mandatory (every new page)

• web/communities/{slug}/index.html — page shell
• web/communities/{slug}/app.js — loads community.json
• web/data/communities/{slug}/community.json
• web/data/communities/{slug}/sections.json
• Shared CSS/JS under web/shared/community/ (referenced by index.html)
• Optional tiny placeholder: web/assets/media_library/images/placeholder-profile.jpg

Create a lean page: python3 scripts/create_community_group.py --group … --name … (also writes media_selection.json).

Optional media (not deployed by default)

Store shared or large files in the media library:

web/assets/media_library/
  audio/     video/     pdf/     images/
  media_manifest.json

Standard names are supported (audio_001.mp3, video_001.mp4, …) but the manifest is the source of truth.

Per-page selection file:

web/data/communities/{slug}/media_selection.json

Fields: selectedMediaIds, deployPaths, sectionMedia.

Gallery folders under data/communities/{slug}/gallery/ and memory reel media stay on your Mac for local preview. For beta, use externalUrl in gallery_index.json for large files.

Include media in Netlify deploy

1. Add the file under web/assets/media_library/ (or a small path under web/assets/communities/{slug}/).
2. Register it in media_manifest.json (includeInDeploy: true when global).
3. List mediaId or deployPaths in media_selection.json for that community.
4. Run python3 scripts/build_deploy_media_selection.py
5. Run ./scripts/prepare_deploy.sh (default profile: june7).

Deploy size controls

• LLM_DEPLOY_PROFILE=june7 — lean sync (default)
• LLM_DEPLOY_PROFILE=full — broader rsync for local debugging
• ./scripts/audit_deploy_size.sh — writes private_work/deploy_size_audit.md
• ./scripts/clean_deploy_duplicates.sh — removes iCloud 2 / 3 copies from deploy

Prepare warns if deploy/web_public exceeds 300 MB (strong warning at 500 MB).

Related docs

• Developer Help home
• Admin upload guide
• Data editing guide