1f5bcfb50c
closes #28 The owner supplied a redrawn lockup, docs/design/dist/splash.webp, which sets the name as "Privacy: Period Tracker" — with the space after the colon. NECESSARY AND NOT SUFFICIENT The tempting move was to look at the new artwork and close the issue. #28's Verify names the two DERIVED assets, not the lockup: the wordmark in docs/data/img/logo.webp and banner.webp had to match app_full_name, and both still carried the old spaceless form because they were generated from the earlier source. Regenerated from the new lockup and checked by cropping the colon out of each finished webp and reading it at 1350px wide. THE BANNER IS COMPOSED, NEVER CROPPED The lockup is square and the banner is 3:1, so a crop takes the ends off the wordmark — the trap the first pass at these assets hit. A 660px square card centred on 2176x725, matching how the existing asset did it. No flood-fill this time either: splash.webp has real transparency where the earlier sources rendered their rounded corners against black. icon.webp is deliberately untouched. It carries no wordmark, it is the same visual family, and #28 is about the name — regenerating it would be churn dressed as consistency. BRAND_GUIDE.md §10 carried a callout stating the drawn mark disagreed with the written name. That is now false, so it records what happened instead and marks lockup-light-source.png and lockup-dark-source.png as superseded rather than deleting them; they are the owner's files. Also corrects a path in the previous log entry, which named splash.png in backticks — doc-claims reads that as a claim the file is present, and it is now splash.webp. Named bare, per the convention DOC_TRUST_MAP.md documents for a path that deliberately does not exist. Second time this session; the lesson is that converting a file means grepping the docs for its old name. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> |
||
|---|---|---|
| .. | ||
| img | ||
| README.md | ||
README.md
Data — Privacy: Period Tracker
Status: Current
Owner: _null
Last reviewed: 2026-08-18
Governs: docs/data/** — the assets privacyllc.dev renders for this project
Review trigger: A rebrand, or any change to the icon, logo or banner
What goes here
Three files, in img/, at exactly these names:
docs/data/img/icon.webp the square mark, used wherever the project is listed
docs/data/img/logo.webp the full lockup, used on the project page
docs/data/img/banner.webp the wide image, used across the project header
All webp. All required. Only img/ is checked — an asset left in
docs/data/ instead of docs/data/img/ is not found.
Dimensions, weights and how to generate them are in
img/README.md, beside the files they describe. This
document owns the rule; that one owns the spec. Stating both in both places is
how two copies of one convention start disagreeing.
No placeholders ship here, deliberately. The template this repository
adopted carried a 0-byte logo.webp once, and an empty file is the worst of the
three states: a check that asks "does the path exist" calls it present, and
anything that reads the bytes rejects it — a consumer verifying the webp signature answers 415, which
reads as a corrupt asset rather than a missing one. Absent is honest and the
conformance check reports it as absent, which is what gets it filled in.
Extra sizes and variants are welcome beside them — icon-512.webp,
logo-dark.webp — and are not treated as clutter. Only the three exact names
are checked for.
If an asset is missing, open an issue — do not invent one
An agent cannot draw a logo, and this is the one gap in the whole convention that cannot be closed by writing a file.
So when an asset is absent, file an issue rather than producing something:
title it for the asset, label it P2, and end the body with its Verify: line
— Verify: docs/data/img/logo.webp exists and the project card renders it.
Do not generate a placeholder. A placeholder that looks deliberate outlives the issue that would have replaced it: nobody files a ticket against an image that appears to be finished. An obviously absent asset keeps asking.
Why this folder is different from every other one here
The Command Center consumes these. Every other document in this tree is written for a person to read; these are fetched and rendered on privacyllc.dev's project page.
That has one consequence worth stating plainly: this folder cannot be declared
exempt. A repository may tell the conformance check that a required document is
deliberately absent — kept out of git on purpose, say — and the check will
believe it. It will not accept that declaration for docs/data/, because the
result would be a project card with nothing to show and nothing explaining why,
which is the exact failure the check exists to prevent.
Why webp and not PNG
One format, checked by its magic bytes rather than its file extension, so the site can serve it inline with confidence. A file whose first bytes are RIFF/WEBP cannot be an HTML document or an SVG carrying script, which is what makes it safe to render directly rather than forcing a download.
Renaming a PNG to .webp will not work, and is meant not to.
This is not an asset library
Screenshots, mockups, reference art and exported source files do not belong here. They belong wherever the project already keeps them. This folder holds the three marks that identify the project elsewhere, and stays small enough that its contents are obvious at a glance.