The Grammar of the Box

An anatomy for a house that expects to be disobeyed.

Jewelbox is not a dark theme applied to Quartz. It is meant to become an object, a place, and eventually a collection of rooms whose interfaces feel authored rather than generated by software.

The physical jewelry box is the ancestral body of that system: dark shell, intimate lining, mirror, fittings, compartments, inserted papers, small precious objects, mechanisms, and an exterior world beyond the opened box. But ancestry is not imprisonment. The purpose of the grammar is to make later mutation meaningful.

The central distinction: role is not substance

The stable layer is semantic:

• world
• shell
• lining
• structure
• hardware
• threshold
• insert
• jewel

The canonical Jewelbox dialect currently renders those roles as:

• world → Night
• shell → dark lacquer
• lining → red interior / velvet-brocade family
• structure → dark wood / carcass
• fittings (hardware backend key) → tarnished gilt / brass
• threshold → aged mirror
• insert → aged paper
• jewel → jade

These expressions are defaults, not identities. A room may keep the role and replace the substance.

A future poem may say, in effect:

• world → fog
• shell → moonlit stone
• lining → ocean
• structure → roots
• fittings → shells
• threshold → water surface
• insert → a wet letter
• jewel → a pearl

The page is still built on the same anatomy even though it no longer resembles a literal jewelry box.

Secondary prose furniture

Not every visual object belongs among the eight material roles. Ordinary Markdown primitives may still acquire a restrained house expression when that helps Jewelbox feel fabricated rather than software-default.

Blockquotes are the first example. They are not Thresholds and should never receive Mirror merely because they are inset text. The canonical default treats them as minor wooden inlays: subdued, readable, and materially subordinate. A room may later reinterpret quotation as cloth, water, fog, a carved plaque, or something else without changing the Markdown syntax.

This establishes a useful distinction:

• material roles describe the anatomy of the box;
• prose furniture describes how ordinary authored forms inhabit that anatomy.

Both should remain systematizable. An author should not need HTML to make a quotation belong to the room.

The corrected anatomy: black outside, red inside

The physical reference boxes clarified an important mistake in the first material studies. Lacquer should not be asked to represent the entire interior world.

Shell lacquer is protective. Red lining is receptive.

The dark material belongs to enclosure, framing, carcass, exterior quiet, and protection. The red material belongs to the inside of attention: the chamber that receives objects, memory, intimacy, seduction, devotion, and handling.

This establishes a useful polarity:

dark shell / red chamber

The reading center may remain calmer than either extreme, but it should be understood as a well or tray set into the object rather than as proof that the whole interior is black.

World

World is what surrounds the object rather than what is printed on it.

The current default is animated Night: an explicitly old-web field of tiny stars outside the opened box. Its important architectural discovery was that ambience must belong to the world layer itself, not be painted as a child of the page center.

World should therefore remain a universal component-level office. Later expressions might include rain, underwater particulate, snowfall, moths, smoke, dawn, dust, forest darkness, or something procedural.

The role is environmental. It is normally not authored as a local Markdown object.

Shell

Shell is enclosure, protection, boundary, and chassis.

The canonical default is deep urushi lacquer: almost black, hard, polished, and built in depth rather than treated as a generic dark background. Sparse nashiji belongs inside that lacquer as particulate material memory. Selective maki-e belongs to Shell as local, edge-bound ornament; the process is canonical, while the pictured motif may mutate by room.

Shell is not the normal prose substrate. It provides the hard body, exposed planes, bevels, lips, thickness, and gaps into which other materials are fitted. Most finished reading should be received by Lining or another room-specific receiving interior layered over the chassis.

Shell is not intimacy. That belongs to lining. Nor is Shell Structure: Structure is what supports the lacquered body from beneath and may become visible where the Shell is absent, worn, cut, or deliberately opened.

Future rooms may reinterpret Shell radically—stone, bark, painted metal, ceramic, skin, ice, or something impossible—but its office remains the thing that encloses, protects, and gives other materials a physical surface on which to act.

Lining

Lining is the receiving interior. It is the canonical home of most sustained prose in finished Jewelbox rooms: the substance that receives writing, objects, and attention without asking Shell to become a reading surface.

