# Design Language for courthouse.app

## Aesthetics and Tone

courthouse.app inhabits the visual world of a brutalist courthouse lobby after hours -- the kind of space where polished stainless steel columns reflect distorted images of marble floors, where the hum of fluorescent light is the only sound, and where the authority of justice is expressed not through warmth but through the sheer mass and reflectivity of materials. The aesthetic is **grainy-textured**: every surface carries a subtle photographic grain, as if the entire interface were captured on high-ISO film inside a government building at twilight. This grain is not decorative noise; it is the texture of institutional gravitas rendered through the language of analogue photography.

The tone is **opulent-grand** -- not the gilded opulence of a Versailles ballroom, but the cold opulence of mid-century civic architecture: buildings designed to make citizens feel the weight of the state. Think Eero Saarinen's TWA Terminal crossed with a federal reserve vault. Every element communicates permanence, consequence, and the quiet theater of legal proceedings. The experience should feel like walking into a courtroom where the ceiling is three stories high, the bench is carved from a single slab of granite, and every footstep echoes against chrome-clad walls.

The visual inspiration draws from three specific sources: (1) the chrome-and-concrete interiors of Tadao Ando's Church of the Light, where material austerity becomes spiritual intensity; (2) the grainy, high-contrast photography of Daido Moriyama, where urban surfaces become abstract compositions of light and shadow; (3) the ceremonial formality of Supreme Court architecture, where symmetry and scale encode authority into physical space. The result is a site that feels simultaneously ancient and futuristic -- a courthouse that exists outside of time, rendered in chrome and grain.

## Layout Motifs and Structure

The layout follows a **broken-grid** paradigm: content blocks are deliberately misaligned, overlapping, and fractured, as if the ordered columns of a classical courthouse facade have been subjected to tectonic stress. This is not random chaos; it is controlled asymmetry that mirrors the tension between order and disruption inherent in legal proceedings. Every element has a precise position, but that position defies the expectation of alignment.

The page is organized into "chambers" -- full-viewport sections that function as discrete rooms in a courthouse. Each chamber has its own gravitational logic:

- **The Atrium (Hero):** A full-bleed opening section where the domain name is set in massive type, displaced 15% to the right of center and 30% down from the top. A vertical chrome bar (4px wide, 60vh tall) sits at the left margin, acting as a structural spine. The grain overlay is heaviest here (opacity 0.09), establishing the textural baseline.

- **The Gallery (Content Sections):** Content blocks are arranged in a broken grid with intentional 8-12% overlap between adjacent elements. Text containers are set at widths between 40% and 65% of the viewport, positioned at alternating horizontal offsets (left block at 5% margin, next block at 30% margin, next at 12% margin). Images and decorative elements bleed outside their containers by 15-25%, creating a sense of content that refuses to be contained by its frame.

- **The Bench (Feature Highlights):** Key content is presented in oversized containers (80-90% viewport width) with dramatic internal padding (8rem top/bottom). These wide containers break the rhythm of the narrower broken-grid blocks above, creating a moment of expansive authority before the grid fractures again.

- **The Archive (Footer):** The footer collapses into a dense, compressed grid (three columns, tight 1rem gutters) that contrasts sharply with the airy broken-grid above. This compression creates a visual metaphor for the density of legal records.

Vertical rhythm is irregular by design: section gaps alternate between 6rem and 14rem, preventing the eye from falling into a predictable scroll pattern. Horizontal rules are replaced by thin chrome lines (1px, rgba(192,192,210,0.3)) that extend beyond their parent containers, bleeding into the margins like the edges of a legal document extending past its binding.

## Typography and Palette

**Typography:**

- **Display / Headlines:** "Space Grotesk" (Google Fonts) -- a proportional sans-serif with a distinctive geometric skeleton and open apertures. Its slightly squared terminals and uneven stroke modulation give it an engineered, industrial quality that fits the courthouse vernacular. Used at 4rem-8rem for primary headings, weight 700. Letter-spacing: -0.03em at display sizes, creating a tight, compressed authority. All headlines in uppercase with tracking of 0.08em -- the only element permitted to use uppercase, mirroring the engraved lettering on courthouse facades.

