# Design Language for lunchbox.dev

## Aesthetics and Tone

lunchbox.dev is a developer's *carry-everything tin* — the dented metal lunchbox a coder slings over their shoulder, packed not with sandwiches but with snippets, half-built side-quests, dotfiles, keyboard layouts, and the small sharp tools that make a workday survivable. The site is built like a **street-pasted zine taped to the inside of a steel locker**: photocopied flyers, sticker-bombed surfaces, packing-tape glare, marker scrawl, and the cold fluorescent hum of a server-room-meets-skatepark. This is *street-style* in the truest sense — DIY, layered, slightly illegal-looking, made by hand and shipped fast — fused with a **futuristic, near-future-industrial** chill: think a courier in a puffer jacket reading machine code off a cracked visor.

The tone is **raw-authentic**: nothing is airbrushed, every edge is a real edge. Captions are typed in monospace like terminal output. Headlines look spray-stenciled through a cut cardboard mask. The mood underneath is **mysterious-moody** — an after-hours, blue-shift atmosphere, the glow of a single monitor in a dark room, condensation on a cold can — but it is *worn*, not precious. The lunchbox has been opened a thousand times. The hinges squeak. The latch sticks. You love it anyway.

There is dry humor in the framing: the "menu" is a directory listing, the "nutrition facts" are dependency counts, the "ingredients" are a `package.json`. But the humor is deadpan, scrawled in the margins, never cute. It earns its place by being *true to how developers actually talk to themselves at 1 a.m.*

## Layout Motifs and Structure

**Primary layout: broken-grid collage** — a deliberately fractured modular grid where panels overlap, tilt 1–4 degrees off-axis, bleed past their gutters, and pin on top of each other like flyers slapped over older flyers. There is an underlying 12-column skeleton, but blocks routinely *break* it: a snippet card straddles columns 3–9 while a sticker overlaps columns 7–11; a photo-collage tile rotated -3deg sits half-off the left bleed; a strip of "packing tape" (a translucent skewed rectangle with grain) holds a corner down across the seam.

Structure as a single immersive vertical scroll, but built as a sequence of **"compartments"** — like the molded trays inside a real lunchbox:

1. **The Latch (hero):** Full-bleed dark blue. A large brushed-steel lunchbox illustrated/composited in the center, lid slightly ajar, ethereal-blue light leaking from the gap. The wordmark `lunchbox.dev` is stenciled across the lid in tech-mono caps. On scroll, the lid hinges open and the rest of the page is "what's inside."

2. **Today's Menu (directory listing):** A monospace `ls -la ~/lunchbox` style block where each entry is a real link to a side-project / tool. Entries are typed out line by line (typewriter-effect), each row a slightly different baseline like a worn label-maker.

3. **The Tray (broken-grid showcase):** The chaotic heart — overlapping cards for snippets, dotfiles, keymaps, scripts. Each card is a "thing you'd pull out of the box": a folded note, a USB stick photo, a sticker sheet, a thermos. Cards tilt, overlap, and on hover *lift and straighten* (hover-lift) as if you picked one up.

4. **Ingredients (the package.json panel):** A faux terminal pane, dark, with a syntax-highlighted dependency list scrolling. Annotated in the margins with handwritten-looking monospace asides ("// still don't know what this does", "// load-bearing, do not touch").

5. **Field Notes (collage strip):** A horizontal-feeling band of photocopied imagery — keyboards, transit cards, ramen cups, oscilloscope traces, city overpasses at night — duotoned into the blue palette, taped together with grain overlays.

6. **Pack Your Own (closing):** The lid hinges shut. The latch *clicks* (a tiny micro-interaction). Footer is a strip of "warning label" text — care instructions in mono, a fake barcode, a "best before: never" stamp.

No nav bar. Navigation is a thin **carry-handle** fixed at the very top — a rounded blue bar that, on hover, reveals compartment names as if reading a riveted label. A faint vertical "seam line" runs down the right edge as a scroll progress indicator, like the join in stamped sheet metal.

