aYOUne

Branding

aYOUne ist Whitelabel-fähig: Logo, Farben, Domain, Mail-Absender, Splash-Screen — alles passt sich pro Customer an. Dieser Guide zeigt dir, wo du was findest.

Branding-Quellen

Branding-Assets werden zentral auf cm.ayoune.app gehostet (Customer Media CDN). URL-Pattern:

Asset Pfad
Icon (Dark-Default) cm.ayoune.app/assets/images/icon/<slug>.png
Icon (Light) cm.ayoune.app/assets/images/icon-light/<slug>.png
Logo (Dark) cm.ayoune.app/assets/images/logo/<slug>.png
Logo (Light) cm.ayoune.app/assets/images/logo-light/<slug>.png
Hero cm.ayoune.app/<slug>/hero.jpg
Carrier-Logos cm.ayoune.app/carriers/<carrierslug>.svg

Der <slug> ist der Customer-Slug (aYOUneCustomers.slug — typischerweise eine kebab-case-Version des Firmennamens).

Asset-Upload

Per UI: admin-v2 → Settings → Branding → "Logo hochladen". Per CLI:

ay upload branding ./logo-dark.png  --kind logo
ay upload branding ./logo-light.png --kind logo-light
ay upload branding ./hero.jpg       --kind hero

Empfohlene Maße:

Asset Größe Format
Icon 512×512 PNG (transparent)
Logo 1200×300 PNG (transparent)
Hero 1920×640 JPG (qual 85)

Theme-Farben

Farben werden im aYOUneCustomers.theme-Feld als CSS-Variablen-Map gepflegt:

theme:
  primary: "#5b21b6"
  secondary: "#0ea5e9"
  accent: "#ec4899"
  bgLight: "#ffffff"
  bgDark: "#0f172a"
  textLight: "#0f172a"
  textDark: "#f8fafc"

Diese Variablen werden in mobile-app, admin-v2, consumer-app, auth und wallboard automatisch konsumiert. Änderungen sind durch Ngsw-Cache nach max. 5 Minuten live; harte Aktualisierung via Cmd/Ctrl + Shift + R.

Custom-Domain

Statt <slug>.ayoune.app kannst du eine eigene Domain ausrollen — z.B. app.firma.tld. Setup:

  1. CNAME auf apps.ayoune.app (oder Self-Hosted-Equivalent) zeigen
  2. In admin-v2 → Domains als verifiziert markieren
  3. domain-worker (Plattform-Service) provisioniert Let's-Encrypt-Cert + GKE-Ingress automatisch

Splash-Screen

Der Splash-Screen ist plattformweit frozen (siehe Release Notes). Du darfst nur den Tagline-Text anpassen:

<meta name="ay-tagline" content="Powered by Firma">

Farben, Sparkle-Positionen, SVG-Pfade und Timings sind plattformweit identisch — das schützt das Marken-Erlebnis bei White-Label-Kunden.

Mail-Absender

Im Mail-Template-Editor (Notifications) findest du from/replyTo. Für DKIM/SPF-Setup folge der Anleitung in Self-Hosting → Environment Variables.

Verbindungen