- **Body Text:** "Inter" (Google Fonts) -- a humanist sans-serif optimized for screen readability, weight 400 for body, 500 for emphasis. Set at 1.05rem with a line-height of 1.72 -- generous leading that gives each line of text the breathing room of a well-spaced legal brief. Letter-spacing: 0.005em. Paragraph max-width: 38em, ensuring comfortable reading measure.

- **Accent / Labels:** "IBM Plex Mono" (Google Fonts) -- a monospaced typeface used exclusively for metadata, labels, dates, and numerical data. Weight 400, size 0.8rem, letter-spacing 0.06em, uppercase. This creates a systematic, indexical quality for secondary information, as if every label were a court filing number.

- **Pull Quotes / Callouts:** "DM Serif Display" (Google Fonts) -- a high-contrast serif used sparingly for pull quotes, section epigraphs, and decorative text. Weight 400, italic, size 2.2rem-3rem. Its sharp, refined serifs provide a moment of classical elegance against the grotesk sans-serif landscape, like finding a calligraphic inscription inside a concrete building.

**Palette:**

The palette is **chrome-metallic** -- a spectrum of silver, gunmetal, and reflective grays punctuated by organic warmth.

| Role | Color | Hex | Description |
|------|-------|-----|-------------|
| Chrome Primary | Polished Silver | `#C0C8D2` | The dominant surface color -- the cool, blue-shifted gray of brushed stainless steel under fluorescent light |
| Chrome Dark | Gunmetal | `#2C2F36` | Deep charcoal with a metallic blue undertone, used for primary backgrounds and text containers |
| Chrome Deepest | Vault Black | `#12141A` | Near-black with violet undertones, the color of a courthouse corridor at night |
| Reflective Accent | Liquid Mercury | `#E8ECF2` | High-value silver-white used for highlights, hover states, and reflective surfaces |
| Organic Warm | Oxidized Bronze | `#8B7355` | A warm, muted bronze that introduces organic warmth -- the patina on courthouse door handles |
| Organic Accent | Tarnished Gold | `#A69060` | Muted gold used sparingly for active states, links, and leaf motif accents |
| Signal Green | Verdigris | `#5A8A6A` | A desaturated green-gray, the color of aged copper -- used for success states and organic leaf elements |
| Alert Warm | Judicial Red | `#8B4A4A` | A muted, desaturated red -- not alarming, but solemn, like the binding of a law book |

Background gradient: linear gradient from `#12141A` (top) through `#1A1D24` (middle) to `#12141A` (bottom), creating a subtle vignette effect. The grain overlay sits atop this gradient at all times.

## Imagery and Motifs

**Film Grain Overlay:**
The entire page is overlaid with a grainy-textured film grain that is the foundational visual identity of the site. A full-viewport `::before` pseudo-element on `<body>` uses a 300x300 repeating grain tile with `opacity: 0.07` and `mix-blend-mode: overlay`. The grain animates: every 80ms, the `background-position` shifts by a random pixel offset using a CSS animation with `steps(6)`, creating the subtle flicker of 16mm film projection. This grain never turns off. It is the air that the site breathes. On dark backgrounds, the grain reads as silver dust on steel; on lighter elements, it reads as the texture of aged parchment under a photocopier. The grain intensity increases to 0.12 on hover states, as if the camera is pushing closer to the subject.

**Geometric-Abstract Imagery:**
All visual elements are **geometric-abstract** -- no photographs, no illustrations of people or objects. Instead, the site uses compositions of pure geometric forms: intersecting planes, overlapping rectangles, concentric circles, and angular fragments. These are rendered as SVG elements with chrome gradients (`#C0C8D2` to `#2C2F36`) and subtle drop shadows that suggest depth without realism. The geometric compositions reference the angular, monumental forms of courthouse architecture: the sharp corners of a judge's bench, the circular seal of a court, the rectangular frames of legal documents. Each geometric composition is unique to its section and responds to scroll position, with individual shapes translating and rotating at different rates to create a subtle parallax within the composition itself.

