mirror of
https://github.com/hanzoai/gui.git
synced 2026-10-30 18:12:27 +00:00
zeekayandHanzo Dev
69c6e860d7
This repo could never sync. There was NO merge-base with tamagui — 372 commits
here against 15,791 there, unrelated histories — because it began as a
copy-paste rebrand with a flattened layout. Every "sync" since was a hand
re-application that drifted, which is why the tree sat on 7.3.1 while upstream
shipped fixes we then rediscovered by hand.
This commit's PARENT IS TAMAGUI. A future sync is `git merge tama/main` then
`node scripts/rebrand.mjs` — a real merge, because the history is now shared.
174 packages: 166 upstream, our 8 restored (chrome, shell, telemetry, recipes,
get, font-geist-{sans,mono}, @hanzo/booker), bento-get gained. 170/170 build.
Our patches to files UPSTREAM ALSO OWNS are carried, which the package-level
delta missed and which was where the value actually was:
- useMedia's server snapshot (`initState ?? getMedia()`). Upstream still
returns undefined there, so every Tamagui Dialog kills a prerender — the
exact crash hanzo.app spent a day on.
- data-slot on web host nodes, absent upstream entirely.
Both applied ONTO upstream's newer files (it rewrote useMedia +150/-63 and
createComponent +160/-55), marked `PATCH (ours, carried across the transplant)`.
Seven traps are encoded in scripts/rebrand.mjs, each found by a gate:
skip itself and lockfiles; special-case the double-branded names in BOTH scoped
and bare form; map path strings, not just paths; drop a level for the flattened
group; check disk rather than a stale index.
Rust build artifacts are NOT committed. An earlier draft of this commit swept
apps/desktop/src-tauri/target/debug in via `git add -A` — 3,859 files including
a 272MB .a, over GitHub's 100MB cap, so the push could never have landed. They
are gitignored now.
Co-Authored-By: Hanzo Dev <[email protected]>
34 lines
1.4 KiB
Plaintext
34 lines
1.4 KiB
Plaintext
---
|
|
title: Tokens
|
|
description: Understanding the default Gui token scale
|
|
---
|
|
|
|
<Notice theme="blue">
|
|
This only documents the default `@hanzogui/config` tokens that power this site, you are
|
|
free to create your own token system with more refined logical underpinning.
|
|
</Notice>
|
|
|
|
### Understanding the size scale
|
|
|
|
Most design systems use exponential scaling (2, 4, 8, 16, etc.). A lot of people ask why Gui doesn't.
|
|
|
|
Gui adopts a hybrid of more gradual increases below 10, before going exponential after 10. This hybrid approach is motivated by allowing designs to have a much more usable range of components.
|
|
|
|
#### Aligning all the keys
|
|
|
|
We align every token group and font group to use the same 1-16 keys so that a size 2 Button will look good with a size 2 spacing, a 2 Icon, and size 2 Text inside of it.
|
|
|
|
#### Quantum scale ($0.25, $0.5, $0.75)
|
|
|
|
The natural scale starts at 1, but Gui has three exponentially decreasing tokens below 1 for all token groups, with 0.25 often rounding to 1.
|
|
|
|
#### Natural scale ($1-$10)
|
|
|
|
For sizes 1 to 10, Gui increases more gradually. This yields a nice variety of sizes, with $2 being a great tiny UI, $4 is "average", $5 and $6 give you two very usable emphasized sizes, and 7 and above are great for more occasional CTA/hero type things.
|
|
|
|
#### Super-natural scale
|
|
|
|
Gui switches to an exponential scale from sizes 11 to 16 so you still get some nice chunky sizes.
|
|
|
|
<TokensDemo />
|