Identity & usage
peryx
Artifact storage across ecosystems.
An open-source artifact service marked by a diving peregrine.
The name
Two roots form the name. Say it PERR-iks.
The peregrine reaches over 380 km/h in a dive. Its Latin root peregrinus means “from every land.”
A pyx is a sealed box for safekeeping. In the Trial of the Pyx, sample coins are locked away, then assayed to prove they are genuine. Artifact verification follows that model.
What Peryx is
peryx caches upstream artifacts, stores published artifacts, and composes both through virtual indexes. Configuration selects availability behavior.
Free, inspectable, self-hosted. No seat tax to run your own registry.
Disabled features start no tasks and allocate no feature state.
Each ecosystem follows shared service contracts.
Voice & taglines
Use concise, technical language. State behavior directly.
Plain about packaging concepts. Active voice. A control says what happens. Numbers over adjectives.
Enterprise buzzwords, “revolutionary,” exclamation marks, or jargon a newcomer cannot decode.
The logo
A peregrine seen head-on in a full stoop, wings raised, diving. We traced it from a photograph rather than drawing it, mirrored it for symmetry, and reduced it to one gradient silhouette.
gradient · dark
gradient · light
One silhouette, two uses. The bare falcon is the everyday mark. Sealed inside the hexagonal pyx it becomes the app icon and the verified-artifact badge. The enclosure survives the OS icon masks that clip the bare mark.
Clear space & minimum size
Keep clear space of half the mark’s height on all sides. Minimum size 16 px, where it still reads as the falcon.
Logo expressions
Every form the mark ships in, all from one path plus the gradient.
Wordmark lockups
Lowercase, weight 800, tracking −2%. Gradient at display sizes, solid --text in body and nav. Never enclose the wordmark in the pyx.
Sizes, single-colour & seal
Motion
The mark has one move: the stoop. It folds in from up and back, accelerates like gravity, throws off speed streaks, and settles in about 0.7 s. Click to replay. The seal never animates.
Transform and opacity only. Motion is a flourish, not a dependency: with reduced-motion the mark paints settled, the loop holds still, and progress bars show their value without animating.
Colour
One bold element, the ember-to-amber gradient, over quiet warm-graphite neutrals. Tokens map to style.css.
Signature gradient
115°, from #f74c00 to #ffb600. Same direction on every mark. click any swatch or the bar to copy
Palette
Semantic (state, not brand)
Light & dark
The website ships both themes, so the brand carries both. The gradient stays fixed; the neutrals mirror. This page follows your system theme, and you can flip it with the toggle in the viewer.
Cache and host artifacts across ecosystems.
Cache and host artifacts across ecosystems.
Ecosystems
A coloured device identifies an ecosystem without changing the mark. Use the owner’s brand colour. ● marks owners compiled into peryx.
Colour-coded name. Legible in dense UI and CLI.
Typography
System stacks: a mono for labels, data, and the CLI the tool lives in, and a sans for UI and prose. No web fonts.
In product
The system in use: buttons, badges, and status, all drawn from the gradient and the neutrals.
In the wild
Startup banner
The startup logo prints when the service boots. Two separate builds for two eras of terminal. Pick one at runtime; keep both off for non-TTY output and CI.
Modern terminals: truecolor and Unicode blocks
the artifact vault · v0.1.0 → proxy upstream.example → hosted 2,481 resources · 6.2 GB → virtual /cache, /hosted ✓ ready in 0.42s on :8080
Old terminals: ASCII only, 16-colour or mono
the artifact vault v0.1.0 ------------------------------------ -> proxy upstream.example -> hosted 2481 resources, 6.2 GB -> virtual /cache, /hosted [ok] ready in 0.42s on :8080
Pick at runtime: truecolor plus UTF-8 selects the modern build; an older TERM, NO_COLOR, or a non-TTY pipe drops to the ASCII build in the terminal’s own foreground.
Accessibility
Built to pass WCAG 2.1 AA in both themes. Every role is tuned to the same contrast on the light and dark page, so an element reads with equal emphasis whichever theme is active. Body text stays off-white on dark, never pure white, to avoid the halation glow that white-on-black creates for readers with astigmatism; status and gold foregrounds are theme-scoped, darkened on the light page and lifted on the dark one, so they clear AA on both.
Colour contrast (measured, light / dark)
| Body text | 15.9 / 14.9 : 1 |
| Headings | 17 / 18 : 1 |
| Secondary text | 9.9 / 9.9 : 1 |
| Faint labels | 5.1 / 5.3 : 1 |
| Accent / links | 6.0 / 5.4 : 1 |
| Status (ok · warn · bad) | ≥ 4.8 : 1 |
Beyond contrast
- Focus — every control shows a visible focus ring.
- Keyboard — interactive demos run on Tab + Enter.
- Motion — prefers-reduced-motion stops the dive, loop, and progress bars.
- Colour never carries meaning alone — ecosystem is a dot plus its name; status is an icon plus a word.
- Minimum sizes — mark 16 px, seal 32 px, body 16 px.
- Plain language — active voice, no jargon a newcomer cannot decode.
Usage
A few rules keep it coherent.
Asset manifest
What ships to the repo, and which form fills each file.
| File | Form | Notes |
|---|---|---|
site/static/icon.svg | Pyx seal on dark chip | App / installer icon, 512², 22% radius. |
site/static/mark.svg | Falcon, gradient | Primary web mark. |
site/static/mark-mono.svg | Falcon, mono | Single-colour via currentColor. |
site/static/lockup.svg | Falcon + wordmark | Horizontal; nav and README. |
site/static/lockup-stacked.svg | Falcon + wordmark | Vertical; square placements. |
site/static/seal.svg new | Pyx seal, colour + mono | Verified-artifact / signing badge. |
Startup banner new | ASCII banner + start line | Amber via ANSI; off for non-TTY. |
BRAND.md new | — | The rules from §04–§12. |