**Leaf-Organic Motifs:**
Threading through the chrome-and-concrete geometry are delicate **leaf-organic** motifs -- stylized leaf forms rendered as thin SVG path strokes (1-2px) in Verdigris (`#5A8A6A`) and Tarnished Gold (`#A69060`). These are not realistic botanical illustrations; they are abstracted leaf silhouettes reduced to their essential curves, veins, and stems. They appear at section transitions, growing from the edges of content containers like ivy reclaiming a courthouse wall. The leaves are rendered with a hand-tremor effect: SVG paths include subtle noise in their control points, producing slightly uneven strokes that contrast with the precision of the geometric elements. The organic motifs serve as a visual metaphor for justice growing from institutional structure -- life emerging from chrome.

Specific leaf placements:
- At the junction between the Atrium and Gallery sections, a single branch motif extends from the left chrome bar, its leaves reaching toward the first content block
- In the Bench sections, leaf veins are embedded into the background as barely-visible patterns (opacity 0.04), forming a ghost image beneath the geometric compositions
- In the Archive footer, small leaf icons replace traditional bullet points and list markers

**Chrome Reflection Effects:**
Key decorative elements use CSS gradients that simulate chrome reflection -- a repeating pattern of light-dark-light bands that shift position on scroll, creating the illusion of a reflective metallic surface responding to the viewer's movement through the page.

## Prompts for Implementation

**Full-Screen Narrative Scroll Experience:**
The site must function as a single, continuous vertical narrative -- a ceremonial procession through a chrome-clad courthouse. The hero section fills the entire viewport with nothing but the grain overlay, the vertical chrome bar, and the domain name in Space Grotesk at 6rem, displaced from center. There is no navigation bar, no hamburger menu, no header chrome. The only way forward is to scroll, and the scroll itself is the ceremony. Each "chamber" section occupies at minimum 100vh, with content revealed progressively as the user scrolls.

**Counter-Animate Pattern:**
The primary animation pattern is **counter-animate** -- paired elements that move in opposite directions simultaneously. When a content block slides in from the left, its associated geometric decoration slides in from the right. When text fades up, its background chrome bar fades down. When a leaf motif grows upward, a geometric shape descends. This creates a visual dialogue of opposing forces -- prosecution and defense, order and chaos, institution and nature -- that is fundamental to the courthouse metaphor. Implementation: use CSS custom properties and `IntersectionObserver` to trigger paired animations. Element A gets `translateX(-100px)` to `translateX(0)` while Element B gets `translateX(100px)` to `translateX(0)`, both with `cubic-bezier(0.16, 1, 0.3, 1)` easing over 1.2s. The counter-motion should be visible in every section transition.

**Broken-Grid Scroll Choreography:**
As the user scrolls through the Gallery sections, content blocks should animate into their broken-grid positions from off-screen, each with a slightly different delay (stagger of 120ms between elements). The broken-grid positions themselves shift subtly on scroll -- a 2-3% horizontal drift tied to scroll progress -- so the layout feels alive, like tectonic plates in slow motion. Use `transform: translate3d()` for GPU-accelerated movement. The overlapping elements should have `z-index` values that create genuine layering: text over geometry, geometry over grain, grain over background.

**Grain-Responsive Interactions:**
On pointer hover over interactive elements, the grain overlay intensity increases from 0.07 to 0.14 within a 200px radius of the cursor, using a radial gradient mask. This creates the effect of a spotlight being trained on the surface, revealing more texture. Combined with a subtle scale transform (1.0 to 1.02) on the hovered element, this produces a tactile, almost physical interaction -- as if the user is pressing against the grainy surface and seeing it respond.

**Chrome Shimmer on Scroll:**
All chrome-colored elements (the vertical bar, horizontal rules, geometric shape fills) shift their gradient angle by 0.5 degrees per pixel of scroll progress. This creates a slow, continuous shimmer effect -- the appearance of chrome catching light as the viewer moves past it. The gradient uses three stops: `#2C2F36` at 0%, `#C0C8D2` at 50%, `#2C2F36` at 100%, and the `background-size` is set to 200% so the shift creates a traveling highlight band.

**Leaf Growth Animation:**
When leaf-organic motifs enter the viewport, they animate along their SVG paths using `stroke-dasharray` and `stroke-dashoffset`, drawing themselves into existence over 2.5 seconds with an `ease-out` curve. The growth direction is always upward or outward, reinforcing the metaphor of organic life emerging from institutional structure. After the path is fully drawn, the fill fades in at opacity 0.15 in Verdigris, giving the leaf a ghostly, translucent quality.

