Atlas Crew Brand Assets

This repository contains **brand library** for every Atlas Crew product, plus resources for **using & managing** the assets.

---

Contents

• What's Included
  • Brand Assets
    • Brand Documentation
    • Graphics
    • Other
  • Shared Assets
  • Resources
• Products
• Conventions
  • File Names
  • Directory Structure
• Generating Assets
  • Selecting a brand
  • Common commands
  • Cleanup
• Dependencies

What's Included

This section contains a detailed breakdown of all the assets you might find in an individual brand library and lists the available shared assets.

Brand Assets

Each product, including the Atlas Crew parent brand, have a dedicated brand library.

Brand Documentation

Documentation is in markdown (*.md) format and optimized for AI agents.

• BRAND.md - Brand guidelines
• COPY.md - Copywriting reference
• FAQ.md - Frequently asked questions
• BIOS.md - Founder bio / origin story
• Decision record
• Discovery record of existing assets

Graphics

• _source/ - Source files (Illustrator, HTML, etc.)
• exports/ - Exports, sorted by purpose

Other

• Press kit and swatches (for human designers)

Shared Assets

Shared assets are used by one or more brand library.

• Fonts
• Color palettes
• CSS Tokens

Resources

This section lists tools to help humans and AI agents use and management the assets in this repo.

• justfile - Automation for generating and managing assets
• .agents/skills/brand-library-architect - Skill teaching AI agents how to create new brand libraries

Products

These are the Atlas Crew products with brand libraries in this repo:

• Atlas Crew - Parent Brand
• Facet - Career Operating System (SaaS)
• Atlas Crew Security - Flagship Security Products
  • Synapse - Fleet Defense / WAAP (Web & API Protection)
  • Crucible - Adversary Emulation / Assessment Framework
  • Chimera - Vulnerable Targets / Educational platform

Note: All Atlas Crew products are open-source (licensed under AGPL-3 or MIT) and support self-hosting. Facet is available as a hosted SaaS application.

Conventions

File Names

Format: prefix-asset-name-purpose-scale.ext

Segments:

• Prefix: product name (e.g. facet, synapse)
• Asset Name: Optional descriptive identifier (e.g. beam-striking-crystal)
• Purpose: Export type (e.g. social, web, concept)
• Scale: Dimensions (e.g. @2x - Retina, @1x - Standard, thumb - Thumbnail)
• Extension: File type (e.g. PNG, WebP)

Examples:

• facet-cinematic.webp
• synapse-hero-thumb.webp
• chimera-hero@2x.webp

Directory Structure

README.md
AGENTS.md

justfile         # automation (generate assets)

shared/
  tokens.json     # shared color/spacing tokens
  palette.md      # shared palette doc
  fonts/
  templates/

<product>/        # product / brand
  BIOS.md
  BRAND.md
  COPY.md
  CHEATSHEET.md
  CHANGELOG.md
  DECISIONS.md
  DISCOVERY.md
  CLAUDE.md
  FAQ.md
  MANIFESTO.md
  PRICING.md
  README.md
  RECIPES.md
  TONE.md

  icons/          # Logos and symbols
    svg/
    png/
    ico/

  _drafts/        # WIP exports, not tracked

  _source/
    ai/           # Adobe Illustrator files
    psd/          # Adobe Photoshop files
    html/         # HTML sheets
    raw/          # Master PNG/JPG/TIFF files
    svg/          # Composite Lockup sheets

  exports/
    social/       # og-images, twitter, etc.
    hero/         # Heros and large web graphics
    banners/      # Misc. banners
    email/        # E-mail banners
    readme/       # README banners
    concepts/     # Explanatory graphics
    promo/        # Launch, pricing, promotional
    carousel/     # Linkedin carousel images
    composite/    # Gallery view of export types
    swatch/       # Colors, typopgrahy, etc. for designers
    manifesto/
    story/
    poster/
    principle/
    method/
    reference/

  press/
    README.md
    hero/
    logo/
    swatch/

Generating Assets

The justfile renders brand assets from the HTML sources in <brand>/_source/html/ via headless Playwright, then converts the resulting PNGs to WebP (full-size and thumbnail). Every recipe operates on a single brand directory, selected at invocation. The default brand is facet.

Selecting a brand

Override the brand via env var or just-var; both work for any recipe:

BRAND=synapse just brand           # via env var
just brand=chimera brand-concepts  # via just-var override

Common commands

# Render every category and convert PNGs to WebP
just brand
BRAND=synapse just brand           # target a different brand

# List every available recipe (private helpers are hidden)
just --list

# Render a single category
just brand-concepts                # all 14 concept variants
just brand-social                  # 6 social variants
just brand-banners                 # 6 banner variants

# Render a single asset
just brand-concept system dark
just brand-banner bold-light

# Open all sheets in the default browser for visual review (no rendering)
just brand-review

# Clean up rendered exports (AI exports preserved — see below)
just brand-clean

Cleanup

Each render appends produced file paths to <brand>/exports/.manifest. just brand-clean reads that manifest and removes only the files it lists, so Adobe Illustrator exports that share the same <brand>-* filename prefix are preserved.

If the manifest is missing (e.g., older renders predate this workflow), brand-clean falls back to deleting any leftover .png intermediates so an interrupted render doesn't leave junk behind — existing .webp files won't be swept on first run. Re-render once to rebuild the manifest, then brand-clean works fully.

Dependencies

These dependencies are required to use the included automation.

• just - required to use the automated tools (brew install just)
• Node.js - npx playwright is used to export graphics from HTML sources
• cwebp - used to convert images from PNG format to WebP