Communitygithub.com

ComeOnOliver/skillshub

Frontend-Codestandards, Komponentenmuster und Designsystem für die Guessimate Angular-UI. Referenz beim Schreiben oder Reviewen von Frontend-Code.

Was ist skillshub?

Der Skill „ComeOnOliver/skillshub“ beschreibt die umfassende Frontend-Entwicklungsrichtlinie für die Guessimate Angular-Anwendung. Er definiert einheitliche Codestandards, Architekturmuster und das gesamte Designsystem, das auf Angular 20+, Tailwind CSS 4 und moderner Zustandsverwaltung mit Angular Signals und RxJS basiert. Die Anleitung gibt klare Vorgaben zur projektstruktur (feature-basiert), zu Komponentenstandards (Standalone-Komponenten, Inline-Templates, Tailwind-Utility-First-Ansatz) und zur korrekten Verwendung von Kontrollfluss-Syntax und Dependency Injection. Zusätzlich wird ein umfangreiches semantisches Farbschema beschrieben, das mit CSS-Variablen in `styles.css` umgesetzt wird, sowie typische Komponentenmuster wie Karten und Typografie-Header. Entwickler, die den Code schreiben oder reviewen, können sich schnell über die Konventionen informieren und sicherstellen, dass der Code konsistent und wartbar ist. Der Skill ist speziell für die Guessimate Angular-UI konzipiert, aber die Prinzipien sind auf andere Angular-Projekte übertragbar.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/davidopdebeeck/ui-style-guide

In Ihrer bevorzugten KI fragen

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

Dokumentation

Frontend Style Guide & Coding Conventions (Übersetzung)

Dieses Dokument definiert die Codestandards, Architekturmuster und das Designsystem für die Guessimate Angular-Frontend-Anwendung.

1. Technologie-Stack

  • Framework: Angular 20+
  • Styling: Tailwind CSS 4
  • Zustandsverwaltung: Angular Signals & RxJS
  • Build-System: Angular CLI (Esbuild)

2. Projektstruktur

Wir folgen einem Feature-basierten Verzeichnisaufbau. Der Code wird nach Domänenfunktionen (Features) statt nach technischen Typen organisiert.

src/app/
├── core/            # Globale Singletons (Guards, Interceptors, globale Services)
├── layout/          # Layout-Komponenten (Navigation, Footer, Shell)
├── features/        # Feature-Module (Domänenlogik)
│   ├── home/
│   ├── session/
│   │   ├── components/  # Dumme/Präsentationskomponenten
│   │   ├── pages/       # Smart/Container-Komponenten (geroutet)
│   │   ├── services/    # Featurspezifische Zustandsverwaltung/Logik
│   │   └── models/      # Featurspezifische Typen
│   └── ...
├── websocket/       # WebSocket-Infrastruktur
└── shared/          # Gemeinsam genutzte Hilfsmittel (Pipes, Directives, generische UI)

Namenskonventionen

  • Dateien: Kebab-Case (z.B. session-page.component.ts, auth.service.ts).
  • Klassen: PascalCase (z.B. SessionPageComponent, AuthService).
  • Selektoren: app--Präfix, Kebab-Case (z.B. app-user-profile).
  • Signals: Kein Suffix, beschreibendes Nomen/Verb (z.B. user(), isLoading()).
  • Observables: $-Suffix (z.B. user$).

3. Komponentenstandards

Definition

  • Verwende Standalone-Komponenten (ab v19 ist standalone: true Standard).
  • Bevorzuge Inline-Templates für die meisten Komponenten, um Logik und Ansicht beieinander zu halten.
  • Vermeide externe CSS-Dateien; verwende direkt Tailwind CSS-Utility-Klassen im Template.

@Component({
    selector: 'app-example',
    imports: [CommonModule, RouterLink], // Explizite Imports
    template: `
    <div class="p-4 bg-surface-100 rounded-lg">
      <h1 class="text-2xl font-bold text-gray-900">{{ title() }}</h1>
    </div>
  `
})
export class ExampleComponent {
    title = signal('Hello World');
}

Kontrollfluss

Verwende die neue eingebaute Angular-Control-Flow-Syntax.

<!-- Gut -->
@if (isLoading()) {
<app-spinner/>
} @else {
@for (item of items(); track item.id) {
<app-item [data]="item"/>
}
}

Abhängigkeitsinjektion

