茶馆Chaguan

茶馆 Chaguan

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

Read this first

  1. These values are the system. Every token below exists in css/chaguan-core.css. Use them; do not invent parallel ones - no raw hex, no new radius, no new duration.
  2. Two registers, never mixed. Brush type and ink art belong to posters and empty states. Anything a thumb operates gets the UI sans and a 2px line icon.
  3. The seal is punctuation. At most two per surface, never behind body copy; its only other job is the live count badge.
  4. The disc never carries text. It sits behind art or a title and holds nothing of its own.
  5. Token names are roles. --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.
  6. Search before you build. A row, a tile, a round button and a pill cover almost every control; a sixth shape is a conversation about the system.

Colour

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.

--mountThe ground everything is pinned to. Only ink, or large type, sits on it.#B08D63#17110C
--paperPosters, panels, and the default stage.#F0E8D3#262019
--cardRecessed fills: tiles, fields, chips at rest.#E8DDC4#30281F
--sheetRaised sheets: lists, the notice bar, the tab bar.#FBF8F0#3A3026
--inkText, brush art, display type.#2A2620#EFE6D2
--primaryThe deep fill: buttons, selected states, captions.#4A3421#D8B98A
--primary-pressThe primary fill while it is held down.#38271A#C4A372
--on-primaryText and icons set on a primary fill.#F0E8D3#241A10
--discThe disc behind art. Never carries text.#C9A35F#7D6234
--sealSeals and live badges. The only hot colour.#B5442C#B84A31
--on-sealThe carved mark inside a seal or badge.#FBF8F0#FBF8F0
--alt-groundThe alternate stage ground. One surface at a time.#5C6B46#3F4A33
--alt-paperReplaces --paper inside the alternate ground.#EDEEDA#2A2F22
--alt-cardReplaces --card inside the alternate ground.#E2E3C8#333A2A
--alt-sheetReplaces --sheet inside the alternate ground.#F6F4E6#3C4433
--on-altType set straight on the alternate ground.#F6F4E6#EEF0DC
--frameThe bezel around a composed column.#241C14#0B0806

Derived - mixed from the roles, so they follow the theme

TokenValueJob
--stage--paperThe ground inside a frame. .cg-alt points it at --alt-ground.
--mutedink 72%Secondary text: sub-lines, notes, keys.
--ink-faintink 34%Ink art in an empty state, deliberately quiet.
--primary-softprimary 80%Idle tab labels, placeholders, small captions.
--primary-lineprimary 40%An idle control's outline: the toggle track, table heads.
--primary-washprimary 12%The press wash under an outlined control.
--ruleprimary 14%The hairline between rows.
--disc-washdisc 36%A washed disc, for when a full one would shout.

Contrast floor - measured, light / dark

PairLightDarkRule
--ink on --paper12.3:113.0:1Body text anywhere on paper.
--ink on --mount4.9:115.1:1The only small text allowed on the mount.
--primary on --mount3.8:110.0:1Large text only. Section titles, never a sentence.
--primary on --paper / --card / --sheet9.5 / 8.6 / 11.08.6 / 7.7 / 6.9Captions, values, tile labels.
--on-primary on --primary9.5:19.1:1Buttons, selected chips, the action bar.
--muted on --paper / --card5.4 / 5.17.4 / 6.8The smallest secondary text, 11px.
--on-seal on --seal5.2:14.9:1Badge counts and the carved mark.
--on-alt on --alt-ground5.2:18.1:1Anything set straight on the alternate ground.
After dark, the fill and its text trade places - which is why the tokens are named for roles. By day --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.

Typography

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.

--font-brush · Ma Shan Zheng

山水清音

墨韵

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.

--font-caption · --font-ui

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.

Levels - as built

LevelVoiceSize / weightTrackingWhere
poster-vbrush2.35rem / 4004pxVertical poster title (.cg-poster-title-v).
poster-hbrush2.1rem / 4000Horizontal poster title.
markbrush1.7rem / 4000The mark at the head of a banner.
emptybrush1.25rem / 4000Empty-state line.
poster-subbrush1.05rem / 4000The aside under a poster title, in --primary.
captioncaption10px0.3emCaption rules, panel labels.
caption-smcaption8-9px0.18-0.25emUnder tile and banner labels, inside buttons.
bodyui15px / 400, lh 1.60Running text.
labelui13-14px / 6000Row names, buttons, chips, tile labels.
subui11px / 4000Row sub-lines, in --muted.
microui10px / 600-7000Tab labels and badge counts. The floor.
Legibility is never asked of the brush. A calligraphic face is beautiful exactly because its strokes vary, and that variation is what makes it slow to read at small sizes. So the brush only ever sets a mood at 1rem and up, and every number, count and state belongs to the UI sans. If a piece of text has to be read correctly, it is not brush.

Space and layout

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.

Rhythm - the steps in use

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.

Layout

MeasureValueNote
column312px.cg-frame: 9px bezel around the stage.
stage inset14pxLeaves a 276px content width.
tile row4 columnsFour tiles is the most a row carries.
page1120pxCatalog measure, 24px side margin.
break900pxGrids collapse to one column.
break420px16px gutter; the frame takes the full width.
The steps stop at 16 inside a stage. Brush art and a disc already make a poster feel roomy, so the working surface under it can stay tight: 8 between siblings, 10 between blocks. Pad the controls as generously as the poster and the column stops reading as one sheet.

Form

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.

Radii

