n3 — Status (mobil)

01 Überblick

Eine Spec, n Renderer. Die Dart-Engine ist kanonisch, @n3/web spiegelt sie bit-identisch nach (Cross-Language-Golden-Tests).

core/spec

Schemas · Paletten · Scales · Tokens

↓

n3_flutter ≡ @n3/web

kanonisch · golden-gespiegelt

↓

N3 Lab

einzige Schreib-Oberfläche

Drei Produktiv-Consumer: datada (Web + Flutter), PayMore (voller Engine-Swap), brokay (Livestyling-Pilot).

02 Stand

8 von 9 Roadmap-Phasen erledigt, eine umformuliert statt abgehakt.

R-1…R-7	Monorepo, Flutter-/Web-Engine, Lab, datada- + PayMore-Migration erledigt
R-8	Fiddle-Integration umformuliert → jetzt Teil von Livestyling (LS-2)
R-9	Typo- + Shape-Engine, die Dreieinigkeit komplett erledigt

03 Fertig

Auswahl der größten Bausteine — vollständige Liste im Desktop-Report.

34-Rollen Color-Schemegolden

Multi-Seed-HCT → volles M3-Scheme, originalgetreue Akzente über optionalen tone pro Seed.
Palette-WerkstattPW-1…7

Import, Batch-Regelwerk, Live-Durchklick-Test, Tags statt Ordner, App→Spec-Rückweg via Firebase.
Bild-Farb-ExtraktionIMG-1/2

Pipette + Lupe, automatische Median-Cut-Extraktion, direkt in die Werkstatt.
Livestyling & HighlightLS-1/4/5/6

Lab streamt Palette+Shape+Token live in eine eingebettete App. Rolle/Corner/Token hovern → wird auffällig — zeigt nebenbei ungebundene Hardcodes.
Server-side WriteR-11

Lab schreibt über eine Cloudflare-Function, kein GitHub-Token mehr im Browser.

04 Offen

LS-2 / LS-3offen

Fiddle gegen Mock-Ziel; Theme-Scope-Liste für Apps mit mehreren Themes.
CI-2 / CI-3offen

Rollout-Default-Theme; Consumer-Doku für Flutter-Typo/Shape/Tokens vervollständigen.
F1-PA1wartet

Palettes-Tab-Überarbeitung.

blockiert auf: User-Design
R-5bwartet

Geteilter Store über mehrere Apps & Geräte — braucht eine Architektur-Entscheidung.
R-11 / PW-7wartet

Publish-Flow und App-Rückweg noch nicht live gegen echte Daten verifiziert.

05 Verworfen

m3-palette-lab.html
Altes Kurations-Tool — Batch-Logik lebt in der Palette-Werkstatt weiter, UI nicht übernommen. Screenshot im Desktop-Report.
GitHub-PAT pro App
Ersetzt durch token-losen Weg über das bestehende Firebase-Mirror der App.
Browser-PAT fürs Lab
Ersetzt durch Cloudflare-Function + Access-Login (R-11).

06 Pitfalls

Zum Aufklappen.

mcu-npm ist invalides Node-ESM

Extension-lose interne Imports → nacktes Node/esbuild scheitert, nur Vite/Rollup inlinen es. Deshalb existiert ein eigenes self-contained Bundle für rohe Worker-Consumer.

Seed-Round-Trip — bis zu 85/255 Abweichung

{hue,chroma} muss erst zu Color@tone50 und zurück zu HCT, bevor es eine TonalPalette treibt — sonst weicht Web trotz identischer mcu-Werte massiv ab. Der Golden-Test hat es gefunden, nicht Review.

M3-Text folgt nicht automatisch onSurface

Flutters Default-textTheme färbt aus der Typography-Tabelle (schwarz/weiß), nicht aus colorScheme.onSurface. Fix: textTheme.apply(bodyColor: scheme.onSurface, …).

Ein Shape-Corner hat keine Farbe

Highlight für Shapes läuft über Radius-Aufblähen (kostenlos) oder Kontur (Opt-in, braucht einen dormanten CSS-Hook) — nie beide Kosten gleichzeitig.

Tags sind Organisation, kein Zugriffsrecht

„App-getunt" heißt: Palette trägt den App-ID-Tag, kein Ordner. Schreibrechte laufen separat über das Lab-„acting as"-Modell.

07 Integration

Zwei Regeln tragen den ganzen Guide (voll: docs/INTEGRATION.md).

1 — Rolle, nie Hex
var(--n3-primary), nie ein Hex-Wert. Ändert sich die Palette, zieht alles nach.
2 — Paar-Regel
Jede onX-Rolle ist der garantiert lesbare Vordergrund zu X — nie Kontrast raten.

Stack-Wege

Flutter-App → n3_flutter nativ (PayMore, brokay)
Vite/Astro → @n3/web nativ (datada)
Roher Worker → self-contained Bundle (devhub)
Plugin/Release-Page → Rollout-Default

08 Arbeitsweise

Native-only: jeder Consumer zieht die Engine selbst, nie gebackene Hexe. Kann ein Stack das nicht direkt, gibt's einen wiederverwendbaren Adapter für alle — nie einen Einzelfall-Fix.

App-Aufgaben im App-Backlog: n3 liefert nur Doku, nie Aufgaben in fremde Repos. Ein zu eng ausgelegter Fall (trivialer Hook über mehrere Sessions gereicht) wurde korrigiert: Schnittstellen-Änderungen liefert die Owner-Session in einem Zug.

09 Auffälliges

Der Seed-Round-Trip-Fehler wäre bei reinem Review wohl durchgerutscht — erst der Golden-Test hat ihn gefangen.

Highlight ist als Debug-Hilfe entstanden, wirkt aber nebenbei wie ein Hardcode-Detektor.

Radius-Aufblähen (kostenlos) vs. Kontur (Opt-in) ist eine saubere API-Entscheidung — der Regelfall zahlt nicht für den Sonderfall.