Generous *but uneven* whitespace: some compartments are crammed, others nearly empty (one big sticker floating in blue void). The rhythm is packed / breathe / packed / breathe.

## Typography and Palette

**Display / Stencil headlines:** `"Anton"` (Google Fonts) — ultra-condensed, heavy, set in ALL CAPS at clamp(2.8rem, 8vw, 7rem), letter-spacing 0.04em. Treated as if spray-stenciled: a subtle hard-edged "overspray" via layered text-shadows in `#3D7BFF` at low opacity, and an optional `mix-blend-mode: screen` paint-mask texture overlay. This is the loud voice on the locker door.

**Secondary display / labels:** `"Archivo Black"` (Google Fonts) — for sticker text, callout chips, "warning label" stamps. Heavy grotesque, set tight, sometimes outlined (transparent fill, 2px stroke via `-webkit-text-stroke`) to read like a die-cut sticker.

**Body / UI / everything monospace:** `"Space Mono"` (Google Fonts) — the workhorse. Used for all body copy, captions, the directory listing, margin notes, footer care-instructions. Weight 400 and 700. line-height 1.65. This is the *tech-mono* core: it makes the whole site read like terminal output and label-maker tape. Some asides set in italic Space Mono to feel like a fast scrawl.

**Code / terminal panels:** `"JetBrains Mono"` (Google Fonts) — reserved strictly for the `package.json` panel and any literal code blocks, so "real code" feels visually distinct from "site chrome that happens to be mono." Weight 400/500, ligatures on.

### Palette — *ethereal-blue*, cold and luminous, on near-black steel

- `#070A12` — **Locker Black**: the dominant background. Almost-black with a blue undertone, like the inside of a closed metal box.
- `#0D1424` — **Steel Shadow**: secondary panel background, recessed compartments, the terminal pane.
- `#1B2A47` — **Riveted Navy**: card backgrounds, taped strips, mid-depth surfaces.
- `#3D7BFF` — **Service Blue**: the primary accent — links, stencil overspray, glowing lid-gap light, active states. Electric but not neon; a worker's hi-vis in blue.
- `#7FB0FF` — **Vapor Blue**: secondary accent, hover glows, hairlines, the "ethereal" mist leaking from the lunchbox.
- `#BFD4FF` — **Frost**: near-white-blue used for primary body text on dark, and for the cold fluorescent highlight on the steel.
- `#E8EEFA` — **Photocopy White**: paper-tone for the rare light "flyer" cards in the collage; never pure `#fff` — always faintly blue-grey, like a fifth-generation Xerox.
- `#F2542D` — **Hazard Orange** (used *sparingly* — < 3% of surface): a single warning-tape accent, one sticker, the latch indicator. The lone warm thing in the box, like a safety pull-tab. It exists to make one thing scream once.

Texture: a persistent fine **grain/noise overlay** (SVG `feTurbulence`, ~3–4% opacity) across the whole page so even flat blue feels like brushed metal or photocopier toner. "Packing tape" elements are skewed translucent rects with a faint diagonal sheen gradient.

## Imagery and Motifs

