# wporg-assets source

Templates and generator for the WordPress.org listing artwork in `wporg-assets/`.

## What's here

| File | Purpose |
| --- | --- |
| `generate.sh` | Rebuilds `screenshot-1..8.png` and both banners |
| `screenshot.typ` | Typst template: brand gradient background + device composite |
| `banner.typ` | Typst template: plugin page banner (1544x500) |
| `oliver-logo.png` | Oliver logo used by the banner |

## Inputs

The 2400x1600 device composites are produced by the app repo's marketing/appshots
pipeline (`oliver-pos-app/iosApp/appshots/`) and are **not** committed here.
`generate.sh` reads them from `~/Desktop/WP` by default, or pass a directory:

```bash
./generate.sh /path/to/composites
```

Expected composite filenames (slot order is defined in `generate.sh`):
`register-duo-mixed`, `orders-duo`, `customers-duo-mixed`,
`order-complete-trio-mixed`, `inventory-transfer-trio-dark`, `tip-tablet`,
`fulfilment-trio-mixed`, `shift-summary-trio-dark`.

## Requirements

- [Typst](https://typst.app) on PATH
- macOS `sips` (banner downscale)
- Brand fonts (Poppins/Inter) — read from the app repo's
  `iosApp/appshots/fonts/` directory; override with `FONT_PATH=...`

## After regenerating

1. Update the `== Screenshots ==` captions in `readme.txt` if slots changed.
2. Commit to `main` — artwork ships with the next tagged release
   (see `docs/RELEASING.md`, "Listing images").