# Assets Directory

This directory contains static assets for the Goondex project.

## Structure

```
assets/
├── logo/              # Project logos (tracked in git)
│   ├── GOONDEX_logo.png
│   ├── GOONDEX_logo_dark.png
│   ├── GOONDEX_logo_light.png
│   ├── GOONDEX_logo.svg
│   └── Team_GoonLOGO.png
│
├── performers/        # Downloaded performer images (NOT tracked in git)
├── scenes/            # Downloaded scene images (NOT tracked in git)
├── studios/           # Downloaded studio logos (NOT tracked in git)
└── galleries/         # Downloaded image galleries (NOT tracked in git)
```

## Git Tracking

**TRACKED:**
- `/assets/logo/` - All logo files are committed to git

**NOT TRACKED (in .gitignore):**
- `/assets/performers/` - Performer profile images
- `/assets/scenes/` - Scene posters and screenshots
- `/assets/studios/` - Studio logos downloaded from TPDB
- `/assets/galleries/` - Image galleries
- All `.jpg`, `.jpeg`, `.png`, `.gif`, `.webp`, `.mp4`, `.webm` files outside of `/logo/`

## Why Images Are Not Tracked

Downloaded images from ThePornDB and other sources are:
1. **Large files** - Can quickly bloat the git repository
2. **User-specific** - Each user will download their own copy
3. **Regenerable** - Can be re-downloaded from TPDB anytime
4. **Privacy-sensitive** - Should not be pushed to remote repositories

## Local Storage

When Goondex downloads images, they will be stored in subdirectories here:
- Performer images: `assets/performers/{performer_id}/`
- Scene images: `assets/scenes/{scene_id}/`
- Studio logos: `assets/studios/{studio_id}/`
- Galleries: `assets/galleries/{entity_type}/{entity_id}/`

All downloaded assets are stored locally and never committed to version control.