- **The lunchbox itself**: a dented, riveted steel lunchbox is the recurring hero object — lid open, lid closed, lid mid-hinge. Rendered as a high-contrast composite/illustration with cold rim-lighting in Vapor Blue and a Service Blue glow leaking from inside. Reused at small scale as a favicon-like motif and as section dividers (a tiny closed box, then an open one).
- **Collage fragments (imagery: collage)**: photocopied, halftoned, duotone-blue scraps — mechanical keyboards exploded into keycaps, transit/metro cards, instant-ramen lids, oscilloscope and waveform traces, fisheye shots of city overpasses and server-room ceilings, hands holding a cold can, a cracked phone screen showing a stack trace. Layered, torn-edged, taped down. Everything monochromed into the blue range except the occasional Hazard Orange sticker.
- **Street-style surface treatments**: sticker-bomb clusters in corners (rounded-rect die-cut shapes with Archivo Black text), spray-stencil overspray on headlines, marker underlines and circles (hand-jittered SVG strokes in Service Blue), "packing tape" strips holding panels down, photocopy registration marks and crop ticks at panel corners, a faint dot-screen halftone behind some blocks.
- **Futuristic-industrial motifs**: rivet dots running along panel edges, riveted seam lines, a thin scanning hairline that occasionally sweeps a compartment (like a barcode reader), HUD-ish corner brackets `⌐ ¬ ⌙ ⌐` framing key cards, a stamped serial number / build hash typeset in JetBrains Mono in the corner of the page (`build:0xLB-…`).
- **Terminal / label motifs**: blinking block cursor `▮` at the end of typed lines, `$` and `>` prompts, a fake barcode in the footer, a "NUTRITION FACTS"-style box re-skinned as "BUILD FACTS" (deps, scripts, last-modified) — playful but not a stats-grid; it's one small ironic label, not a dashboard.
- **The lid-gap light**: the single most-used atmospheric element — a soft Service-Blue gradient bloom that "leaks" from seams, edges, and the lunchbox gap, suggesting something alive and humming inside.

No stock photography, no glossy 3D product renders, no icon sets. Everything looks made on a photocopier and a desk.

## Prompts for Implementation

Build this as a **single full-screen scroll narrative**: opening a lunchbox and going through what's inside, compartment by compartment. The story beat is *"here is the small kit of weird useful things I carry — take what you want, pack your own."* Lead with atmosphere and object, not with a pitch.

- **Opening sequence (no skip):** Page loads on Locker Black. A few `feTurbulence` grain frames settle in. The steel lunchbox composites in from a blur-focus (slightly out of focus → sharp, 600ms). The `lunchbox.dev` stencil headline draws on with a hard "overspray" reveal — text masked by a moving gradient so it looks spray-painted left-to-right through a stencil (~900ms). A thin Vapor-Blue scanline sweeps once, top to bottom. Then a `▮` cursor blinks under a typed sub-line in Space Mono: `> what's in the box?` After a beat, on first scroll, the lid hinges open (CSS 3D `rotateX` on a transform-origin at the hinge) and Service-Blue light blooms out, revealing compartment 2.

- **Animation priorities (lean on the underused / mandated patterns):**
  1. **counter-animate** — the "BUILD FACTS" label's numbers (dependency count, scripts, days-since-commit) tick up from 0 when scrolled into view. Also the build-hash in the corner briefly scrambles through random hex before settling.
  2. **typewriter-effect** — the "Today's Menu" directory listing types itself out line by line, each line ending with a momentary block cursor before the next line starts. Margin notes in the `package.json` panel also type in when reached.
  3. **path-draw-svg** — marker underlines, hand-drawn circles around key words, the riveted seam line down the right edge, and the HUD corner brackets all draw on via `stroke-dasharray`/`stroke-dashoffset` on scroll-trigger.
  4. **hover-lift** — collage/snippet cards in "The Tray" tilt slightly by default (1–4deg) and on hover lift toward the viewer (`translateZ` + scale 1.03) *and rotate to 0deg* — "you picked it up to look at it" — with a soft Vapor-Blue drop shadow. On leave they settle back with a tiny spring overshoot.
  5. **micro-interactions** — the latch "clicks" (a 2-frame transform + a faint metallic SFX optional and muted by default) when the closing compartment enters; stickers wobble 1deg on hover; the carry-handle nav "tightens" (scale 0.98) on hover and labels slide out from under the rivet.

- **Scroll behavior:** use `scroll-snap-type: y proximity` so each compartment can be paused on, but keep it gentle — this is browsing a box, not a slideshow. Parallax: the grain overlay stays fixed; collage fragments in "Field Notes" drift at slightly different rates; the lid-gap glow subtly breathes (slow opacity oscillation) independent of scroll.

- **Broken-grid execution:** CSS Grid with named lines; place blocks so they *intentionally* overlap (`grid-column` ranges that share columns, plus `transform: rotate()` and negative margins). Let one or two blocks bleed past `100vw` on the side (clip with `overflow-x: hidden` on the wrapper). Keep a single block per compartment perfectly axis-aligned so the tilt of the others reads as deliberate, not broken.

