# Design Language for mujun.studio

## Aesthetics and Tone

mujun.studio channels the visual atmosphere of a 1928 Parisian cinema lobby redesigned by a typographer who programs in Rust -- a collision of Art Deco's gilded geometric opulence with the clinical precision of monospaced terminal output. The word "mujun" (矛盾, meaning contradiction/paradox in Japanese) becomes the design thesis itself: every surface oscillates between ornamental excess and austere code. Imagine veined Calacatta marble pilasters framing a blinking cursor. Imagine chevron frieze patterns rendered in `#800020` burgundy that dissolve, on scroll, into blurred depth-of-field photography of mixed-media collage -- torn rice paper layered over circuit diagrams layered over gold-leaf kintsugi repairs.

The tone is friendly but never casual. It speaks like a well-read host at a private gallery opening: warm, articulate, genuinely interested in you, but clearly operating at a level of aesthetic sophistication that commands quiet attention. There is no irony here, no winking self-awareness. The Art Deco elements are played straight -- not as pastiche but as living design language, because the geometric certainty of Deco (its sunbursts, its ziggurats, its fan motifs) provides the structural backbone against which the blur-focus transitions and mixed-media collage fragments create moments of productive disorientation. You feel welcomed and slightly destabilized at once -- the paradox of mujun made spatial.

The overall mood draws from the lobbies of the Chrysler Building, the typography of A.M. Cassandre's posters, the marble halls of the Palais de Tokyo, and the dark-terminal aesthetics of a late-night coding session where the only light comes from phosphor-green text on black -- except here the phosphor is replaced by warm burgundy and cream.

## Layout Motifs and Structure

The layout follows an **editorial-flow** architecture -- a vertically scrolling narrative that unfolds like a magazine feature in a luxury design publication, but one that has been deliberately disrupted by a programmer's sense of order. Content moves in a single primary column that is wide (70-75% of the viewport on desktop) but punctuated by moments where elements break free of the column and bleed to the viewport edges, creating a rhythm of containment and release.

**The Deco Frame System:**
The viewport is bordered by a persistent thin-line Art Deco frame -- a 1px line in #C8A96E (antiqued gold) that sits 24px inset from all viewport edges. This frame is purely decorative but omnipresent; it establishes the sense of looking into a curated space, like peering through the gilded frame of a painting. At the four corners, the frame resolves into small geometric fan motifs (quarter-circles with radiating lines) that rotate subtly (0.5deg per second) on a continuous CSS animation.

**Editorial Column with Deco Anchors:**
The main content column is left-aligned at roughly 15% from the left edge, creating an asymmetric composition with generous right-hand negative space. Every major section transition is marked by a full-width horizontal rule that is not a simple line but a Deco-inspired geometric divider: a thin line flanked by small diamond shapes and terminated by chevron arrows, rendered in SVG at #800020 burgundy. These dividers function as visual chapter markers.

**Depth Layering:**
Behind the primary content column, at z-index -1, there exist large-scale typographic watermarks -- single kanji characters (矛 and 盾, meaning spear and shield, the components of mujun) rendered in "Space Mono" at 40vw size, in #F5F0E8 (barely visible against the #FAF6F0 background). These watermarks shift position with parallax at 0.15x scroll speed, creating a ghostly textual landscape beneath the content. The blur-focus pattern is applied here: as sections scroll into view, the background watermark transitions from a 12px Gaussian blur to sharp focus over 800ms, then blurs again as the section passes. This creates a breathing, pulsing depth effect.