Bevorzuge die inject()-Funktion gegenüber der Konstruktorinjektion, um bessere Typinferenz und saubereren Code zu erhalten.

// Gut
private readonly
route = inject(ActivatedRoute);
private readonly
store = inject(SessionStore);

// Vermeiden, wenn möglich
constructor(private
route: ActivatedRoute
)
{
}

4. Zustandsverwaltung

  • Lokaler Zustand: Verwende signal() für primitive Zustände.
  • Geteilter Zustand: Verwende Signal Stores (Services, die Signals verwenden), die auf der entsprechenden Ebene (Root oder Komponente) bereitgestellt werden.
  • Reaktive Daten: Verwende computed() für abgeleitete Zustände und effect() sparsam für Seiteneffekte.

@Injectable()
export class SessionStore {
    // Zustand
    private readonly _state = signal<SessionState>(initialState);

    // Selektoren
    readonly lobby = computed(() => this._state().lobby);
    readonly connection = computed(() => this._state().connection);

    // Aktionen
    setLobby(lobby: Lobby) {
        this._state.update(s => ({...s, lobby}));
    }
}

5. Styling & Designsystem

Wir verwenden Tailwind CSS 4 mit einer semantischen Farbpalette, die in styles.css definiert ist.

Nutzungsregeln

  1. Utility-First: Schreibe Klassen direkt in HTML.
  2. Keine magischen Zahlen: Verwende Themenwerte (z.B. p-4, nicht p-[16px]).
  3. Dark Mode: Verwende den Modifikator dark: für alle farbbezogenen Klassen.

Farbpalette

Die Anwendung verwendet eine semantische Benennungskonvention, die auf Tailwind-Farben abgebildet wird.

Kernfarben

KategorieSemantischer NameHeller ModusDunkler ModusVerwendung
Hintergrundbackgroundgray-50gray-950Hauptanwendungshintergrund
Oberflächesurfacewhitegray-900Karten, Modale, Abschnitte
Oberfläche Altsurface-altgray-100gray-800Sekundäre Hintergründe, Eingabefelder
Primärbrandblue-600blue-600Primäre Aktionen, Buttons, Hervorhebungen
Primär dezentbrand-mutedblue-50blue-900/30Ausgewählte Zustände, dezente Hervorhebungen
Erfolgsuccessemerald-500emerald-600Erfolgszustände, Bestätigungen
Erfolg dezentsuccess-mutedemerald-50emerald-900/30Erfolgshintergründe
Gefahrdangerred-600red-600Fehler, destruktive Aktionen
Gefahr dezentdanger-mutedred-50red-900/30Fehlerhintergründe
Warnungwarningamber-500amber-600Warnungen, ausstehende Zustände
Warnung dezentwarning-mutedamber-50amber-900/30Warnungshintergründe

Typografie & Rahmen

KategorieHeller ModusDunkler ModusVerwendung
Primärgray-900whiteHauptüberschriften und Fließtext
Sekundärgray-500gray-400Untertitel, Labels, sekundäre Info
Dezentgray-400gray-500Deaktivierter Text, Platzhalter
Rahmengray-200gray-800Standardtrennlinien und Kartenrahmen

Umsetzung in styles.css

Farben werden mit CSS-Variablen im @theme-Block definiert:

@theme {
    --color-brand-600: var(--color-blue-600);
    --color-surface-100: var(--color-stone-100);
    /* ... */
}

6. Häufige Komponentenmuster

Karten & Container

Standardstyling für Inhaltscontainer (z.B. Schätzkarten, Listen):


<div class="flex flex-col bg-surface-100/60 border border-surface-200 dark:bg-gray-900/40 dark:border-gray-800/60 rounded-md shadow-sm">
    <!-- Inhalt -->
</div>
  • Hintergrund: bg-surface-100/60 (Hell) / dark:bg-gray-900/40 (Dunkel)
  • Rahmen: border border-surface-200 (Hell) / dark:border-gray-800/60 (Dunkel)
  • Abrundung: rounded-md (Standard)
  • Trennlinien: divide-y divide-surface-300 dark:divide-gray-800

Typografie-Überschriften


<div class="flex flex-col gap-1">
    <h2 class="text-2xl font-semibold leading-none text-gray-900 dark:text-white">Titel</h2>
    <span class="text-sm font-normal text-gray-600 dark:text-gray-400">Untertitel Beschreibung</span>
</div>

Individual skills in this repo

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

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Verwandte Skills