- **Texture/material:** every dark surface gets the `feTurbulence` grain at 3–4% opacity via a fixed full-screen `<svg>` filter or a tiled PNG fallback. "Packing tape" = `<div>` skewed ~-8deg, `background: linear-gradient(105deg, rgba(191,212,255,.10), rgba(191,212,255,.02))`, with a slight box-shadow for lift and the same grain on top. Photocopy cards (`#E8EEFA`) get a faint blue duotone `mix-blend-mode` halftone and a 1–2px ragged border via a tiny SVG mask.

- **AVOID:** no CTA-stacked hero, no pricing tiers, no three-column "features" grid, no stat dashboards (the one "BUILD FACTS" label is the *only* numeric block and it's an ironic nutrition-label gag, not a metrics grid), no testimonials, no logo-cloud, no generic centered marketing layout. The page should feel like a found object, not a landing page.

- **Restraint:** the palette is 90% cold blue and near-black. Hazard Orange appears exactly *once or twice* — the latch indicator and maybe a single corner sticker. If it's everywhere, it's wrong. Let the blue do the work and let the one warm spark mean something.

## Uniqueness Notes

1. **The lunchbox-tray metaphor as literal layout system.** Sections aren't "sections" — they're molded compartments, and the broken-grid overlap is justified diegetically as "stuff packed loosely in a tin." No other design in the portfolio uses a physical container's internal geometry to motivate its grid-breaking; here the chaos has an in-world reason.

2. **Street-style + futuristic-industrial fusion on an all-cold-blue palette.** Most "street-style"/zine designs go warm, grungy-brown, or punk-neon-pink; pairing photocopier-collage DIY texture with a *server-room ethereal-blue* palette and rivet/seam/scanline futurism is a deliberately unusual cross. The result is "courier punk" rather than "skate zine."

3. **"Nutrition facts as build facts" — a single ironic numeric label instead of a stats grid.** The brief warns against stat-grids; this design weaponizes that constraint into a one-off joke (deps = "ingredients", scripts, days-since-commit) styled like an FDA panel. It's the *only* counter-animate moment, which makes it land.

4. **Diegetic chrome:** the nav is a carry-handle, the scroll progress is a stamped metal seam, the hero interaction is hinging a lid open, the footer is a stamped "warning label" with a fake barcode. UI furniture is dissolved into the object's physical anatomy.

5. **Mono-everything as a *worn label-maker*, not as "techy aesthetic."** Space Mono carries 100% of body/caption/nav text, but it's framed as photocopied tape and terminal output, with JetBrains Mono cordoned off strictly for "real code" — a clear two-tier monospace system rather than one generic dev-mono look.

**Chosen seed (from assignment):** aesthetic: street-style · layout: broken-grid · typography: tech-mono · palette: ethereal-blue · patterns: counter-animate · imagery: collage · motifs: futuristic · tone: raw-authentic

**Frequency-analysis awareness:** `street-style` (1%), `ethereal-blue` (2%), `tech-mono` (5%), and `collage` (5%) are all strongly underused — this design leans into all four. `broken-grid` (15%) and `futuristic` (8%) are mid-frequency and used here in a non-generic, physically-motivated way. `counter-animate` (91%, near-ubiquitous and mandated) is deliberately *minimized* to a single ironic "BUILD FACTS" label rather than sprinkled everywhere. The design steers hard away from the overused `corporate` aesthetic (93%), `centered` layout (93%), `mysterious-moody` *as default mode* (94%) — it keeps a moody blue undertone but makes it *worn and DIY*, not slick — and avoids `photography` (66%) and `minimal` imagery (69%) entirely in favor of hand-made collage.
<!-- DESIGN STAMP
  timestamp: 2026-05-10T13:03:29
  domain: lunchbox.dev
  seed: seed
  aesthetic: lunchbox.dev is a developer's *carry-everything tin* — the dented metal lunchbox...
  content_hash: 22ae85848555
-->