The corrected default is explicitly red. The current canonical specimen now takes the imperial crimson fabric as its principal visual memory: dense, woven, fitted, and receptive rather than merely a flat red panel. Velvet remains a sibling lining dialect rather than the only canonical answer. The family should still branch rather than collapse into one universal texture:

• imperial crimson weave → canonical / fitted / receptive lining
• crimson velvet → intimate / plush / chamber lining
• purple velvet → nocturnal / noble / reliquary lining
• red brocade → mechanical / side-tray / fitted lining
• dark floral → secret / dream / shrine / hidden lining

These are dialects of one role. A room can replace all of them with ocean, forest, hair, clouds, photographs, animation, or something stranger.

The important law is not “lining must be velvet.” It is that lining is the substance that receives what is placed inside.

Structure

Structure is the carcass beneath ornament.

Wood enters the ecology here: drawer walls, supports, backing boards, dividers, underfaces, and the hidden construction that proves the object is built rather than merely decorated.

Structure may often be partially concealed. Its presence matters because it lets future compartments have thickness, depth, separation, and believable joins.

Fittings

Fittings articulate construction. The stable semantic/backend key remains hardware so existing frontmatter and the material resolver do not need a migration merely because the public vocabulary has improved.

Gilt belongs to hinges, locks, catches, escutcheons, corner mounts, feet, plates, rails, filigree, and other pieces attached to another substance. Gold is the principal metal of this office; brass is its lesser, warmer functional relative. The crucial distinction is that Fittings do not own a field in the way Shell, Lining, Wood, Paper, Mirror, or Jade can. They mount onto those materials. Ornament may therefore become exuberant—scrolling foliage, openwork, cast leaves, rococo curls—without turning the entire reading object into a gold rectangle. When gold is sprayed across a surface merely to make it luxurious, it stops behaving like a fitting and becomes theme color.

The most successful interaction states should follow the same law: a latch releases, a jewel fills, a fitting catches light, a label turns, a compartment opens. Generic scaling and arbitrary hover color are weaker than material state change.

Threshold

Threshold mediates between conditions.

The canonical expression is the aged Mirror, and this is the first material law considered substantially resolved.

Its important discoveries were:

• deterioration belongs primarily to the perimeter, not to an evenly repeated field;
• the desilvering is asymmetric and non-repeating;
• the center survives more quietly;
• mirror should remain backed glass, not become a transparent window;
• slight translucency can imply glass without revealing obvious wallpaper beneath it;
• scratches and pinholes should be sparse;
• interaction should illuminate local surviving fragments rather than send a generic travelling shine across the pane;
• the frame is inset, interrupted, worn fitting rather than ornate decoration added afterward.

The deeper symbolic office is reflection / mediation / return. Later threshold dialects could become water surfaces, doors, windows, veils, screens, gates, fog banks, or other crossings.

Insert

Insert is human record: something placed inside the box by a hand.

Paper belongs here. It is foreign to the native body of lacquer, lining, structure, and fittings. That difference is useful.

The paper should be dimmer and warmer than ordinary web white: fibrous, handled, archival, still legible. Its current canonical direction is a burnished brown-ivory slip with irregular outline and restrained singeing concentrated at corners and edges, while the center deliberately preserves darker ink contrast. Like Mirror, deterioration becomes more convincing when it obeys an object’s anatomy rather than being evenly wallpapered across the field. It can host provenance, catalog fragments, dates, labels, found-again slips, letters, little inventories, and evidence of touch.

The semantic primitive should remain easy to author through native Markdown/callouts. Complexity belongs under the floorboards, not in the note source.

Jewel

Jewel is condensed significance.

Jade is the current default expression. The stone is allowed to be visually rich enough to deserve the object: veining, mineral contrast, and a local glint may occupy the surface itself. The material should not be hidden under an opaque text card; support for reading belongs in restrained shadow and minimal local smoke. It works only if it remains quarantined. If links, scrollbars, active navigation, and miscellaneous interface states become green, jade ceases to feel precious and becomes merely the site’s accent color.

