Brand Guide
π€ Generated with Claude Code
β οΈ Not yet reviewed
Co-Authored-By: Claude (noreply@anthropic.com)
Technical brand guide for TOGETHER/CCA documentation and diagrams. It is written for developers and AI agents, not for designers: the colours, logos and D2 conventions here are the ones a document or a diagram has to follow.
Contentsβ
- Quick Reference - AI agent D2 diagram cheat sheet
- Brand Policy - Logo usage guidelines
- Colors - Interactive color palettes (MDX)
- Diagrams - D2 style guide and templates
- Logos - Product logo reference (MDX)
- Icons - Diagram icons
- Typography - Typography guidelines
- Cookbook - Common tasks and recipes
Shared Assetsβ
The raw assets live in assets/ at the root of this repository, and are published at the
site root β assets/colors/β¦ is served as /colors/β¦:
| Asset | Purpose |
|---|---|
assets/colors/_colors.d2 | full D2 palette β every diagram imports this |
assets/colors/_colors-context.d2 | Context mode: system colours plus alternates |
assets/colors/_colors-internal.d2 | Internal mode: hierarchy ramps plus system colours |
assets/colors/_colors-analysis.d2 | Analysis mode: status colours plus system alternates |
assets/colors/colors.css | the same palette as CSS custom properties |
assets/colors/colors.json | machine-readable UI colours |
assets/colors/architecture.json | architecture-diagram colours |
assets/colors/color-tiers-preview.html | four-tier colour preview |
assets/icons/user.svg | person icon for diagrams |
assets/corporate/corporate-style-guide.pdf | the corporate rules the policy derives from |
Colours in D2 diagramsβ
Import the palette relatively β never copy it. The number of ../ follows the depth of
the diagram, here from development/ci-cd/diagrams/:
...@../../../assets/colors/_colors.d2
box: "TOGETHER" {
style.fill: ${together}
}
Colours in CSS and in toolingβ
@import 'assets/colors/colors.css';
.element {
background: var(--color-orange-peel);
}
import colors from './assets/colors/colors.json';
const primary = colors.categories.primary.colors['orange-peel'].base;
Where the colours come fromβ
| Colours | Source |
|---|---|
| UI colours | generated from the SCSS variables in tis-cca.styleguide (npm run build:v2:colors there), then copied here |
Architecture colours (kundensystem, vu, β¦) | defined by Marketing β not derived from SCSS |
Changing a colour therefore starts in tis-cca.styleguide, not here. See CLAUDE.md.
MDX Filesβ
The following files use MDX (Markdown + React components) for interactive features:
Colors (all files are MDX)β
colors/index.mdx- Color palette overviewcolors/hierarchy-ramps.mdx- Tier-based color hierarchycolors/analysis-mode.mdx- Analysis mode colorscolors/context-mode.mdx- Context mode colors
Logos (all files are MDX)β
logos/index.mdx- Logo overviewlogos/boabot.mdx- BOAbot brandlogos/cca.mdx- CCA brandlogos/cca-cloudedi.mdx- CCA CloudEdi brandlogos/myversum.mdx- myVersUm brandlogos/omds-browser.mdx- OMDS Browser brandlogos/omdsmanager.mdx- OMDS Manager brandlogos/proversum.mdx- proVersUm brandlogos/together.mdx- TOGETHER brandlogos/together-cca.mdx- TOGETHER CCA brandlogos/togethersign.mdx- TOGETHERsign brandlogos/vu-logos.mdx- VU (insurance company) logos
Diagrams (icons.mdx only)β
diagrams/icons.mdx- Icon usage examples
All other files (.md files, .d2 templates) are pure Markdown and can be used in any context.
For AI Agentsβ
When creating documentation or diagrams:
- Start with Quick Reference for D2 syntax
- Import colors from
assets/colors/_colors.d2with a relative path - Follow the Diagram Style Guide
- Use the D2 templates in
diagrams/templates/as starting points
Raw Assets over HTTPβ
Assets are served from the site root, so assets/colors/β¦ becomes /colors/β¦.
Current β the dev-docs container, which requires a SAS token; see DEPLOYMENT.md:
https://tisccacdnstorage.blob.core.windows.net/dev-docs/colors/_colors.d2?<sas-token>
https://tisccacdnstorage.blob.core.windows.net/dev-docs/colors/colors.json?<sas-token>
https://tisccacdnstorage.blob.core.windows.net/dev-docs/icons/user.svg?<sas-token>
Planned, once the site moves to the public CDN:
https://cdn.togethercca.com/colors/_colors.d2
https://cdn.togethercca.com/colors/colors.json
https://cdn.togethercca.com/icons/user.svg
Local Previewβ
cd site
npm run start