**AVOID:** CTA-heavy layouts, pricing blocks, stat-grids, testimonial carousels, feature comparison tables, cookie banners styled as primary UI, floating chat widgets. The experience should feel like entering a building, not shopping in a store.

**Typography Animation:** Section headings in Space Grotesk should animate character-by-character with a 30ms stagger, each letter translating up from 20px below its final position with `opacity: 0` to `opacity: 1`. This creates the effect of text being engraved into the chrome surface one letter at a time.

## Uniqueness Notes

**Differentiators from other designs:**

1. **Chrome-Metallic Palette with Organic Leaf Interruption:** No other design in the portfolio combines a chrome/gunmetal/silver metallic palette (0% frequency for chrome-metallic) with organic leaf motifs (3% frequency for leaf-organic). The collision of cold industrial metal and warm botanical forms creates a visual tension unique to this design -- the idea that nature insists on growing through the cracks of institutional architecture. This is not a nature site with metallic accents or a tech site with botanical decoration; the two systems are in genuine dialogue, with counter-animations reinforcing their opposition.

2. **Broken-Grid Layout with Courthouse Chamber Metaphor:** While broken-grid appears at only 3% frequency in existing designs, none of them use it to encode a spatial narrative of architectural rooms. The "chambers" concept -- Atrium, Gallery, Bench, Archive -- transforms the broken grid from a stylistic choice into a storytelling device. Each chamber has its own grid logic, density, and rhythm, creating a journey through distinct spaces rather than a continuous scroll through uniform content blocks.

3. **Counter-Animate as Primary Motion Language:** Counter-animation appears at only 3% frequency and is never used as the foundational animation philosophy of a design. Here, every transition involves paired elements moving in opposition -- a direct visual encoding of the adversarial legal system where prosecution faces defense, argument faces rebuttal, and order faces disruption. This is not decoration; it is the site's core conceptual metaphor expressed through motion.

4. **Grainy-Textured Film Grain as Identity Layer:** While grain overlays appear in some designs, none use grainy-textured (0% frequency) as the primary aesthetic classification. Here, the grain is not a subtle enhancement -- it is the fundamental texture of the entire experience, animating continuously, responding to hover states, and varying in intensity across sections. The grain transforms the chrome palette from cold and digital into something with the warmth and imperfection of analogue film, as if the courthouse were being documented rather than rendered.

5. **Sans-Grotesk Typography in an Opulent Context:** The combination of sans-grotesk typography (3% frequency) with opulent-grand tone (2% frequency) is deliberately paradoxical. Grotesk typefaces are typically associated with modernist restraint, not opulence. Here, Space Grotesk is used at massive display sizes with engraved-style uppercase tracking, transforming an industrial typeface into something monumental and ceremonial -- the typographic equivalent of a concrete courthouse that feels as imposing as a marble temple.

**Chosen seed/style:** aesthetic: grainy-textured, layout: broken-grid, typography: sans-grotesk, palette: chrome-metallic, patterns: counter-animate, imagery: geometric-abstract, motifs: leaf-organic, tone: opulent-grand

**Avoided overused patterns from frequency analysis:**
- Avoided `playful` aesthetic (97% frequency) -- replaced with grainy-textured (0%)
- Avoided `centered` layout (98% frequency) -- replaced with broken-grid (3%)
- Avoided `mono` typography (98% frequency) -- primary is sans-grotesk (3%), mono used only for labels
- Avoided `warm` palette (100% frequency) -- replaced with chrome-metallic (0%)
- Avoided `scroll-triggered` as primary pattern (97% frequency) -- primary is counter-animate (3%)
- Avoided `minimal` imagery (96% frequency) -- replaced with geometric-abstract (0%)
- Avoided `vintage` motifs (65% frequency) -- replaced with leaf-organic (3%)
- Avoided `friendly` tone (96% frequency) -- replaced with opulent-grand (2%)
<!-- DESIGN STAMP
  timestamp: 2026-03-09T10:24:33
  domain: courthouse.app
  seed: uppercase tracking, transforming an industrial typeface into something monumental and ceremonial -- the typographic equivalent of a concrete courthouse that feels as imposing as a marble temple
  aesthetic: courthouse.app inhabits the visual world of a brutalist courthouse lobby after h...
  content_hash: 6f053981761e
-->
