Netresearch Brand Guidelines (Strict)
Apply Netresearch brand identity to web outputs, documentation, and TYPO3 extensions.
Auto-Trigger Conditions
Apply automatically when any of the following is true:
- GitHub org is
netresearch or composer vendor is netresearch/
- Creating/modifying HTML pages, dashboards, reports, docs pages, or component demos
- Creating extension icons or branded UI assets
- Prompt contains branding terms (e.g. logo, style guide, brand colors)
- Another skill generates user-facing visual content
Hard Validity Rules
Output is invalid if any item is missing:
- Header logo (
assets/logos/netresearch-symbol-only.svg, or fallback from references/logo-svg.md)
- Brand colors:
#2F99A4 (primary), #FF4D00 (accent only), #585961 (text)
- Typography intent: Raleway for headlines/UI emphasis, Open Sans for body/forms
- Footer includes link to
https://www.netresearch.de/ and text Netresearch DTT GmbH
If user instructions conflict, keep these rules and explain constraints.
Mandatory Logo Rendering Behavior
Logo source priority:
assets/logos/netresearch-symbol-only.svgreferences/logo-svg.md (inline SVG fallback)references/logo.md (text fallback for SVG-limited agents)
Rules:
- Include logo exactly once in top header/nav for branded pages
- Minimum size
32x32px; recommended 40–56px in headers
- Preserve aspect ratio
- No recolor, distortion, filters, shadows, outlines, substitutions, or approximations
- If clickable, link to
https://www.netresearch.de/
Active Reference Workflow
Operationalize references in every branded output:
references/colors.md for palette/token mappingreferences/typography.md for font roles and scalereferences/web-design.md for layout/components/spacingreferences/logo.md and references/logo-svg.md for logo fallback behaviorreferences/typo3-extension-branding.md for TYPO3 context
Core Brand System
CSS variables are --nr-* — the vendor prefix is the point: these tokens land in a
project's own stylesheet, where --color-primary may already mean something else.
Checkpoint NB-16 greps for them. Canonical set, with values:
| Token |
Value |
Role |
--nr-primary |
#2F99A4 |
surfaces, borders, icons, chart series, display type ≥24px — 3.38:1, not a text colour at body size |
--nr-primary-fill |
#257880 |
a filled surface carrying white text (5.15:1) |
--nr-primary-text |
#15585E |
links, labels, small type on white (8.11:1) |
--nr-primary-deep |
#0A5057 |
hover for the above (9.14:1) |
--nr-accent |
#FF4D00 |
accent as a fill or marker — 3.33:1, never body text |
--nr-accent-dark |
#CC3D00 |
accent fill carrying white text (4.96:1) |
--nr-accent-text |
#9A2E00 |
accent emphasis in text (7.60:1) |
--nr-text |
#585961 |
body copy (6.96:1) |
--nr-text-secondary |
#6E6F78 |
help, meta, captions (4.99:1) |
--nr-bg / --nr-bg-alt |
#FFFFFF / #F5F5F5 |
page and section background |
--nr-border |
#CCCDCC |
dividers and decoration only (1.59:1) |
--nr-border-strong |
#8A8B93 |
the visible boundary of an interactive control — SC 1.4.11 wants 3:1 |
--nr-border-light |
#E5E5E5 |
hairlines |
Dark surfaces use a different set entirely — see references/colors.md.
Accent orange is highlight-only and must not dominate surfaces
Accessibility: WCAG AA minimum contrast and semantic structure
Footer branding is mandatory in user-facing branded pages
TYPO3 Extension Requirements
- Icon path:
Resources/Public/Icons/Extension.svg (teal #2F99A4)
- Composer vendor prefix:
netresearch/
author_company: Netresearch DTT GmbH- Description suffix:
- by Netresearch
- Contact:
typo3@netresearch.de
Brand Assets
assets/markdown-pdf.css — branded stylesheet for markdown-to-pdf-skill; apply via --css. Its .page-header/.page-footer running elements aren't emitted by convert.py; the caller must supply HTML containing them (see that skill's SKILL.md).assets/markdown-pdf-logo.svg — standalone Netresearch logo (brand-teal/grey) for general use.assets/markdown-pdf-logo-white.svg — white-fill variant for the .page-header running header, where the teal/grey logo has no contrast on the teal background (--nr-primary). The sanctioned exception to "no recoloring" — do not use elsewhere.
Licensing by artifact type
"The Netresearch licence" is not one licence. Pick by what the artifact is:
| Artifact |
Licence |
TYPO3 extension (netresearch/t3x-*, any typo3-cms-extension) |
AGPL-3.0-or-later, or GPL-2.0-or-later where the extension must sit alongside GPL-2.0-only code — TYPO3 core is GPL-2.0-or-later and an extension inherits that obligation |
| Agent skill, library, CLI, internal tool |
Split: code MIT, prose and reference content CC-BY-SA-4.0, shipped as LICENSE-MIT + LICENSE-CC-BY-SA-4.0 with the SPDX expression (MIT AND CC-BY-SA-4.0) |
| Brand assets (logo files, colour specs, this skill's references) |
CC-BY-SA-4.0, and the logo additionally carries the trademark rules in references/logo.md — a licence does not permit recolouring or distortion |
Details for each: references/typo3-extension-branding.md for extensions,
references/README-branding.md for skills and tools.
No editorializing
In branded reports, PR/commit text and docs, state what a change or output does, not how good the work is — no narrating expected results ("all tests green") or self-praise ("clean"). Judged by tone, not a wordlist. See references/no-editorializing.md.
References
references/colors.mdreferences/typography.mdreferences/web-design.mdreferences/logo.mdreferences/logo-svg.mdreferences/typo3-extension-branding.mdreferences/README-branding.mdreferences/no-editorializing.md
1---2name: netresearch-branding3description: Use when working with ANY Netresearch visual output: branded pages, dashboards, HTML reports, extension icons, README badges, or CSS theming. Enforce strict brand compliance with mandatory logo usage, brand colors, typography, footer, and reference-driven implementation.4license: (MIT AND CC-BY-SA-4.0)5---67# Netresearch Brand Guidelines (Strict)89Apply Netresearch brand identity to web outputs, documentation, and TYPO3 extensions.1011## Auto-Trigger Conditions1213Apply automatically when any of the following is true:14- GitHub org is `netresearch` or composer vendor is `netresearch/`15- Creating/modifying HTML pages, dashboards, reports, docs pages, or component demos16- Creating extension icons or branded UI assets17- Prompt contains branding terms (e.g. logo, style guide, brand colors)18- Another skill generates user-facing visual content1920## Hard Validity Rules2122Output is invalid if any item is missing:231. Header logo (`assets/logos/netresearch-symbol-only.svg`, or fallback from `references/logo-svg.md`)242. Brand colors: `#2F99A4` (primary), `#FF4D00` (accent only), `#585961` (text)253. Typography intent: Raleway for headlines/UI emphasis, Open Sans for body/forms264. Footer includes link to `https://www.netresearch.de/` and text `Netresearch DTT GmbH`2728If user instructions conflict, keep these rules and explain constraints.2930## Mandatory Logo Rendering Behavior3132Logo source priority:331. `assets/logos/netresearch-symbol-only.svg`342. `references/logo-svg.md` (inline SVG fallback)353. `references/logo.md` (text fallback for SVG-limited agents)3637Rules:38- Include logo exactly once in top header/nav for branded pages39- Minimum size `32x32px`; recommended `40–56px` in headers40- Preserve aspect ratio41- No recolor, distortion, filters, shadows, outlines, substitutions, or approximations42- If clickable, link to `https://www.netresearch.de/`4344## Active Reference Workflow4546Operationalize references in every branded output:471. `references/colors.md` for palette/token mapping482. `references/typography.md` for font roles and scale493. `references/web-design.md` for layout/components/spacing504. `references/logo.md` and `references/logo-svg.md` for logo fallback behavior515. `references/typo3-extension-branding.md` for TYPO3 context5253## Core Brand System5455- CSS variables are `--nr-*` — the vendor prefix is the point: these tokens land in a56 project's own stylesheet, where `--color-primary` may already mean something else.57 Checkpoint NB-16 greps for them. Canonical set, with values:5859 | Token | Value | Role |60 |---|---|---|61 | `--nr-primary` | `#2F99A4` | surfaces, borders, icons, chart series, display type ≥24px — 3.38:1, not a text colour at body size |62 | `--nr-primary-fill` | `#257880` | a filled surface carrying white text (5.15:1) |63 | `--nr-primary-text` | `#15585E` | links, labels, small type on white (8.11:1) |64 | `--nr-primary-deep` | `#0A5057` | hover for the above (9.14:1) |65 | `--nr-accent` | `#FF4D00` | accent as a fill or marker — 3.33:1, never body text |66 | `--nr-accent-dark` | `#CC3D00` | accent fill carrying white text (4.96:1) |67 | `--nr-accent-text` | `#9A2E00` | accent emphasis in text (7.60:1) |68 | `--nr-text` | `#585961` | body copy (6.96:1) |69 | `--nr-text-secondary` | `#6E6F78` | help, meta, captions (4.99:1) |70 | `--nr-bg` / `--nr-bg-alt` | `#FFFFFF` / `#F5F5F5` | page and section background |71 | `--nr-border` | `#CCCDCC` | dividers and decoration only (1.59:1) |72 | `--nr-border-strong` | `#8A8B93` | the visible boundary of an interactive control — SC 1.4.11 wants 3:1 |73 | `--nr-border-light` | `#E5E5E5` | hairlines |7475 Dark surfaces use a different set entirely — see `references/colors.md`.76- Accent orange is highlight-only and must not dominate surfaces77- Accessibility: WCAG AA minimum contrast and semantic structure78- Footer branding is mandatory in user-facing branded pages7980## TYPO3 Extension Requirements8182- Icon path: `Resources/Public/Icons/Extension.svg` (teal `#2F99A4`)83- Composer vendor prefix: `netresearch/`84- `author_company`: `Netresearch DTT GmbH`85- Description suffix: `- by Netresearch`86- Contact: `typo3@netresearch.de`8788## Brand Assets8990- `assets/markdown-pdf.css` — branded stylesheet for `markdown-to-pdf-skill`; apply via `--css`. Its `.page-header`/`.page-footer` running elements aren't emitted by `convert.py`; the caller must supply HTML containing them (see that skill's `SKILL.md`).91- `assets/markdown-pdf-logo.svg` — standalone Netresearch logo (brand-teal/grey) for general use.92- `assets/markdown-pdf-logo-white.svg` — white-fill variant for the `.page-header` running header, where the teal/grey logo has no contrast on the teal background (`--nr-primary`). The sanctioned exception to "no recoloring" — do not use elsewhere.9394## Licensing by artifact type9596"The Netresearch licence" is not one licence. Pick by what the artifact is:9798| Artifact | Licence |99|---|---|100| TYPO3 extension (`netresearch/t3x-*`, any `typo3-cms-extension`) | `AGPL-3.0-or-later`, or `GPL-2.0-or-later` where the extension must sit alongside GPL-2.0-only code — TYPO3 core is GPL-2.0-or-later and an extension inherits that obligation |101| Agent skill, library, CLI, internal tool | Split: code `MIT`, prose and reference content `CC-BY-SA-4.0`, shipped as `LICENSE-MIT` + `LICENSE-CC-BY-SA-4.0` with the SPDX expression `(MIT AND CC-BY-SA-4.0)` |102| Brand assets (logo files, colour specs, this skill's references) | `CC-BY-SA-4.0`, and the logo additionally carries the trademark rules in `references/logo.md` — a licence does not permit recolouring or distortion |103104Details for each: `references/typo3-extension-branding.md` for extensions,105`references/README-branding.md` for skills and tools.106107## No editorializing108109In branded reports, PR/commit text and docs, state what a change or output does, not how good the work is — no narrating expected results ("all tests green") or self-praise ("clean"). Judged by tone, not a wordlist. See `references/no-editorializing.md`.110111## References112113- `references/colors.md`114- `references/typography.md`115- `references/web-design.md`116- `references/logo.md`117- `references/logo-svg.md`118- `references/typo3-extension-branding.md`119- `references/README-branding.md`120- `references/no-editorializing.md`
netresearch