DUSK / WORLD SURVEY
Branding package v1.0.0 - October 28, 2026

START HERE
Open brand-guide.html in a browser for the offline style guide and asset gallery.
Open brand-guide.pdf for the eight-page handoff. The package is self-contained.

LOGOS
logos/svg/       Outlined SVG masters. No font installation required.
logos/pdf/       Separate vector PDFs for print and document placement (sRGB).
logos/png/       Transparent PNG exports. Filename gives pixel width.
logos/micro/     Optical small-size symbol; filename gives pixel height.
logos/lockups/   World Atelier, Observatory, Physics Lab and endorsement files.

Primary: dusk-horizontal-ink.svg on chalk.
Reverse: chalk or mint artwork on ink.
Alternate: stacked, wordmark-only, symbol, signature, black and white masters.
Secondary: signal-colored center node; outline study for large illustration use.

Reserve half the symbol height around the complete logo. Assets are tightly
cropped; add this clearspace in the layout. Keep the horizontal logo at least
160px wide, signature/product versions at least 240px, stacked/wordmark at least
96px, endorsement at least 140px. Standard mark >=32px high; micro mark >=16px.
Keep the outline study >=96px high. App icons have their own fixed composition.
Do not stretch, rotate, add effects or type a replacement wordmark.

COLORS AND TYPE
Ink       #17262B    Primary text / dark foundation
Mint      #BFE6D1    Primary action / diagram fill
Signal    #D95B2B    Indicators and illustration highlights
Chalk     #F4F1E8    Primary canvas / reversed artwork
Field     #68837C    Diagram shading / decorative rules

Use ink on chalk or mint for small text. Use #47615B for muted text on chalk;
#B2C8BD on ink. Functional status colors are in the light/dark tokens, with
labeled feedback. HEX values are sRGB masters. CSV CMYK values are unprofiled
approximations; convert using the intended printer profile for production.

IBM Plex Sans Condensed 600: headings. 700: fixed outlined wordmark source.
IBM Plex Sans 400/500/600 and 400 italic: reading, labels and emphasis.
IBM Plex Mono 400/500: code, coordinates and metadata.
Eight fonts are supplied in TTF and WOFF2. Keep their original OFL licenses.

STYLE SHEET
Load styles/brand.css, which imports fonts.css and tokens.css.
Add class="dusk-brand" to the styled root.
Set data-dusk-theme="dark" for a dark surface, or "light" for a light surface.
Keep the relative styles/ and fonts/ directories together, or update font URLs.
styles/guide.css is only for this package's asset gallery.
Reusable component classes include dusk-btn, dusk-panel, dusk-field,
dusk-input, dusk-help, dusk-status, dusk-meta, dusk-eyebrow and dusk-container.

GRAPHICS AND APPLICATIONS
illustrations/   Two standalone concept artworks; no baked-in logo or copy.
patterns/        Registration grid, contour lines and isometric grid (SVG).
icons/ui/        12 SVG icons and a sprite; 24-unit grid / 1.5-unit strokes.
icons/app/       SVG/ICO favicons, PNG app icons, touch icon and web manifest.
templates/       Self-contained social, repository, release, avatar and A4 assets.
colors/          Vector palette, CSV and GIMP palette.
tokens/          Structured brand and light/dark JSON tokens.
references/      Approved option 03 board retained as the visual reference.

The wide illustration uses an opaque paper background. The RGBA vignette has
soft-edge transparency and is intended for chalk surfaces. These are generated
brand illustrations, not Dusk engine captures. Use actual in-engine captures
when demonstrating rendered product output. The logo and copy remain separate.

Dusk is the engine. World Atelier, Observatory and Physics Lab are its tools.
Darkwind keeps its own game identity. Use a smaller Built with Dusk badge in
credits or a footer; it supports the game's own logo and artwork.

SOURCES AND REBUILDING
source/build_assets.py builds local SVG/PNG assets, fonts already supplied.
source/build_guide.py builds the guide, print logo PDFs and preview sheets.
source/validate_package.py checks assets and assembles manifest/checksums/ZIP.
source/prepare_fonts.py optionally refreshes official Google Fonts sources;
this is the only network-dependent step.
source/illustration-prompts.json records the built-in image-generation prompts.
source/logo-master.svg is the outlined logo source.
source/wordmark-live-type.svg is an editable lettering reference requiring the
included bold font; the production artwork uses the exact outlines instead.
brand.json records color masters, geometry, variants and minimum sizes.

Install Python packages from source/requirements.txt and the librsvg package
providing rsvg-convert. Then run, in order:
  python source/build_assets.py
  python source/build_guide.py
  python source/validate_package.py

All paths resolve relative to this directory, regardless of working directory.
The supplied exports need no rebuild and no network access.
