Skip to content

docs: give the repository swarea's mark instead of a drawn-here one - #185

Merged
isaacslee merged 1 commit into
mainfrom
docs/repository-mark
Aug 5, 2026
Merged

docs: give the repository swarea's mark instead of a drawn-here one#185
isaacslee merged 1 commit into
mainfrom
docs/repository-mark

Conversation

@isaacslee

Copy link
Copy Markdown
Member

The README opened with two SVG marks invented for this project alone. swarea has
an icon set of its own, so Quiet now takes a variant from it and looks like part
of something.

  • docs/assets/mark.pngswarea-blue-mid-38548c at 512, corners rounded by
    the proportion --r-lg gives a card at the 96px the README displays it, ground
    flattened to --light-paper #fbfbfa
  • scripts/make-social.html — draws the 1280x640 card GitHub unfurls, in the
    skin's palette and the bundled face, following make-previews.html
  • the two placeholder SVGs are deleted
  • the palette check now reads every scripts/make-*.html rather than naming one
  • ADR-0005 records why the colour is blue despite the organisation being blue

On the colour

Measured against the organisation's own card, this is the closest of all 115 —
0 degrees of hue, and 1.48 between its accent plane and its own body. Taken
anyway: it is --light-accent exactly, the organisation's card is dark where
this one is light, and GitHub gives a repository no icon slot where the two
would be shown together. The ADR records that Quiet moves to the warm variant,
not the organisation, if a sibling project ever needs the blue.

Validation

node scripts/check.mjs — 25 checks, passed. The widened palette check was
proved to fail by moving --light-muted two steps in the new generator; it named
both the file and the token, then passed again once restored.

The card was generated over a served repository root, so the bundled face and the
mark both loaded — the generator refuses rather than falling back silently.

- take `swarea-blue-mid-38548c` from the organisation's icon set as
  `docs/assets/mark.png`, at 512 with the corners `--r-lg` gives a card
  at the 96px the README shows it
- flatten its ground to `#fbfbfa`, which is `--light-paper`, so the value
  belongs to a token rather than to the set's own average
- add `scripts/make-social.html`, which draws the 1280x640 card GitHub
  unfurls in the skin's palette and the face the skin ships
- delete the two placeholder SVGs; a hand-drawn mark beside the real one
  leaves two answers to the same question
- widen the palette check to every `scripts/make-*.html`, since it named
  one generator by hand and the new file would have drifted unwatched
- record the colour in ADR-0005: this is the card closest to the parent
  of all 115, taken anyway because it is `--light-accent`, with the note
  that Quiet moves rather than the organisation if a sibling appears
Copilot AI lite review requested due to automatic review settings August 5, 2026 07:50

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@isaacslee
isaacslee merged commit 0d212b3 into main Aug 5, 2026
1 check passed
@isaacslee
isaacslee deleted the docs/repository-mark branch August 5, 2026 07:50
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants