Communitygithub.com

coastdigitalgroup/coastai-skills

Ein systematisches Framework für nicht-überlagernde Benachrichtigungen, das globale Ankündigungen und kontextbezogene Inline-Alerts verwaltet, um Systemzustände zu kommunizieren, ohne den Benutzerfluss zu unterbrechen.

Was ist coastai-skills?

Das Banner- und Alertsystem bietet eine strukturierte Methode zur Gestaltung nicht-persistenter, nicht-überlagernder Kommunikationsschichten. Im Gegensatz zu Modals, die den Benutzer stoppen, liefern Banners und Alerts wichtige Informationen wie Statusaktualisierungen, Warnungen oder Ankündigungen und lassen den Benutzer gleichzeitig seine aktuelle Aufgabe fortsetzen. Das System ist für Entwickler und KI-Agenten gedacht, die klare Richtlinien für Nachrichtenschwere (Error, Warning, Success, Info), Platzierungsmuster (global, seitenbezogen, inline) und Interaktionsregeln benötigen. Es unterstützt plattformunabhängige Web-UI-Designs und stellt sicher, dass Benachrichtigungen visuell unterscheidbar, angemessen priorisiert und barrierefrei sind. Zu den Kernfunktionen gehören eine Entscheidungsmatrix zur Auswahl von Anzeigeort und visuellem Stil, Regeln zur Vermeidung von Layout-Verschiebungen und eine Barrierefreiheitsstrategie mit ARIA-Rollen. Dieses Skill eignet sich ideal für agente Systeme, die konsistente, nicht störende Benutzerfeedback-Mechanismen in Softwareanwendungen implementieren müssen.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/coastdigitalgroup/coastai-skills/tree/HEAD/website-design/banner-and-alert-system

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Banner- und Alertsystem

Zweck

Das Banner- und Alertsystem bietet eine Methodik zur Gestaltung nicht-persistenter, nicht-überlagernder Kommunikationsschichten. Im Gegensatz zu Modals, die den Benutzer stoppen, liefern Banners und Alerts kritische Informationen (Statusaktualisierungen, Warnungen oder Ankündigungen) und erlauben dem Benutzer gleichzeitig, seine aktuelle Aufgabe fortzusetzen. Dieses System stellt sicher, dass Benachrichtigungen visuell unterscheidbar, angemessen priorisiert und barrierefrei sind.

Anwendungsfälle

  • Kommunikation von seitenweiten Ankündigungen (z. B. „Geplante Wartung in 2 Stunden“).
  • Kontextbezogenes Feedback innerhalb eines Formulars (z. B. „Änderungen erfolgreich gespeichert“).
  • Warnung von Benutzern vor Kontoproblemen (z. B. „Abonnement läuft in 3 Tagen ab“).
  • Benachrichtigung von Benutzern über systemische Fehler, die die gesamte App nicht blockieren, aber die Funktionalität beeinträchtigen (z. B. „Bank-Synchronisierung ist derzeit nicht verfügbar“).
  • Anzeige von „Marketing-Bannern“ für Werbeaktionen oder die Einführung neuer Funktionen.

Wann NICHT verwendet werden

  • Kritische Blockaden: Wenn der Benutzer handeln muss, bevor er fortfahren kann, verwenden Sie overlay-and-dialog-system (Modal).
  • Passives Feedback: Für kurzlebige Statusaktualisierungen mit niedriger Priorität (z. B. „Link kopiert“) verwenden Sie Toasts (siehe overlay-and-dialog-system).
  • Datenkennzeichnungen: Für einfache Statusindikatoren an einem einzelnen Element verwenden Sie badge-and-tag-system.
  • Navigation: Verwenden Sie Banners nicht für primäre oder sekundäre Navigationslinks; verwenden Sie site-navigation-system.

Eingaben

  1. Nachrichtenschwere: Handelt es sich um eine Fehler-, Warn-, Erfolgs- oder Info-Nachricht?
  2. Umfang: Ist diese Global (seitenweit) oder Inline (spezifisch für einen Abschnitt/eine Seite)?
  3. Ausblendbarkeit: Kann der Benutzer diese Nachricht ausblenden, oder muss sie sichtbar bleiben?
  4. Aktionsanforderung: Erfordert die Nachricht eine Folgeaktion (z. B. „Abrechnung aktualisieren“)?
  5. Farbpalette der Marke: Standardfarben für Statuszustände (Gefahr rot, Warnung gelb usw.).

Ausgaben

  1. Spezifikation der Alarmstruktur: Definition von Symbol, Texthierarchie und Aktionsplatzierung.
  2. Räumliche Logik: Regeln, wo Banners erscheinen (Oberkante des Ansichtsfensters, Oberhalb des Inhalts oder Innerhalb eines Abschnitts).
  3. Zustandsmatrix: Visuelle Darstellungen für verschiedene Nachrichtenschweregrade.
  4. Barrierefreiheitsplan: ARIA-Rollen und Fokusmanagement-Regeln für interaktive Alerts.

Arbeitsablauf

1. Alarmstufe (Schwere) bestimmen

Weisen Sie basierend auf der Absicht einen Zustand zu:

  • Fehler (Hohe Priorität): Kritische Probleme, die Aufmerksamkeit erfordern, aber die Ansicht nicht unterbrechen.
  • Warnung (Mittlere Priorität): Potenzielle Probleme oder bevorstehende Fristen.
  • Erfolg (Niedrige Priorität): Bestätigung einer abgeschlossenen Aktion.
  • Info/Ankündigung: Neutrale Informationen oder Marketing-Updates.

2. Platzierungsmuster wählen

  • Globaler Banner (Oberleiste): Befindet sich ganz oben im Ansichtsfenster. Am besten geeignet für seitenweite Ankündigungen mit hoher Priorität.
  • Seitenbanner: Befindet sich unterhalb des globalen Headers, aber oberhalb des Seiteninhalts. Am besten geeignet für seitenbezogene Benachrichtigungen.
  • Inline-Alert: Befindet sich direkt innerhalb eines Abschnitts oder neben einer relevanten Komponente (z. B. innerhalb eines Formulars). Am besten geeignet für kontextbezogenes Feedback.

3. Komponentenstruktur entwerfen

Jeder Alert sollte einer konsistenten internen Hierarchie folgen:

  • Symbol: Eine visuelle Abkürzung für die Schwere (z. B. Häkchen für Erfolg).
  • Titel (Optional): Eine fette Überschrift für längere Alerts.
  • Beschreibung: Die Kernnachricht. Halten Sie sie kurz.
  • Aktion: Eine Schaltfläche oder ein Link für den nächsten Schritt.
  • Ausblendetrigger: Ein „X“-Button, wenn der Alert nicht kritisch ist.

4. Interaktionsregeln festlegen

  • Persistenz: Bestimmen Sie, ob der Alert nach einer Aktion, nach einer Zeitüberschreitung (nicht empfohlen für Banners) oder nur bei manuellem Schließen verschwindet.
  • Layout-Verschiebungsmanagement: Stellen Sie sicher, dass erscheinende Banners keine ruckartigen Layout-Verschiebungen (CLS) verursachen. Verwenden Sie reservierten Platz oder sanfte Übergänge.

5. Responsive Verhalten definieren

  • Stapelung: Auf Mobilgeräten sollten Aktionen unter den Text verschoben werden, wenn sie horizontal nicht passen.
  • Breite: Globale Banners haben volle Breite; Inline-Alerts folgen der Containerbreite.

Entscheidungsregeln

  • Die „Eins-nach-dem-anderen“-Regel: Stapeln Sie niemals mehr als zwei globale Banners. Wenn Sie mehrere Ankündigungen haben, fassen Sie diese in einem einzigen „Benachrichtigungscenter“ oder einem Schieberegler zusammen.
  • Farbe + Symbol: Verlassen Sie sich niemals allein auf Farbe, um den Alarmzustand zu kommunizieren. Fügen Sie immer ein Symbol für die Barrierefreiheit hinzu.
  • Platzierung nach Kontext: Wenn der Alert durch eine Benutzeraktion (z. B. Klicken auf „Speichern“) verursacht wird, platzieren Sie den Alert in der Nähe des Aktionspunkts (Inline). Handelt es sich um einen Systemzustand, platzieren Sie ihn oben (Global).
  • Ausblendlogik: Erlauben Sie Benutzern immer, „Info“- und „Erfolgs“-Banners auszublenden. „Fehler“- und „Warnungs“-Banners sollten nur ausgeblendet werden, wenn das zugrunde liegende Problem behoben ist.

Einschränkungen

  • Barrierefreiheit: Verwenden Sie role="alert" für Fehler mit hoher Priorität und role="status" für Aktualisierungen mit niedrigerer Priorität. Stellen Sie ein Kontrastverhältnis von 4,5:1 für Text sicher. Wenn ein globaler Banner fixiert/positioniert ist, überprüfen Sie, dass er niemals dauerhaft ein fokussiertes Element verdeckt, während der Inhalt scrollt (WCAG 2.2 SC 2.4.11).
  • Typografie: Verwenden Sie eine klare Schriftgröße (mindestens 14px) und vermeiden Sie Großbuchstaben für lange Beschreibungen.
  • Mobile Erreichbarkeit: Stellen Sie sicher, dass Ausblendschaltflächen der WCAG 2.2 SC 2.5.8 Mindestgröße von 24x24px entsprechen, bei Platzangebot auf 44x44px vergrößert.

