# Unhistoric Acts media kit

This directory contains approved organization copy, identity guidance, logos, wordmarks, platform icons, social artwork, and illustrative editorial photography. Assets are grouped by purpose and exported as SVG, PNG, JPG, PDF, and GIF. Raster filenames include their pixel width (`-512w`, for example).

## Start here

| Need                        | Recommended file                                                       |
| --------------------------- | ---------------------------------------------------------------------- |
| Website/header logo         | `logos/source/wordmark-ink.svg`                                        |
| Logo on a dark background   | `logos/source/wordmark-stone.svg`                                      |
| Print or partner one-sheet  | `logos/pdf/lockup-stacked.pdf`                                         |
| SaaS workspace/avatar       | `platform/saas-avatar-512x512.png`                                     |
| Browser favicon             | `platform/favicon.ico` or `logos/source/app-icon.svg`                  |
| Apple touch icon            | `platform/apple-touch-icon-180x180.png`                                |
| Android/PWA icons           | `platform/android-chrome-192x192.png` and `android-chrome-512x512.png` |
| Social profile image        | `platform/social-profile-1200x1200.png`                                |
| Open Graph/LinkedIn sharing | `social/png/social-card-1200w.png`                                     |
| Wide social header          | `social/png/banner-1500w.png`                                          |
| Press description           | `COPY.md`                                                              |

## Directory map

- `logos/source/`: editable SVG masters for the mark, wordmarks, stacked lockup, and app icon.
- `logos/{png,jpg,gif,pdf}/`: exported logo formats and sizes.
- `platform/`: ready-to-upload browser, PWA, Apple, social, and SaaS presets.
- `social/source/`: editable SVG masters for profile, social card, and banner graphics.
- `social/{png,jpg,gif,pdf}/`: social exports at standard dimensions.
- `previews/`: lossless WebP derivatives used only by the media-kit page; downloads retain the original exports.
- `photos/`: two real, CC0-licensed editorial image sets. Each set includes 640, 1280, and 1536 px PNG/JPG/GIF exports plus SVG and PDF versions.
- `COPY.md`: approved one-sentence, two-sentence, one-paragraph, and two-paragraph descriptions.
- `BRAND-GUIDE.md`: usage, color, typography, photography, and accessibility guidance.
- `PHOTO-LICENSES.md`: photo provenance, creator credits, source links, license, and suggested captions.
- `ASSET-INVENTORY.csv`: machine-readable file list with sizes and checksums.

## Choosing a format

- **SVG:** preferred for websites, design tools, and unlimited scaling. Photo SVGs are self-contained wrappers around the approved photograph.
- **PNG:** use when transparency or lossless output matters. Best default for platform icons and logos.
- **JPG:** use for email, documents, and systems that reject transparency. Reversed logos are placed on ink; primary logos are placed on stone.
- **PDF:** use in print workflows and office documents. The SVG remains the editable vector master.
- **GIF:** compatibility fallback for older systems. The supplied GIFs are static.

Do not upscale a raster file. Choose the smallest supplied width at or above the displayed size. For high-density screens, use an export approximately twice the CSS display width.

Preview files are generated from the corresponding PNG exports with Sharp's `webp({ lossless: true })`. Their names include the first 12 hexadecimal characters of the WebP file's SHA-256 hash, allowing immutable caching. When replacing a preview, generate a new hashed filename and update its `src` and `srcset` references in `index.html`; never overwrite an existing hashed file with different content.

## Photo notes

The photographs are real CC0-licensed images sourced through Wikimedia Commons. They show CERN archive storage and the Glasgow City Chambers council chamber; they do not depict Unhistoric Acts people, offices, collections, or events. See `PHOTO-LICENSES.md` for provenance and `BRAND-GUIDE.md` for usage guidance.