math-tasks/assets/themes/nms/CLAUDE.md

2.9 KiB

NMS (No Man's Sky) Theme

Space exploration theme inspired by No Man's Sky. Dark cosmic backgrounds, asteroid fields, cargo freighters, planet panoramas.

Asset Inventory

Category Path Count Description
Hero images hero-images/spaceship{1-9}.{jpeg,png} 15 Spaceships for page headers
Splitters hero-images/splitters/splitter{1-9}.png 9 Splitting ship variants
Footers - Planets footers/planet{1-9}.jpeg 9 Planet panoramas
Footers - Cabins footers/cabin{1-9}.jpeg 9 Ship interior views
Icons Pack 1 icons/pack1/ 60 Minerals & plants (space-exploration)
Icons Pack 2 icons/pack2/ 60 Elements (space-exploration)
Icons Pack 3 icons/pack3-asteroids/ 16 Colored asteroid icons
Icons Pack 4 icons/pack4-cargobay/ 9 Cargo bay icons
Asteroids items/asteroids/ 17 Full-size colored asteroid images
Asteroid shapes items/asteroid-shapes/ 16 Line-art asteroid silhouettes
Freighters items/freighters/ 30 Ships and pods
Plants items/plants/ 6 Decorative plant icons
Stones items/stones/ 6 Stone/mineral textures
Elements items/elements/ 4 Element icons

Legacy: icons/pack1-2-unused/ (136 files) — superseded by pack2, kept for reference.

Usage in Templates

All paths relative to project root:

  • HTML templates: /assets/themes/nms/{category}/{file}
  • Generator scripts (from docs/): ../../assets/themes/nms/{category}/{file}
  • Generator scripts (from project root): assets/themes/nms/{category}/{file}

Color Palette

Element Class
Title text text-indigo-950
Subtitle text-indigo-400
Card border border-indigo-100
Answer underline border-indigo-300
Card bg gradient from-white to-indigo-50/40
Badges bg-indigo-600

Adding New Assets

  1. Generate via /gen-image with --ref from same category for visual consistency
  2. Save raw output (white background) to items/{category}/raw/
  3. Run pnpm remove-bg if transparent background needed
  4. Move final PNG to items/{category}/

Reference Policy

  • items/asteroids/ — use any existing asteroid as --ref
  • items/crystals/ — use any existing crystal as --ref
  • icons/ — generate independently (icon packs have their own pipeline)
  • hero-images/, footers/, backgrounds/ — generate independently

Cargo Bay Image Generation

Proven approach for generating cargo-bayN.jpeg from spaceshipN.jpeg:

  • Ref: use original spaceshipN.jpeg first, then iterate using the generated cargo-bayN.jpeg as ref
  • Template: illustration, Aspect: 16:9, Flag: --no-enhance
  • Key prompt elements: describe the ship's unique features, emphasize "NO landing gear", "rear engines glow", "open cargo bay hatch", "flying in zero gravity", "white background", "concept art illustration style"