# WordPress.org Assets

This directory contains assets for the WordPress.org plugin page.

## Required Files

### Banner (Header Image)
- `banner-772x250.png` - Standard resolution
- `banner-1544x500.png` - Retina/HiDPI (optional but recommended)

**Design Guidelines:**
- Show the plugin in action (interactive map with GPX route)
- Include plugin name/logo
- Use colors that match your branding
- Keep it clean and professional

### Icon (Plugin Listing)
- `icon-128x128.png` - Standard resolution (REQUIRED)
- `icon-256x256.png` - Retina/HiDPI (REQUIRED)

**Design Guidelines:**
- Simple, recognizable symbol (map pin + route line suggested)
- Solid background color or transparent
- Should work at small sizes
- SVG-style simplified icon works best

### Screenshots
- `screenshot-1.png` - Backend route editor with GPX meta box
- `screenshot-2.png` - Frontend map with elevation profile
- `screenshot-3.png` - POI management screen (optional)
- `screenshot-4.png` - Settings page (optional)

**Specifications:**
- Format: PNG or JPG
- Recommended width: 1280px (will be displayed at 772px max)
- Aspect ratio: 4:3 or 16:9
- File size: Keep under 1MB per screenshot

## How to Add These

After creating the files:
1. Place them in this directory
2. Commit to Git
3. During deployment, these will be copied to SVN `/assets/` directory

## Tools

- [Canva](https://canva.com) - Free design tool
- [Figma](https://figma.com) - Professional design tool
- [TinyPNG](https://tinypng.com) - Compress PNG files
- [Squoosh](https://squoosh.app) - Image optimization

## Examples

Browse the WordPress.org plugin directory for inspiration:
https://wordpress.org/plugins/browse/popular/

## SVN Asset Deployment

During the GitHub Actions deployment workflow, files from this directory will be automatically copied to the SVN repository's `/assets/` directory (not `/trunk/`). This is how WordPress.org displays your plugin's banner, icon, and screenshots.

**Directory Structure:**
```
SVN Repository:
├── trunk/           → Plugin code
├── tags/            → Version releases
└── assets/          → Banner, icon, screenshots (from this directory)
```