Identity & usage
peryx
Fast as the falcon, sealed as the pyx.
One blazing-fast, open-source vault for a wide range of ecosystems. The identity is built on a mark traced from a photo of a diving peregrine.
The name
Two real roots make one coined word. Between them they cover the three traits: open, fast, wide ecosystem support. Say it PERR-iks.
The fastest animal alive, over 380 km/h in a dive. Its Latin root peregrinus means “from every land,” which stands for the wide-ecosystem axis: one vault, artifacts from many ecosystems.
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. That is the upload pipeline.
What Peryx is
A caching proxy of upstream indexes, a hosted store you publish to, and a virtual index that merges the two so local packages override upstream. One async Rust process. Zero-config on a laptop, clustered when you configure it.
Free, inspectable, self-hosted. No seat tax to run your own registry.
Features you do not enable cost nothing: no CPU, RAM, or latency for anything switched off.
PyPI and OCI today; npm, Maven, and Cargo next. Each is a driver behind one model.
Voice & taglines
Concise, technical, plain. Describe what it does and let the numbers carry the boast.
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 rust-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.
One blazing-fast vault for a wide range of ecosystems.
One blazing-fast vault for a wide range of ecosystems.
Ecosystems
A coloured device carries the ecosystem, kept off the mark. It maps across the package types Artifactory supports, each in that project’s own brand colour. ● marks the ones live in Peryx today.
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 & Unicode blocks
the artifact vault · v0.1.0 → proxy pypi.org, ghcr.io → hosted 2,481 packages · 6.2 GB → virtual /simple, /v2 ✓ ready in 0.42s on :8080
Old terminals — ASCII only, 16-colour or mono
the artifact vault v0.1.0 ------------------------------------ -> proxy pypi.org, ghcr.io -> hosted 2481 packages, 6.2 GB -> virtual /simple, /v2 [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. Contrast, focus, motion, and language are part of the system, not an afterthought.
Colour contrast (measured)
| Body text · light | 9.9 : 1 |
| Body text · dark | 9.9 : 1 |
| Headings · both | 15 : 1 |
| Secondary labels | ≥ 5 : 1 |
| Accent / links · light | 4.7 : 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 |
|---|---|---|
assets/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. |
assets/seal.svg new | Pyx seal, colour + mono | Verified-artifact / signing badge. |
crates/peryx/src/banner.rs new | ASCII banner + start line | Amber via ANSI; off for non-TTY. |
BRAND.md new | — | The rules from §04–§12. |