**The Terminal Interruptions:**
At unpredictable intervals (roughly every third section), the editorial flow is "interrupted" by a terminal-style block: a full-width dark rectangle (#1A0A10, near-black with a burgundy undertone) containing monospaced text in #E8D5C0 (warm cream). These blocks display content formatted as code comments, command-line output, or structured data. They function as editorial asides -- the programmer's voice breaking through the Deco architect's composition. Each terminal block has a subtle scanline effect (horizontal lines at 2px intervals, 3% opacity) and a single blinking cursor character at the end of the last line.

## Typography and Palette

**Typography:**

- **Display / Headlines:** "Poiret One" (Google Fonts) -- a pure Art Deco geometric display typeface with perfectly circular O's, uniform stroke width, and that unmistakable 1920s Parisian elegance. Used at 3.5rem-7rem for primary headings. All headings are set in uppercase with letter-spacing of 0.15em, which amplifies the Deco character. The font's geometric purity means that every heading feels like it could be etched into the marble facade of a 1929 department store. Weight 400 only (the font's single weight), which keeps everything refined rather than heavy.

- **Body / Narrative Text:** "Libre Baskerville" (Google Fonts) -- a web-optimized Baskerville revival with generous x-height and open letterforms. Used at 1.05rem/1.75 line-height for all body copy. Baskerville's transitional serif character (between old-style warmth and modern rationality) mirrors the mujun paradox theme. Color: #3D1A1A (deep wine-brown) for maximum readability against cream backgrounds. Italic variant used for emphasis and pull-quotes, never bold -- bold would be too aggressive for this design's controlled warmth.

- **Monospace / Code / Terminal:** "Space Mono" (Google Fonts) -- a fixed-width grotesque with a slightly quirky, editorial character that prevents it from feeling purely technical. Used at 0.9rem/1.6 in the terminal interruption blocks, and at 0.8rem for inline code references. In the terminal blocks, Space Mono is colored #E8D5C0 (warm cream) against #1A0A10 (burgundy-black). Outside terminal blocks, inline code uses Space Mono at #800020 (burgundy) with a 1px bottom border in #C8A96E (gold).

- **Accent / Navigation:** "Josefin Sans" (Google Fonts) -- a vintage-geometric sans-serif inspired by Scandinavian design from the 1920s-30s, with a tall x-height and slightly Art Deco flavor. Used at 0.85rem for navigation items, metadata labels, dates, and captions. Weight 300 (light) with letter-spacing 0.2em, always uppercase. Color: #8B6B5B (muted terracotta).

**Color Palette:**

| Role | Hex | Name | Usage |
|------|-----|------|-------|
| Primary Background | #FAF6F0 | Aged Ivory | Main page background, the visual equivalent of heavy cotton paper |
| Secondary Background | #F0E6D8 | Warm Parchment | Card backgrounds, section alternates, subtle depth |
| Primary Accent | #800020 | Burgundy Sang | Headlines, key UI elements, the dominant chromatic voice |
| Gold Accent | #C8A96E | Antiqued Gold | Deco frame, dividers, decorative flourishes, hover states |
| Dark Accent | #1A0A10 | Burgundy Noir | Terminal blocks, deep contrast areas, footer |
| Text Primary | #3D1A1A | Wine Earth | Body text, the workhorse reading color |
| Text Secondary | #8B6B5B | Muted Terracotta | Captions, metadata, navigation labels |
| Terminal Text | #E8D5C0 | Pale Bisque | Text within terminal/dark blocks |
| Marble Vein | #D4C4B0 | Travertine Vein | Decorative vein lines in marble-effect backgrounds |
| Highlight | #A0153E | Deep Carmine | Hover states on links, active states, emphasis |

The palette is strictly **burgundy-cream** -- no blues, no greens, no cool tones. Every color sits within the red-to-gold-to-cream spectrum, creating a monochromatic warmth that feels like the interior of a velvet-lined case.

## Imagery and Motifs

**Mixed-Media Collage Panels:**
The primary imagery strategy is **mixed-media** -- layered compositions that combine multiple visual textures into single coherent panels. Each panel (used as section headers or full-width interludes) is constructed from:

1. **Marble Texture Base:** A high-resolution Calacatta marble pattern (white with grey and gold veining) serves as the foundational layer. This is generated via CSS using layered radial-gradient and linear-gradient functions that approximate natural stone veining, avoiding the need for image files. The marble is rendered at 60% opacity so it whispers rather than shouts.

2. **Geometric Deco Overlays:** On top of the marble, SVG patterns of Art Deco geometric motifs are composited at 30% opacity in #C8A96E (gold): fan shapes (the Egyptian lotus/papyrus fan that Deco borrowed from ancient art), zigzag chevrons, concentric arches (the sunrise/sunburst motif), and stepped pyramid forms. These are rendered as repeating SVG patterns using `<pattern>` elements with precise geometric construction.

3. **Torn-Edge Collage Fragments:** Layered above the marble and geometry, CSS clip-path polygons with irregular, jagged edges simulate torn paper fragments. These fragments contain either solid color fills (#800020 at varying opacities) or additional texture patterns (a fine linen weave simulated with repeating-linear-gradient at 1px intervals). The torn edges create the collage's handmade quality.

4. **Typographic Debris:** Large-scale letterforms and kanji characters are scattered across the collage at extreme angles (30deg, -15deg, 72deg), partially clipped by the torn-paper fragments, in various opacities (10-40%). These use Poiret One for Latin characters and system serif fallback for kanji, creating a polyglot textual landscape.

**Marble-Classical Motifs:**
Beyond the collage panels, marble appears throughout as a recurring material reference:
- Section backgrounds alternate between plain Aged Ivory (#FAF6F0) and a subtle marble-veined variant where thin lines of #D4C4B0 (Travertine Vein) trace organic paths across the background, generated by SVG `<path>` elements with gentle cubic Bezier curves.
- Pull-quote blocks are styled as marble tablets: a slightly rounded rectangle with an inset box-shadow that simulates carved relief, background filled with the marble gradient, text in Poiret One uppercase.
- The footer area features a "cracked marble" effect where thin dark lines (#3D1A1A at 15% opacity) form an irregular Voronoi-like pattern, suggesting aged stone.

**Blur-Focus Photographic Moments:**
Scattered through the editorial flow are photographic-style imagery zones -- CSS-only compositions using gradient backgrounds and blur filters that simulate tilt-shift photography of architectural details. These zones use a 3-layer approach:
- Base: a warm gradient (#F0E6D8 to #FAF6F0)
- Middle: a geometric shape (circle, arch, or chevron) in #800020 with a 20px Gaussian blur, simulating an out-of-focus object
- Foreground: a sharp-edged geometric element (thin line, small diamond) in #C8A96E, simulating the in-focus plane

The blur-to-focus transition is the signature interaction: as the user scrolls these zones into the viewport center, the blurred middle layer transitions to 0px blur over 600ms (CSS transition triggered by Intersection Observer), momentarily revealing the composition in full clarity before re-blurring as it scrolls away. This creates a camera-rack-focus effect that rewards attentive scrolling.

**Deco Icon System:**
Navigation and UI elements use a custom set of Art Deco-inspired icons built from pure SVG geometry:
- Arrows are chevron-style (>>>) rather than standard pointing triangles
- Menu icon is three horizontal lines with diamond endpoints
- Close/X icon is two intersecting lines with small fan motifs at the endpoints
- Loading state is a rotating sunburst (12 radiating lines from a center point)

## Prompts for Implementation

**Full-Screen Narrative Scroll Experience:**
The site opens to a full-viewport composition that immediately establishes the Deco-meets-terminal paradox. The viewport is filled with the Aged Ivory (#FAF6F0) background. The persistent Deco frame (1px #C8A96E, 24px inset) is visible from the first pixel. Centered in the upper third of the viewport, "MUJUN.STUDIO" is rendered in Poiret One at 6rem, uppercase, letter-spacing 0.2em, color #800020 (Burgundy Sang). Below the name, a single horizontal Deco divider (the diamond-chevron-line motif) spans 40% of the viewport width.

Below the divider, a terminal block fades in after a 1.2s delay: a dark rectangle (#1A0A10) containing three lines of Space Mono text in #E8D5C0:
```
$ mujun --describe
> contradiction as creative method
> where art deco meets the command line_
```
The final underscore blinks at 1Hz. The entire terminal block has a blur-focus entrance: it starts at 8px Gaussian blur and resolves to sharp over 800ms, synchronized with the fade-in.

Below the terminal block, a small Josefin Sans label reads "SCROLL TO EXPLORE" in #8B6B5B, uppercase, letter-spacing 0.3em, accompanied by a subtle downward chevron (>>>) that pulses with a 2s ease-in-out opacity animation (0.3 to 1.0).

**Section Transition Choreography:**
Each major section uses the blur-focus pattern as its entrance animation. As a section's top edge crosses the 75% viewport threshold (detected by Intersection Observer with threshold 0.25), the following sequence fires:
1. The section's Deco divider draws itself in from center outward (SVG path animation, 400ms)
2. The section heading blurs from 6px to 0px (300ms, eased)
3. Body text staggers in paragraph by paragraph with 150ms delays, each paragraph translating from 20px below to its final position with opacity 0 to 1

Between sections, the background watermark kanji characters shift with a slow CSS transform (translateY at 0.15x scroll speed), and their blur level inverts relative to the active section's blur-focus state.

**The Terminal Interruption Pattern:**
Terminal blocks are not merely styled differently -- they enter the flow with a distinct animation: a horizontal "scan line" (a 2px tall bright line in #C8A96E) sweeps top-to-bottom across the terminal block's area over 300ms, and the terminal content is revealed behind the scan line as if being printed line-by-line. Each line of monospace text appears with a 100ms stagger and a subtle typewriter-effect (characters appearing left-to-right, though this can be simplified to a clip-path reveal for performance).

**Marble Pull-Quote Treatment:**
Pull-quotes are major visual events. They occupy the full column width, styled as marble tablets: background is the marble CSS gradient, padding is 3rem, the text is Poiret One at 2rem in #800020, centered, with an Art Deco border -- not a simple solid border but a double-line border (2px gap between two 1px lines) with small diamond ornaments at the four corners, rendered via CSS border-image or pseudo-elements. Above and below the quote, small fan motifs in #C8A96E mark the boundaries.

**Footer as Marble Floor:**
The footer section transitions the background from Aged Ivory to the cracked-marble pattern -- the Voronoi-style thin dark lines covering a #F0E6D8 base. The footer content (minimal: domain name, a single line of description, perhaps links) is set in Josefin Sans Light uppercase, widely spaced, as if the letters were inlaid into the marble floor like a Roman inscription. A final Deco sunburst motif, rendered in #C8A96E at 20% opacity and 30vw size, sits centered behind the footer text.

**Responsive Approach:**
On mobile (below 768px), the Deco frame inset reduces to 12px. The editorial column expands to 90% width. Watermark kanji scale to 60vw and their blur-focus animation is disabled (static blur at 8px) for performance. Terminal blocks become full-width with no horizontal margin. The Poiret One display size drops to 2.5rem-4rem. The blur-focus scroll interactions remain active but with reduced blur values (8px max instead of 12px) for smoother mobile rendering.

**Performance Notes:**
All imagery is CSS-only (gradients, SVG patterns, filters). No raster images are loaded. Blur transitions use `will-change: filter` for GPU compositing. Intersection Observer callbacks are throttled. SVG decorative patterns are defined once in a `<defs>` block and reused via `<use>` elements.

**AVOID:** CTA-heavy layouts, pricing blocks, stat-grids, cookie banners, hero carousels, testimonial sliders, feature comparison tables. This is a narrative experience, not a conversion funnel.

## Uniqueness Notes

**Differentiators from other designs in the portfolio:**

1. **Art Deco as Living Architecture (2% frequency):** Art Deco aesthetic appears in only 2% of existing designs. While most designs gravitate toward playful (95%), editorial (25%), or corporate (29%) aesthetics, mujun.studio commits fully to the geometric opulence of 1920s-30s decorative modernism -- not as retro pastiche but as a structural design language. The Deco frame system, the fan-motif corner ornaments, the chevron-diamond dividers, and the sunburst loading states create a coherent Art Deco environment that no other site in the portfolio attempts at this level of integration.

2. **Terminal-Deco Paradox (unique combination):** The collision of Art Deco luxury with monospaced terminal aesthetics is entirely original in this portfolio. While terminal/corporate aesthetics exist independently (26% and 29%), and tech-mono typography appears at 5%, no other design stages a deliberate confrontation between ornamental Deco excess and the spartan geometry of command-line interfaces. The "terminal interruption" pattern -- dark code blocks erupting within the gilded editorial flow -- creates a visual paradox that directly embodies the domain's name (mujun = contradiction).

3. **Blur-Focus as Scroll Narrative Device (2% frequency):** The blur-focus interaction pattern appears in only 2% of designs. Here it is elevated from a simple hover effect to the site's primary narrative mechanism: entire sections breathe between clarity and obscurity as the user scrolls, background watermarks pulse in and out of legibility, and mixed-media collage elements resolve and dissolve with tilt-shift camera precision. This creates an experience where the act of scrolling feels like adjusting the focus ring on a camera -- the user becomes an active participant in revealing the content rather than a passive consumer.

4. **CSS-Only Marble Material System (marble-classical at 5%):** While marble textures appear occasionally (2% in imagery), mujun.studio builds an entire material language around marble -- from the veined section backgrounds to the pull-quote tablets to the Voronoi-cracked footer floor -- all rendered without raster images using CSS gradients and SVG paths. This creates a physically tactile quality (you can almost feel the cool stone) that is rare in web design and particularly unexpected in combination with terminal/code aesthetics.

5. **Mixed-Media Collage Without Photography (13% frequency for mixed-media, but unique execution):** The mixed-media panels are built entirely from CSS and SVG -- marble gradients, geometric Deco patterns, torn-edge clip-paths, typographic debris -- with zero photographic imagery. This is a collage made from pure design artifacts, which is substantially different from the collage/mixed-media approaches in other designs that typically layer photographs. The result feels more like a Joseph Cornell box than a magazine spread.

**Documented Seed/Style:**
```
aesthetic: art-deco
layout: editorial-flow
typography: tech-mono
palette: burgundy-cream
patterns: blur-focus
imagery: mixed-media
motifs: marble-classical
tone: friendly
```

**Avoided Overused Patterns:**
- Centered layout (99%) -- used asymmetric left-aligned editorial column instead
- Playful aesthetic (95%) -- used Art Deco with serious, sophisticated character
- Parallax (76%) -- used blur-focus as the primary scroll interaction instead
- Stagger animation (61%) -- used blur-focus transitions and scan-line reveals as primary animation vocabulary
- Photography imagery (72%) -- used CSS-only mixed-media collage with zero raster images
- Vintage motifs (84%) -- used marble-classical motifs, which are classical rather than generically vintage
- Spring/elastic animation (34%/13%) -- used linear/eased blur transitions for a more cinematic feel
<!-- DESIGN STAMP
  timestamp: 2026-03-10T16:13:53
  domain: mujun.studio
  seed: unspecified
  aesthetic: mujun.studio channels the visual atmosphere of a 1928 Parisian cinema lobby rede...
  content_hash: d0229b286ba0
-->