Häufige Fehlermuster

  • Der „Ignorierbare Fehler“: Verwendung von „Info“-Stil für einen kritischen Fehler, wodurch der Benutzer wichtige Warnungen übersieht.
  • Aufdringliches Marketing: Verwendung globaler Banners für Werbeaktionen mit geringem Wert, die Benutzer verärgern und den „Alert“-Bereich entwerten.
  • Fehlende Aktionen: Dem Benutzer mitteilen, dass etwas falsch ist (z. B. „Zahlung fehlgeschlagen“), ohne einen direkten Link zur Behebung bereitzustellen.
  • Layout-Chaos: Banners, die „hereinspringen“ und den gesamten Seiteninhalt nach unten verschieben, wodurch Benutzer falsch klicken.

Validierungskriterien

  • Jeder Alert verwendet eine Symbol- und Farbkombination, die seiner Schwere entspricht.
  • Globale Banners sind an der Spitze der Hierarchie positioniert.
  • Inline-Alerts sind in unmittelbarer Nähe ihres zugehörigen Inhalts platziert.
  • Alle interaktiven Elemente (Schließen, CTA) erfüllen das WCAG 2.2 Mindestberührungsziel von 24x24px (2.5.8).
  • Alerts mit hoher Priorität verwenden geeignete ARIA-Rollen (alert).
  • Ausblendbare Banners merken sich ihren Zustand (oder haben eine Logik, wann sie wieder erscheinen sollen).

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for progressive disclosure using accordions, ensuring structural integrity, visual affordances, and accessibility across different content densities and devices.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for long-form content, managing readability, vertical rhythm, and information density to ensure a superior reading experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for informational elements that communicate state (Badges) and categorization (Tags) with clarity and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic, asymmetrical bento-grid layout framework to organize diverse content types cohesively while maintaining strict visual hierarchy, logical focus order, and responsive flexibility.

coastdigitalgroup/coastai-skills

Design a responsive, mobile-first bottom navigation bar and persistent action dock system for mobile websites and web applications, establishing spatial anchors, tab bar anatomy, badge indicators, thumb-zone ergonomics, safe area inset handling, active/inactive state contrast, and desktop responsive adaptation rules.

coastdigitalgroup/coastai-skills

Design a mobile-first bottom sheet overlay system with configurable detents, drag affordances, safe area padding, responsive desktop modal/popover adaptation, and WCAG AA accessibility compliance.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for secondary navigation trails that provide orientation, context, and one-click access to parent levels in deep information architectures.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for buttons and interactive triggers, managing visual hierarchy, variant logic, and action grouping to ensure clear intent and accessible interaction.

coastdigitalgroup/coastai-skills

Design a systematic framework for date and time selection, managing calendar grids, range pickers, and scheduling interfaces to ensure precision and accessibility.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for modular content containers that maintain hierarchy, structural integrity, and action alignment across variable content and responsive viewports.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for horizontal discovery components, managing navigation affordances, scroll behavior, and accessibility to ensure effective content density without compromising usability.

coastdigitalgroup/coastai-skills

Design a systematic, highly accessible, and developer-friendly UI layout framework for code blocks, snippet showcases, multi-file code tabs, line-highlighting, diff views, and syntax token contrast in technical documentation and developer platforms.

coastdigitalgroup/coastai-skills

Design a systematic framework for global command menus (Cmd+K panels) that combines keyboard-driven navigation, command execution, and shortcut discovery into an accessible, responsive overlay.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for threaded conversations, managing nesting depths, action hierarchies, and community signaling to foster engagement and readability.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for side-by-side comparison interfaces, managing high attribute density and responsive complexity to support informed decision-making.

coastdigitalgroup/coastai-skills

Design and implement a systematic framework for user privacy, managing consent banners, preference centers, and persistent privacy controls to balance legal compliance with user trust.

coastdigitalgroup/coastai-skills

Design and implement a systematic, highly accessible, and responsive visual layout framework for conversational chat widgets, live chat boxes, and chatbot panels that ensures clear message scannability, native focus flow, and seamless mobile keyboard adaptation.

coastdigitalgroup/coastai-skills

Design a systematic, accessible, and high-conversion framework for custom select dropdowns and comboboxes, defining anatomy, states, search-filtering, and responsive mobile-adaptive patterns.

coastdigitalgroup/coastai-skills

Design and specify a systematic dark theme framework, establishing rules for elevation-based surface colors, desaturated brand accents, text legibility, and media adaptation to ensure an accessible, low-fatigue experience.

coastdigitalgroup/coastai-skills

Design and implement a systematic color palette that ensures WCAG 2.2 accessibility compliance. Trigger this skill when asked to define brand colors, create UI themes, or establish a visual system for a website.

Verwandte Skills