--radius-seal2px
Seals. The one hard corner.
--radius-block14px
Posters, tiles, sheets, banners.
tab bar18px
Top corners only; it docks to the foot.
--radius-stage20px
The stage inside a frame.
--radius-frame28px
The frame. Stage radius plus the bezel, near enough that the two curves run parallel.
--radius-pill999px
Buttons, chips, fields, the notice bar.

Elevation - two shadows, both earned

--shadow-frameA composed column, lifted off the mount like a sheet pinned to it.
--shadow-floatThe action bar, the one control that floats over content.
everything elseFlat. Paper on paper is separated by a change of fill.
The seal is square because everything else is not. In a field of soft blocks and pills, a 2px corner is the loudest shape available, and the seal needs to be loud at 30px. Round the seal to match its neighbours and it becomes a red dot - a notification, not a signature.

Motion

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.

Tokens

--t-press100msEvery press: fill, colour, the 1px drop.
--easeeaseThe only curve.
presstranslateY(1px)The largest displacement a control makes.
--t-marquee20s linearOne pass of the notice line. Pauses on hover and focus.

Live

A slow line of supporting text · it pauses under the pointer · and stops for reduced motion
A press is a stamp, not a bounce. 100ms and one pixel is the feeling of a seal meeting paper: short, final, no overshoot. Under prefers-reduced-motion the transitions drop out and the notice line stands still, and nothing on the page is lost.

Screen

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.

Static fallback · paper, disc, wash
Live · rest the pointer on it

Uniforms

UniformValueWhat it does
uReach0.2Radius of the brush bloom, in stage heights.
uBleed0.6How 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.
uFibre0.04Paper fibre, drawn as the faintest possible ink so it stays inside the palette.
uDrift0.018Ridge drift, in stage widths per second. The near ridge moves fastest, which is the only depth cue.
uDiscAt / uDiscR0.70, 0.62 / 0.17Where the disc sits and how large. The CSS fallback draws it in the same place.
uPaper / uDisc / uInktokensRead from --paper, --disc and --ink at runtime, and re-read on every theme change.
springk 40 / d 8The brush follows the pointer on a spring, heavier than a cursor, so it arrives rather than snaps.
The palette rule is structural here. The shader's last line is 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.

Components

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.

Buttons

Primary
Secondary
Small

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.

Chips - single select

A --card pill at rest; selected fills with --primary. Click one - the selection moves.

Search field

A real input in a --card pill; focus rings the whole pill.

Tiles

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.

Rows and stepper

Item title

Supporting line · detail

No.01

Second item

Supporting line · detail

No.02

2

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.

Toggle

A real checkbox: --card track with a --primary-line edge; on fills with --primary.

Tab bar

Idle tabs in --primary-soft; the active one in --primary with a dot beneath. Click to move it.

Banner and summary

A single line of banner copy

Caption · secondary

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.

Action bar

3 3 selectedSummary line

The one floating control: a --primary pill with --shadow-float, the button inside it inverted. One per surface - it owns the final decision.

Empty state

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.

Alternate ground - .cg-alt

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.

Every control is one of four shapes - a soft tile, a pill, a round button, a row. That is deliberate: the posters above them are where the variety lives, so the working surface can afford to be boring, and a reader who has seen one pill knows every pill.

Motifs

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.

TeapotFull disc
BowlWashed disc
Plum branchDisc off the edge
BambooSetting disc
Flask and cupOffset disc
Bowl and sticksFull disc

Poster

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.

Seal and caption rule

Seals
Disc
Caption

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.

The disc is what lets flat ink read as a painting. A solid-black teapot on cream is clip art; put a flat disc behind it and the eye reads sun, space and a horizon that is not drawn. That is why the disc may be halved, washed or pushed off the edge, but never removed - and why it never carries text, which would turn it back into a button.

Composition

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

1

Second item

Supporting line

0

Third item

Supporting line

2
3 3 selectedSummary line

Anatomy

PartAs builtWhy it is that
Posterflush, 120pxThe only brush art on the surface. It sits flush with the stage so the mood is a place, not a card.
Disc--disc-washWashed and pushed off the corner: the poster is short, and a full disc would outweigh everything under it.
Controlssans + line iconsFrom the search field down, nothing is brush. The line between registers is the poster's caption rule.
Rows--sheet, --ruleOne raised sheet, hairlines between rows. Steppers only where a quantity exists.
Action bar--primary, floatThe one deep block and the one shadow on the surface, pinned to the foot. It owns the decision; its badge follows the steppers.
Seals0None here: the caption does the signing, and a badge already spends the hot colour once.
Tab bar--sheet, 18px topDocked, not floating; safe-area cushion under the labels.
Note what this is not: a screen from a product with the copy swapped. The labels are placeholders because the structure is the point - one poster, a plain working surface, one deep block owning the decision. Swap the ink subject and the words, and the same column fits any list-and-decide task.

Rules

Section 10 · The refusals matter more

Do

  • Keep brush art in posters and empty states. Give task rows the 2px line icons.
  • Put the disc behind art or a title - full, washed, halved or off the edge.
  • Keep values, counts and states in the UI sans.
  • Give each surface one deep block that owns its decision.
  • Set small text on the mount in --ink only; --primary there is for large titles.
  • Check both themes with the masthead toggle before calling anything done.

Do not

  • Use brush illustrations as icons inside rows, tiles or tabs.
  • Put text on the disc, ever.
  • Use more than two seals on a surface - a seal is punctuation, not a pattern.
  • Set task-critical text in brush or caption.
  • Add a border or a third shadow; blocks separate by fill.
  • Use the alternate ground on more than one surface of a composition - it is a variant, not a second theme.
  • Run the ink wash behind a list or running text.