Die eine Quelle der Corporate Identity: Design-Tokens als CSS-Variablen und die Wortmarke. Portal (INFORENT-Portal) und Website (INFORENT-Website) beziehen beide dieses Paket — keiner der beiden definiert Farben selbst.
| Datei | Inhalt |
|---|---|
tokens.css |
drei :root-Regeln: Geometrie (Abstände, Radien, Schriftgrößen, Schatten, Dauer), helle Palette, dunkle Palette (:root[data-theme='dark']) |
base.css |
globale Element-Regeln aller Oberflächen: Fokusrahmen, Formularfelder, Buttons (Hover, deaktiviert), Textauswahl, Scrollbalken, Skip-Link, reduzierte Bewegung — aus dem Portal übernommen |
vars.js / vars.d.ts |
jede Variable als typisierte Konstante: vars.textMuted = 'var(--text-muted)', dazu values.light / values.dark mit den aufgelösten Werten für Canvas, WebGL und SVG-Attribute (erzeugt aus tokens.css) |
components.css / components.js |
die Optik der Bausteine — Knopf, Feld, Abzeichen, Hinweis, Karte, Fläche, Aktionsleiste — als Klassen (ir-*) und als typisierte Stilobjekte; beides aus components.def.mjs erzeugt |
logo.png |
die Wortmarke (200 × 110, dunkle Grafik) |
bin/brand-lint.mjs |
Prüfskript für die Verbraucher (siehe unten) |
Die Bilder erzeugt npm run preview aus tokens.css; npm run check schlägt fehl, wenn sie nicht
mehr passen.
Styleguide für Menschen: brand.inforent.com — Farben mit Rolle,
Schrift, Wortmarke, Raster und Regeln, hell und dunkel. Erzeugt npm run site aus tokens.css
(site-dist/, nicht eingecheckt); die Action site baut und lädt bei jedem Push auf main und
jedem Tag per SFTP hoch (Secrets SFTP_HOST, SFTP_PORT, SFTP_USER, SFTP_PASSWORD, Kopf von
.github/workflows/site.yml). Die Seite ist keine Einbinde-Adresse — Projekte beziehen das Paket
über das Release.
Bedeutung und Regeln der Werte (wann --brand, wann --primary, Kontraste, Schriften):
docs/areas/brand.md im Portal-Repo.
Das Paket liegt nicht auf npmjs.com, sondern als Anhang am GitHub-Release — eine feste Datei,
deren Prüfsumme im package-lock.json steht:
npm install https://github.com/INFORENT-GmbH/INFORENT-Brand/releases/download/v1.1.0/inforent-brand-1.1.0.tgzimport '@inforent/brand/tokens.css' // zuerst — die Werte
import '@inforent/brand/base.css' // dann die gemeinsamen Element-Regeln
import './eigenes.css' // zuletzt das Projekt-CSS (gewinnt per Kaskade)
import { vars } from '@inforent/brand/vars'
import logo from '@inforent/brand/logo.png'
const card = { background: vars.surface, border: `1px solid ${vars.border}`, borderRadius: vars.radiusLg }vars.* statt Zeichenketten: ein Tippfehler oder eine Variable, die eine neue Brand-Version
entfernt hat, ist ein Compile-Fehler statt eines stumm leeren Werts im Browser.
Dunkelmodus: data-theme="dark" auf <html> setzen, alle Variablen schalten mit.
- Die Variablennamen sind die Schnittstelle. Neuer Name oder geänderter Wert → Minor
(
1.1.0); Name umbenannt oder entfernt → Major (2.0.0), weil ein Verbraucher ihn noch lesen kann. - Werte, Grundregeln, Baustein-Optik — kein Verhalten. Zwischen
BEGIN tokensundEND tokensstehen ausschließlich die drei:root-Regeln (npm run checkprüft das, das Portal auch).components.cssist opt-in und nur Klassen mit Präfixir-; React-Komponenten, Dialog-Fokus und Routing bleiben im jeweiligen Projekt. - Abweichungen eines Verbrauchers (z. B. größere Schriften der Website) gehören in dessen eigenes CSS nach dem Import — nie hierher.
- Weich, nicht eckig (seit 1.4.0):
--radius-xxsbis--radius-xlsind 2/4/6/6/8/12 px,--radius-pill999 px — Flächen tragen eine Haarlinie (--border) plus--shadow-sm, die Tiefe kommt aus beidem, nicht aus einem kräftigen Rahmen. Verbraucher setzen keine eigenen Radien, sondern nutzen immervar(--radius-*)— die Stufe sagt, welche Art Fläche gemeint ist. - Keine Verläufe,
--brand(#ed1c24) nie als Button-Fläche und nie als Text unter ~24 px.
Die Optik der gemeinsamen Bausteine, damit ein Knopf auf der Website aussieht wie im Portal. Vorschau aller Varianten: brand.inforent.com.
<button class="ir-btn ir-btn--md ir-btn--primary">Speichern</button>
<a class="ir-btn ir-btn--md" href="/kontakt">Kontakt</a>
<input class="ir-input" placeholder="Hostname">
<span class="ir-badge ir-badge--md ir-badge--success">Läuft</span>
<div class="ir-alert ir-alert--info">Hinweis</div>import '@inforent/brand/components.css' // Klassen
import { button, input, badge } from '@inforent/brand/components' // oder als Stilobjekte (React)
const style = { ...button.base, ...button.sizes.md, ...button.variants.primary }| Baustein | Klassen | Regel |
|---|---|---|
| Knopf | ir-btn + --xs/--sm/--md + --primary/--secondary/--ghost/--danger/--danger-outline/--admin |
Hauptaktion primary (eine je Maske, ganz rechts), Abbrechen secondary links daneben, Löschen danger-outline (gefüllt nur im Bestätigungsdialog), Umschalten secondary, ghost für Drittaktionen im Inhalt, admin nur für Neben-Aktionen. Eine Leiste, eine Höhe. |
| Feld | ir-input (+ --sm/--lg, --mono, --admin, ir-textarea); aria-invalid="true", readonly |
Höhe = --control-height, gleich Knopf md und Auswahlliste |
| Abzeichen | ir-badge + --sm/--md + Ton (--neutral/--primary/--success/--danger/--warning/--info/--accent), optional --solid/--outline |
Farbe nie allein — immer mit Wort |
| Hinweis | ir-alert + --error/--warning/--success/--info |
|
| Fläche | ir-card (--admin), ir-panel + --plain/--muted/--inset, --pad |
|
| Aktionsleiste | ir-action-bar; Knöpfe darin zusätzlich ir-btn--on-bar |
Anzahl links, Aktionen rechts, „Auswahl aufheben“ zuletzt |
Hover, Fokus und gesperrt kommen aus base.css — beide Dateien laden.
Das Paket bringt ein Prüfskript mit, das Portal und Website in ihrer CI laufen lassen. Die Regeln sind mit der Brand versioniert: eine neue Regel erreicht beide Projekte mit dem nächsten Update.
npx brand-lint site/ # Website
npx brand-lint --baseline brand-lint-baseline.json src … # Portal (mit Ratsche)| Regel | findet | stattdessen |
|---|---|---|
color |
#hex, rgb(), hsl() … im Code |
var(--…) bzw. vars.* |
gradient |
linear-/radial-/conic-gradient |
— die Brand hat keine Verläufe |
radius |
Eckenradius ≠ 0 als Zahl, eigene Radius-Skala | var(--radius-*) / vars.radius* (eckig) |
font |
Schriftfamilie als Text | var(--ui-font) / var(--mono-font) |
font-cdn |
Google Fonts, Typekit … | selbst hosten (@fontsource) |
unknown-var |
var(--x), das es weder in der Brand noch im Projekt gibt |
Tippfehler beheben / Namen aus der Brand |
Ausgenommen sind die generierten Brand-Kopien (zwischen BEGIN tokens/END tokens bzw.
BEGIN base/END base) und Kommentare. <meta name="theme-color"> darf einen Hex-Wert tragen,
wenn er in der Brand vorkommt (dort funktioniert var() nicht).
Begründete Ausnahme: Kommentar brand-allow: <Grund> in derselben oder der Zeile darüber, oder
ein Block brand-allow-start: <Grund> … brand-allow-end (z. B. eine Diagrammpalette für
Canvas/SVG, eine fremde Marke). Ohne Grund zählt die Markierung nicht.
Baseline (Ratsche): --baseline <datei> erlaubt die bestehenden Befunde je Datei und Regel,
nur mehr schlägt fehl; --write-baseline schreibt den aktuellen Stand fest (auch nach dem Abbau).
- Änderung per Pull Request, danach
npm run gen(vars) undnpm run preview(Vorschaubilder);npm run checkmuss grün sein. versioninpackage.jsonhochzählen, Eintrag inCHANGELOG.md.- Annotierten Tag setzen und pushen — der Tag-Text wird die Release-Notiz:
Die Action
git tag -a v1.1.0 -m "v1.1.0: --foo ergänzt" git push origin main v1.1.0releasebaut das Paket und hängtinforent-brand-1.1.0.tgzans Release. - In Portal und Website die URL in
package.jsonauf die neue Version setzen undnpm install. Im Portal danachnpm run tokens:writeinweb/(schreibttokens.cssundbase.cssinindex.htmlund die Nebenseiten) und committen.npm run lintzeigt, ob neue Regeln greifen.
