Chaguan · Ink and Paper System
Plain, task-first interface dressed in literati ink-painting clothes: brush display type, solid-ink still lifes over a flat disc, and a vermilion seal as punctuation - all on warm paper pinned to a mount.
Two things to hold on to. The decoration never enters the working surface: brush art lives in posters and empty states, and every control is plain sans with a 2px line icon. And the seal is the only hot colour - it is punctuation, so it appears at most twice on a surface and never carries a sentence.
Still life
brush, disc, seal
Plate 00 · The Poster
css/chaguan-core.css. Use them; do not invent parallel ones - no raw hex, no new radius, no new duration.--primary is a deep brown fill by day and a pale tan fill after dark; --sheet is the raised surface, not "white". Check both with the toggle.Section 01 · 17 role tokens
Every swatch shows daylight on the left and lamplight on the right, so both themes are in view at once. Daylight is cream paper on a caramel mount; after dark the mount goes nearly black, the paper takes on the brown of old silk, and ink turns pale. Nothing is pure black or pure white.
| Token | Value | Job |
|---|---|---|
| --stage | --paper | The ground inside a frame. .cg-alt points it at --alt-ground. |
| --muted | ink 72% | Secondary text: sub-lines, notes, keys. |
| --ink-faint | ink 34% | Ink art in an empty state, deliberately quiet. |
| --primary-soft | primary 80% | Idle tab labels, placeholders, small captions. |
| --primary-line | primary 40% | An idle control's outline: the toggle track, table heads. |
| --primary-wash | primary 12% | The press wash under an outlined control. |
| --rule | primary 14% | The hairline between rows. |
| --disc-wash | disc 36% | A washed disc, for when a full one would shout. |
| Pair | Light | Dark | Rule |
|---|---|---|---|
| --ink on --paper | 12.3:1 | 13.0:1 | Body text anywhere on paper. |
| --ink on --mount | 4.9:1 | 15.1:1 | The only small text allowed on the mount. |
| --primary on --mount | 3.8:1 | 10.0:1 | Large text only. Section titles, never a sentence. |
| --primary on --paper / --card / --sheet | 9.5 / 8.6 / 11.0 | 8.6 / 7.7 / 6.9 | Captions, values, tile labels. |
| --on-primary on --primary | 9.5:1 | 9.1:1 | Buttons, selected chips, the action bar. |
| --muted on --paper / --card | 5.4 / 5.1 | 7.4 / 6.8 | The smallest secondary text, 11px. |
| --on-seal on --seal | 5.2:1 | 4.9:1 | Badge counts and the carved mark. |
| --on-alt on --alt-ground | 5.2:1 | 8.1:1 | Anything set straight on the alternate ground. |
--primary is a deep brown with
cream on it; by lamplight a deep fill would vanish into the mount, so it
becomes a pale tan carrying dark text. The same flip turns the disc from
a noon sun into a dim moon behind pale ink. A token called "coffee" or
"white" would be lying in one theme or the other.
Section 02 · Three voices
Three voices, one job each: brush to set the mood, a tracked caption to label it, and a plain UI sans for everything a thumb reads. The brush is a Simplified-Chinese calligraphy face; its CJK is shown below because that is what the stack exists to render.
山水清音
墨韵
Display only, weight 400. Horizontal or writing-mode: vertical-rl in a poster.
Brush display, Latin
The same face carries Latin, so a title does not change hand mid-line.
Section 02 · Typography · Plate 01
Georgia, 10px, uppercase, tracked 0.3em. Labels a thing; never carries the thing.
Item title, one line
Supporting line · secondary detail
System UI sans with PingFang SC / Noto Sans SC for CJK, 10-15px. Everything that is operated or counted.
| Level | Voice | Size / weight | Tracking | Where |
|---|---|---|---|---|
| poster-v | brush | 2.35rem / 400 | 4px | Vertical poster title (.cg-poster-title-v). |
| poster-h | brush | 2.1rem / 400 | 0 | Horizontal poster title. |
| mark | brush | 1.7rem / 400 | 0 | The mark at the head of a banner. |
| empty | brush | 1.25rem / 400 | 0 | Empty-state line. |
| poster-sub | brush | 1.05rem / 400 | 0 | The aside under a poster title, in --primary. |
| caption | caption | 10px | 0.3em | Caption rules, panel labels. |
| caption-sm | caption | 8-9px | 0.18-0.25em | Under tile and banner labels, inside buttons. |
| body | ui | 15px / 400, lh 1.6 | 0 | Running text. |
| label | ui | 13-14px / 600 | 0 | Row names, buttons, chips, tile labels. |
| sub | ui | 11px / 400 | 0 | Row sub-lines, in --muted. |
| micro | ui | 10px / 600-700 | 0 | Tab labels and badge counts. The floor. |
Section 03 · A narrow column
Components are drawn for one narrow column, 312px of frame with a 14px inset. Inside it the rhythm is small and even; outside it, the mount gives the column generous room.
| 4 | Icon to label in a tile. | |
| 8 | Between tiles, chips, icon and text. | |
| 10 | Between blocks on a stage; inside a row. | |
| 14 | The stage inset; banner gap. | |
| 16 | Poster padding. | |
| 22 | Catalog panel padding. | |
| 72 | Between catalog sections. |
| Measure | Value | Note |
|---|---|---|
| column | 312px | .cg-frame: 9px bezel around the stage. |
| stage inset | 14px | Leaves a 276px content width. |
| tile row | 4 columns | Four tiles is the most a row carries. |
| page | 1120px | Catalog measure, 24px side margin. |
| break | 900px | Grids collapse to one column. |
| break | 420px | 16px gutter; the frame takes the full width. |
Section 04 · Soft blocks, square seals
Every block is a soft 14px rectangle, every control that is pressed is a pill, and the seal alone is square. There are no borders on surfaces - a block is told apart by its fill.
| --radius-seal | 2px | Seals. The one hard corner. | |
| --radius-block | 14px | Posters, tiles, sheets, banners. | |
| tab bar | 18px | Top corners only; it docks to the foot. | |
| --radius-stage | 20px | The stage inside a frame. | |
| --radius-frame | 28px | The frame. Stage radius plus the bezel, near enough that the two curves run parallel. | |
| --radius-pill | 999px | Buttons, chips, fields, the notice bar. |
| --shadow-frame | A composed column, lifted off the mount like a sheet pinned to it. |
| --shadow-float | The action bar, the one control that floats over content. |
| everything else | Flat. Paper on paper is separated by a change of fill. |
Section 05 · A press and a scroll
Restrained. A press darkens and settles 1px; the notice line scrolls on a slow loop. Nothing else moves. Press the button and hover the bar.
| --t-press | 100ms | Every press: fill, colour, the 1px drop. |
| --ease | ease | The only curve. |
| press | translateY(1px) | The largest displacement a control makes. |
| --t-marquee | 20s linear | One pass of the notice line. Pauses on hover and focus. |
prefers-reduced-motion the transitions drop out and the
notice line stands still, and nothing on the page is lost.
Section 06 · Ink wash
One optional surface treatment: an ink wash. Three ridges of ink drift slowly across absorbent paper in front of the disc, each darkest at its crest and thinning to mist below. The pointer is a loaded brush - rest it on the right-hand panel and ink blooms into the fibres.
| Uniform | Value | What it does |
|---|---|---|
| uReach | 0.2 | Radius of the brush bloom, in stage heights. |
| uBleed | 0.6 | How far ink feathers past a hard edge - the ridge crests and the frayed rim of the bloom. At 0 the wash turns into cut paper. |
| uFibre | 0.04 | Paper fibre, drawn as the faintest possible ink so it stays inside the palette. |
| uDrift | 0.018 | Ridge drift, in stage widths per second. The near ridge moves fastest, which is the only depth cue. |
| uDiscAt / uDiscR | 0.70, 0.62 / 0.17 | Where the disc sits and how large. The CSS fallback draws it in the same place. |
| uPaper / uDisc / uInk | tokens | Read from --paper, --disc and --ink at runtime, and re-read on every theme change. |
| spring | k 40 / d 8 | The brush follows the pointer on a spring, heavier than a cursor, so it arrives rather than snaps. |
mix(mix(uPaper, uDisc, disc), uInk, ink) - only three
pigments go in, so only three can come out, and the greys between them.
After dark the same line gives pale ink on dark paper in front of a dim
moon, with no second shader. It stops rendering off screen, and under
prefers-reduced-motion it draws one settled frame and never
starts a loop. Without WebGL2 the canvas never becomes visible, and the
left panel is the whole design.
Where it belongs: behind a poster, or filling an empty state that has nothing else to show. Not behind a list, a field or any running text - it is the decorative register, and the working surface never carries it.
Section 07 · Every state, live
Everything here works: press to see the press, click chips and tabs, step quantities, type in the field. Where a state is also pinned for comparison, the caption says so.
Press darkens to --primary-press and drops 1px over 100ms; the outline takes a --primary-wash. Disabled is a real disabled at 45% opacity. There is no hover state - the system is drawn for touch, and the press is the feedback.
A --card pill at rest; selected fills with --primary. Click one - the selection moves.
A real input in a --card pill; focus rings the whole pill.
Idle, pressed (pinned; press any tile to see it live), and badge - the seal's one other job. Tile icons are always the 2px line voice, never brush art.
Item title
Supporting line · detail
No.01
Second item
Supporting line · detail
No.02
A row carries a name, a sub-line, one value and one round action. Once it has a quantity, the action grows into a stepper. Step it to zero and the minus disables itself.
A real checkbox: --card track with a --primary-line edge; on fills with --primary.
Idle tabs in --primary-soft; the active one in --primary with a dot beneath. Click to move it.
Summary title
Supporting line · detail
128
Stat key
The banner is a --primary block with a faint 115° hairline weave and a brush mark. The summary is a sheet: title left, one stat right.
The one floating control: a --primary pill with --shadow-float, the button inside it inverted. One per surface - it owns the final decision.
Nothing here yet
Empty state · caption
Ink art at --ink-faint, a brush line, a caption, one quiet action. The one place outside a poster where brush art is allowed.
One class swaps the grounds: --stage, --paper, --card and --sheet take their --alt-* values, type on the ground takes --on-alt. Same grammar everywhere else.
Section 08 · Ink, disc, seal
Six solid-ink still lifes, a disc behind each, and a seal nearby. These are what make the system recognisable - not the palette. Draw new subjects in the same hand: solid fills, tapered ends, small white gaps.
Poster title
a brush aside
Caption between rules
Paper block, brush title, disc and ink art, a caption between rules, one seal. The disc never carries text.
Welcome · Plate 08
30px or 44px, 2px corner, a carved mark or a two-letter monogram in --on-seal. The caption rule labels a poster the way a colophon labels a scroll.
Section 09 · One composed column
The parts assembled into one column: a poster sets the mood, the working surface under it stays plain, and one primary block owns the decision. The copy is placeholder by design - what matters is how the parts sit.
Specimen
a composed column
Plate 09
First item
Supporting line
Second item
Supporting line
Third item
Supporting line
| Part | As built | Why it is that |
|---|---|---|
| Poster | flush, 120px | The only brush art on the surface. It sits flush with the stage so the mood is a place, not a card. |
| Disc | --disc-wash | Washed and pushed off the corner: the poster is short, and a full disc would outweigh everything under it. |
| Controls | sans + line icons | From the search field down, nothing is brush. The line between registers is the poster's caption rule. |
| Rows | --sheet, --rule | One raised sheet, hairlines between rows. Steppers only where a quantity exists. |
| Action bar | --primary, float | The one deep block and the one shadow on the surface, pinned to the foot. It owns the decision; its badge follows the steppers. |
| Seals | 0 | None here: the caption does the signing, and a badge already spends the hot colour once. |
| Tab bar | --sheet, 18px top | Docked, not floating; safe-area cushion under the labels. |
Section 10 · The refusals matter more
Do
--ink only; --primary there is for large titles.Do not