A jewel may be stone, pearl, charm, star, tooth, seed, eye, medal, flower, photograph, or another rare state in a room dialect. The role means that significance has condensed into a local object.

Pattern is material, not wallpaper

The old-web research and Internet Pattern Book experiments changed the direction of the project substantially.

Repeating images are valuable not because early websites used them, but because they can make a digital surface feel accumulated, handmade, obsessive, cheap, precious, personal, and visibly authored. That is part of the strange expressive freedom Jewelbox wants to recover from the pre-platform web.

But a pattern should answer a material question:

• Is this pressure in velvet?
• Grain in wood?
• Fibre in paper?
• Fleck in lacquer?
• A secret lining?
• A world beyond the box?

Patterns that merely decorate an arbitrary rectangle are weaker than patterns whose repeat, direction, scale, edge behavior, and imperfections follow the material’s supposed construction.

The Mirror proved the complementary law: some materials should not repeat at all. Edge-anchored deterioration was more convincing precisely because it belonged to the object’s boundary.

Stability and mutation

The global Velvet Reliquary remains approximately seventy percent stable reading/interface and thirty percent mutation. Individual rooms may have their own ratios.

This is not aesthetic timidity. The stable center makes stronger mutations possible because there is something legible for them to deform.

A useful default principle is:

the center reads; the periphery remembers that this is a strange object.

But rooms may break even that rule when the content earns it.

The inheritance chain

Material behavior should cascade through four layers:

1. Jewelbox default — the ancestral black/red box.
2. Room dialect — a room reinterprets any role.
3. Page mutation — one page develops its own weather or matter.
4. Local object — an inserted paper, jewel, threshold, or other deliberate object can remain semantically itself inside the mutated room.

In shorthand:

anatomy → house style → room → weather → object

That is how a poem may become an ocean without making the rest of Jewelbox forget what a lining is.

Ownership

Not every material should be manually requested by the author.

System-owned: world, shell, structural framing, major fittings, compartment seams.

Room-derived: default lining, room atmosphere, mutations of shell/world/threshold, decorative ecology.

Author-owned: rare local objects such as an inserted paper, a jewel-state, a deliberate threshold, or another object whose presence is editorial rather than derivable.

The authoring rule follows:

do not make the user manually encode information the system can derive reliably.

The default box is scaffolding

The canonical jewelbox should become coherent enough that a visitor can unconsciously learn its anatomy.

Only then should rooms begin their acts of vandalism.

Songs from the Well may flood its lining. Night Country may replace dividers with stairs or doors. A Shrine may become floral, fleshy, serpentine, or devotional. The Inner Country may eventually cease to resemble the physical box almost entirely. Different poems may develop different climates.

This is desirable.

The rule is not that rooms must resemble the ancestral object. The rule is that when they break it, they should know which structural role they are transforming.

Toward the chassis

The current three-column Quartz layout has begun to reveal itself as potential physical architecture rather than mere web layout.

The Cabinet and contextual apparatus can become side compartments; the reading center can become a central well or tray; the surrounding Night can remain the exterior world. Reader Mode already hints at a mechanical transformation by moving the gilded boundary from the outer house toward the surviving center.

A future chassis should therefore distinguish:

• outer shell;
• side trays;
• central reading well;
• structural dividers;
• lining;
• fittings and seams;
• world beyond the box.

The material registry being built now exists so that chassis can later be real infrastructure rather than another bespoke page illusion.

Current status

Substantially resolved:

• Velvet Reliquary global typography
• Night as world-layer architecture
• Mirror as aged-threshold material law
• semantic material roles as infrastructure direction

Still being developed:

• Shell lacquer as a narrower exterior/chassis law
• the red lining family, now promoted to canonical receiving interior
• burnished / edge-singed paper as canonical insert
• jade as a visibly stone Jewel expression
• structure / wood
• fittings / gilt, now understood as literal mounted ornament and articulation
• ordinary prose furniture and its room-level mutations
• three-compartment chassis
• room-specific dialects

Nothing above prevents future rooms from becoming stranger. That possibility is the reason the grammar exists.