@geolith/brand
v0.2.1
Published
geolith brand: marks, colours, motif and guidelines
Readme
geolith artwork
The source of truth for the geolith brand: the mark, the colours, the triangulation-net motif and the guidelines. Every geolith site, favicon, social image and README takes its brand assets from here.
A geolith is a stone set in the earth. Surveyors cut a mark into such stones and measured whole countries from them. Geolith does the same for places: every place on the planet sits in one file that you can measure from, host anywhere and keep for ever.
Every place, set in stone.
| Path | What |
| --------------- | --------------------------------------------------------------------- |
| src/marks/ | The mark: master (64-unit grid), 16 and 32 px tuned files, one-colour |
| src/wordmark/ | The wordmark, outlined (General Sans 600, no font file ships) |
| src/tokens/ | Palette source (OKLCH), colour maths and motion tokens |
| types/ | Shared TypeScript types |
| scripts/ | Repo gates and the build |
| assets/ | Built artwork: lockups, favicons, OG cards, GitHub images, email |
| dist/ | Built tokens: tokens.css, tokens.js, tokens.d.ts (git-ignored) |
| design/ | Working boards for review (git-ignored) |
Use
pnpm add @geolith/brand@import '@geolith/brand/tokens.css'; /* --geolith-basalt, --geolith-lichen, … */import { hex } from '@geolith/brand/tokens'; // { basalt: '#14110e', … }
import mark from '@geolith/brand/marks/geolith-mark-32.svg?raw';.btn {
transition: transform var(--motion-duration-quick) var(--motion-ease-set);
}import { motion } from '@geolith/brand/tokens'; // motion.duration.base = 200Favicons, the web manifest and <head> tags: assets/favicon/. OG cards:
assets/og/. The net for OG templates: assets/motif/. README header:
assets/readme/snippet.md.
Motion
Stone does not bounce. Things are set (enter), shifted (state to state) or lifted off (exit). No springs, no overshoot.
| Token | Value | Use |
| ---------------------------------- | -------------------------------- | ----------------------------------------- |
| --motion-duration-quick | 120ms | hover, press, exits, menu open |
| --motion-duration-base | 200ms | enter, label swap, indicator slide, toast |
| --motion-duration-slow | 320ms | bar fill, pin drop, skeleton to content |
| --motion-duration-survey | 1200ms | one-shot hero net draw only |
| --motion-ease-set | cubic-bezier(0.2, 0, 0, 1) | enter and settle |
| --motion-ease-shift | cubic-bezier(0.65, 0, 0.35, 1) | move between states |
| --motion-ease-lift | cubic-bezier(0.4, 0, 1, 1) | exit and leave |
| --motion-stagger | 30ms | delay between items in a list |
| --motion-distance-{press,lift} | 1px | button press, hover lift |
| --motion-distance-nudge | 4px | arrow nudge |
| --motion-distance-{reveal,toast} | 8px | scroll reveal, toast enter |
Under prefers-reduced-motion: reduce every duration and the stagger become
0.01ms, so transitions still fire their end events but nothing moves.
Rules:
- The mark is never broken apart. It never fades in pieces, never disintegrates, and never appears without its Brass cut, in any frame of any animation, any state, any theme. Allowed: the whole mark fades or scales in as one piece, a subtle whole-mark hover lift, and the Brass cut may brighten or shimmer while it stays visible at full shape.
- Animate
transformandopacityonly. Reserve space for swaps; no layout shift. - Every animation has a static reduced-motion fallback.
- Server-render the final state of anything that carries content (numbers, headings); motion decorates it, never replaces it.
- Shaders mount after first paint, pause off-screen and on hidden tabs, and fall back to a static branded frame without WebGL. Brand colours only.
- Do not animate prices, legal copy or body text.
Scrollbar
@import '@geolith/brand/tokens.css';
@import '@geolith/brand/scrollbar.css'; /* page scrollbar + .geolith-scroll */Thin and square: a Slate thumb on a clear track, Brass while the pointer is
on the scroller or the thumb is held. Tokens: --scrollbar-size (8px),
--scrollbar-thumb, --scrollbar-thumb-active, --scrollbar-track. Inner
scroll areas take the .geolith-scroll class (it also reserves the gutter, so
content does not shift when the bar appears).
Build
pnpm build # dist/ tokens, then assets/ (Chromium)
pnpm build:wordmark # re-outline the wordmark; needs .data/fonts/The asset build reads General Sans and JetBrains Mono from .data/fonts/
(git-ignored) for text on OG cards; only the rendered pixels ship.
The package is @geolith/brand on npm.
Licences
- Code (scripts, tokens, build files): Apache-2.0, see LICENSE.
- Artwork (marks and the files built from them): see TRADEMARKS.md. You may use the marks to refer to geolith; you may not change them, imply endorsement, or use them as your own mark.
- Fonts are not included. General Sans and Switzer come from Fontshare under the ITF Free Font Licence; JetBrains Mono is SIL OFL 1.1.
