From d3869e081e48d96731f74f87875f916d3f853e1c Mon Sep 17 00:00:00 2001 From: Thore Cimbal Date: Sun, 2 Aug 2026 12:00:00 +0000 Subject: [PATCH] =?UTF-8?q?vision:=20Branding-Dokument=20=E2=80=94=20Marke?= =?UTF-8?q?,=20Paletten,=20wo=20was=20eingestellt=20ist?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bislang lag verstreut, welche Farbe wo gilt: Element-Themes in der gitops-YAML, Desktop in einer zweiten Kopie, das BookStack-Schema ausschliesslich in einer Datenbank. Dieses Dokument buendelt es hier, weil das Repo jede Werkzeugentscheidung ueberlebt - wird BookStack nach ADR-0007 abgeraeumt, bleiben Marke und Palette bestehen. Enthaelt die zehn theme-factory-Paletten woertlich, sorbs aus der laufenden BookStack-Instanz extrahiertes Schema, die Tabelle 'wo was eingestellt ist' und zwei Fallen: is_dark laesst sich nicht aus den Skill-Beschreibungen ableiten (nur aus theme-showcase.pdf), und Icons brauchen resize() statt thumbnail(). Nebenbefund, festgehalten weil er die Diskussion aufloest: sorbs von Hand eingestelltes Schema und die offizielle Sunset-Boulevard-Palette sind bis auf zwei Ziffern identisch - beide auf demselben Coolors-Satz gelandet. Co-Authored-By: Claude Fable 5 Claude-Session: https://claude.ai/code/session_01PKhFj1S3UdD6xL2fbWPeYj --- README.md | 2 +- vision/branding.md | 102 +++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 103 insertions(+), 1 deletion(-) create mode 100644 vision/branding.md diff --git a/README.md b/README.md index 1c13eea..64a8beb 100644 --- a/README.md +++ b/README.md @@ -31,7 +31,7 @@ dieser Ausnahme sind Folgearbeit. | Pfad | Artefakt | |---|---| | [`CLAUDE.md`](CLAUDE.md) | **Kanonische Arbeitskonventionen für alle Agenten-Sessions** (Topologie, Framework, Secrets, Karpathy-Guidelines) | -| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) | +| `vision/` | Eine Vision je Linie: Community (axion1337.chat), Tool (ThreadNet), Plattform (Homelab) — dazu [`branding.md`](vision/branding.md) (Marke, Farben, wo welches Theme eingestellt ist) | | `roadmap.md` | Linien, Meilenstein-Kandidaten, Kadenz — GitLab-Milestones halten den Stand | | `decisions/` | ADRs — Pflicht bei Architekturentscheidungen **und dauerhaften Ausnahmen** | | `verfahren/` | Wie wir arbeiten: [Deploy-Übergabe/DoD](verfahren/deploy-uebergabe.md), [Refinement & Retro](verfahren/refinement.md), [AARs](verfahren/aar/), Werkzeuge | diff --git a/vision/branding.md b/vision/branding.md new file mode 100644 index 0000000..ad73c50 --- /dev/null +++ b/vision/branding.md @@ -0,0 +1,102 @@ +# Branding: Marke, Farben, Bildsprache + +Der verbindliche Ort für alles, was das Erscheinungsbild betrifft — über alle +Oberflächen hinweg (Chat-Clients, Wikis, künftige Dienste). Hier, weil dieses Repo +jede Werkzeugentscheidung überlebt: Wird das BookStack-Experiment abgeräumt oder +ein Client ersetzt, bleiben Marke und Palette bestehen. + +## Bildmarke + +`threadnet-mark.png` (Bildmarke) und `threadnet-logo-wortmarke.png` (mit +Schriftzug), erstellt von sorb. Sie liegen im Wiki-Repo unter `static/img/` und +sind die Quelle für alle abgeleiteten Formate — Favicon, App-Icons für macOS, +Windows und Linux, Web-Icons. + +⚠️ Beim Ableiten den **transparenten Rand wegschneiden** und mit `resize()` +skalieren, nicht mit `thumbnail()` — Letzteres verkleinert nur und lässt das Motiv +in großen Icons als Briefmarke zurück (real passiert, siehe +[AAR 2026-08-02](../verfahren/aar/2026-08-02-wiki-und-desktop-clients.md)). + +## Paletten + +### aXion1337 Dark — das Stammschema + +Gruvbox Dark. Grundtöne `#282828` / `#1d2021`, Text `#ebdbb2`, Akzent `#bd93f9`, +Sekundär `#fe8019`. Die acht Username-Farben sind der Gruvbox-Satz. +**`aXion1337 Light` ist das exakte helle Gegenstück** (Gruvbox Light) — gleiche +Rollenverteilung, gespiegelte Helligkeitsachse. Wer eines ändert, zieht das andere +mit. + +### Terrakotta-Beige — sorbs BookStack-Schema + +Am 2026-08-02 in der BookStack-Oberfläche eingestellt und von dort extrahiert +(die Werte stehen als CSS-Variablen im ausgelieferten HTML). Fünf der sieben sind +der Coolors-Satz `#264653 · #2A9D8F · #E9C46A · #F4A261 · #E76F51`: + +| Rolle in BookStack | Wert | Ton | +|---|---|---| +| Primäre Farbe | `#264653` | Charcoal | +| Standard-Linkfarbe | `#5f757b` | gedämpftes Blaugrau | +| Regalfarbe | `#e76e51` | Burnt Sienna | +| Buchfarbe | `#e9c46a` | Saffron | +| Kapitelfarbe | `#f3a261` | Sandy Brown | +| Seitenfarbe | `#77bb41` | Grün | +| Seitenentwurfsfarbe | `#e32400` | Rot | + +Bemerkenswert: **dieses von Hand eingestellte Schema ist bis auf zwei Ziffern die +offizielle Sunset-Boulevard-Palette** (siehe nächster Abschnitt) — `#e76e51` statt +`#e76f51`, `#f3a261` statt `#f4a261`. Beide Wege sind unabhängig voneinander auf +demselben Coolors-Satz gelandet. Die Irritation an der ersten Theme-Fassung war +also berechtigt und ließ sich an der Originalquelle belegen. + +### theme-factory — die zehn benannten Themes + +Quelle ist Anthropics [theme-factory-Skill](https://github.com/anthropics/skills/tree/main/skills/theme-factory): +je Theme vier Farben plus ein Schriftpaar. Sie sind seit 2026-08-02 **wörtlich +übernommen** (gitops `8a9d778`), nachdem eine erste Fassung die Namen frei +interpretiert hatte. + +| Theme | Hintergrund | hell/dunkel | Akzent · Sekundär · Highlight | +|---|---|---|---| +| Ocean Depths | `#f1faee` | hell | `#2d8b8b` · `#a8dadc` · `#457b9d` | +| Sunset Boulevard | `#264653` | dunkel | `#e76f51` · `#f4a261` · `#e9c46a` | +| Forest Canopy | `#faf9f6` | hell | `#2d4a2b` · `#7d8471` · `#a4ac86` | +| Modern Minimalist | `#ffffff` | hell | `#36454f` · `#708090` · `#d3d3d3` | +| Golden Hour | `#4a403a` | dunkel | `#f4a900` · `#c1666b` · `#d4b896` | +| Arctic Frost | `#fafafa` | hell | `#4a6fa5` · `#d4e4f7` · `#c0c0c0` | +| Desert Rose | `#5d2e46` | dunkel | `#d4a5a5` · `#b87d6d` · `#e8d5c4` | +| Tech Innovation | `#ffffff` | hell | `#0066ff` · `#00ffff` · `#1e1e1e` | +| Botanical Garden | `#f5f3ed` | hell | `#4a7c59` · `#f9a620` · `#b7472a` | +| Midnight Galaxy | `#e6e6fa` | hell | `#2b1e3e` · `#4a4e8f` · `#a490c2` | + +⚠️ **Ob ein Theme hell oder dunkel gemeint ist, steht nicht verlässlich in den +Beschreibungen** — „Warm Sand · backgrounds" findet sich bei einem Theme, dessen +Showcase-Seite dunkel ist. Maßgeblich ist `theme-showcase.pdf` im Skill: sieben der +zehn sind hell, nur Sunset Boulevard, Golden Hour und Desert Rose dunkel. +„Midnight" Galaxy ist trotz des Namens ein helles Theme mit dunkelviolettem Akzent. +Wer die Werte prüfen will, rendert die PDF-Seiten und misst die Hintergrundfarbe, +statt der Prosa zu glauben. + +Die übrigen Rollen (Flächenabstufungen, Username-Farben) sind aus diesen vier +Farben gemischt — so bleibt jedes Theme in sich stimmig, ohne dass Werte +dazuerfunden werden. + +## Wo was eingestellt ist + +| Oberfläche | Ort | Anmerkung | +|---|---|---| +| Element/ThreadNet-Web | `apps/production/custom-configs/element-values.yaml` (gitops), `setting_defaults.custom_themes` | 17 Themes; Änderungen chirurgisch, **nie die YAML neu serialisieren** | +| ThreadNet Desktop | `apps/desktop/axion1337/config.json` (ThreadNet-Web) | eigene Kopie derselben Themes — beim Ändern beide mitziehen | +| BookStack | *Settings → Customization*, getrennt für hell und dunkel | liegt in der Datenbank, **nicht im Repo** — Kopie in `theme/sorbs-palette.md` | +| BookStack (Feinschliff) | `theme/*.css` im Wiki-BookStack-Repo | nur Flächen, Text, Ränder — die sieben Farben oben gehören in die Oberfläche | +| Docusaurus-Wiki | `src/css/custom.css` (homelab/wiki) | bislang nur Akzentfarbe | + +⚠️ **Das BookStack-Schema lebt nur in der Datenbank.** Bei einem Volume-Verlust +ist es weg — deshalb steht es oben in dieser Tabelle. Wiederherstellen heißt: +sieben Felder in der Oberfläche neu eintragen. + +## Offen + +Ob die Terrakotta-Richtung das Stammschema ablösen oder eine Alternative neben +Gruvbox bleiben soll, ist nicht entschieden — das gehört in die Rebranding-Runde +(→ [`threadnet.md`](threadnet.md), ThreadNet-Web#10).