# Avril Gallery

A premium, scalable, AI-generated modern stock image platform.

This repository serves as the central source of truth for the gallery's taxonomy, metadata schema, and the ever-growing collection of high-quality AI-generated imagery. It is actively populated by OpenClaw sub-agents using the Nano Banana Pro image generation skill.

## 📚 Documentation

The repository is structured to ensure maximum clarity, scalability, and ease of use for both contributors and API consumers.

- **[Taxonomy & Categories](docs/TAXONOMY.md)**: The strict hierarchical structure, tag system, and metadata schema.
- **[Contributing & Guidelines](docs/CONTRIBUTING.md)**: Rules for human and automated sub-agent contributors (naming conventions, file structures).
- **[Status & Progress](STATUS.md)**: Real-time tracking of the gallery generation process.

## 🖼️ Organization

Images are stored hierarchically according to the taxonomy:
```
/Primary_Category/Subcategory/
├── README.md               # Overview of the collection
├── image-slug.png          # High-resolution asset
└── image-slug.json         # AI-Ready Metadata
```

## 🚀 Live Site

The raw directory structure is available to browse live via Caddy file server:
**[https://gallery.avril.onl](https://gallery.avril.onl)**