Communitygithub.com

ComeOnOliver/skillshub

Normes de codage frontend, modèles de composants et système de conception pour l'interface Angular Guessimate. À utiliser lors de l'écriture ou de la révision de code frontend.

Qu'est-ce que skillshub ?

Ce skill définit les normes de codage, les modèles architecturaux et le système de conception pour l'interface utilisateur Angular de Guessimate. Il est destiné aux développeurs travaillant sur le frontend de cette application, leur fournissant des directives claires sur la structure du projet, les conventions de nommage, l'utilisation de composants autonomes, la gestion d'état avec Angular Signals et RxJS, ainsi que le système de design basé sur Tailwind CSS 4. Le skill détaille également la palette de couleurs sémantiques, les règles d'utilisation des classes utilitaires, et des modèles de composants courants comme les cartes et les en-têtes typographiques. En suivant ces conventions, les développeurs peuvent assurer une cohérence visuelle et technique dans l'ensemble de l'application, facilitant la maintenance et l'évolution du code. Ce skill est conçu pour être utilisé avec des agents comme Claude Code, Cursor ou Codex afin d'offrir des conseils contextuels lors de l'écriture ou de la révision de code frontend Angular.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Guide de style frontend et conventions de codage

Ce document définit les normes de codage, les modèles architecturaux et le système de conception pour l'interface Angular Guessimate.

1. Pile technologique

  • Framework : Angular 20+
  • Styling : Tailwind CSS 4
  • Gestion d'état : Angular Signals et RxJS
  • Système de build : Angular CLI (Esbuild)

2. Structure du projet

Nous suivons une structure de répertoires basée sur les fonctionnalités. Le code est organisé par domaine fonctionnel plutôt que par type technique.

src/app/
├── core/            # Singletons globaux (Guards, Intercepteurs, Services globaux)
├── layout/          # Composants de mise en page (Navigation, Pied de page, Shell)
├── features/        # Modules fonctionnels (Logique métier)
│   ├── home/
│   ├── session/
│   │   ├── components/  # Composants muets/présentation
│   │   ├── pages/       # Composants intelligents/conteneurs (routés)
│   │   ├── services/    # État/logique propre à la fonctionnalité
│   │   └── models/      # Types propres à la fonctionnalité
│   └── ...
├── websocket/       # Infrastructure WebSocket
└── shared/          # Utilitaires partagés (Pipes, Directives, UI générique)

Conventions de nommage

  • Fichiers : kebab-case (ex. session-page.component.ts, auth.service.ts).
  • Classes : PascalCase (ex. SessionPageComponent, AuthService).
  • Sélecteurs : préfixe app-, kebab-case (ex. app-user-profile).
  • Signals : pas de suffixe, nom descriptif nom/verbe (ex. user(), isLoading()).
  • Observables : suffixe $ (ex. user$).

3. Normes des composants

Définition

  • Utiliser des composants autonomes (standalone: true est la valeur par défaut dans v19+).
  • Préférer les modèles en ligne pour la plupart des composants afin de garder la logique et la vue colocalisées.
  • Éviter les fichiers CSS externes ; utiliser les classes utilitaires Tailwind CSS directement dans le modèle.

@Component({
    selector: 'app-exemple',
    imports: [CommonModule, RouterLink], // Importations explicites
    template: `
    <div class="p-4 bg-surface-100 rounded-lg">
      <h1 class="text-2xl font-bold text-gray-900">{{ titre() }}</h1>
    </div>
  `
})
export class ExempleComponent {
    titre = signal('Bonjour le monde');
}

Flux de contrôle

Utiliser la nouvelle syntaxe de flux de contrôle intégrée d'Angular.

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

Injection de dépendances

Préférer la fonction inject() à l'injection par constructeur pour une meilleure inférence de type et un code plus propre.

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

// À éviter si possible
constructor(private
route: ActivatedRoute
)
{
}

4. Gestion d'état

  • État local : Utiliser signal() pour l'état primitif.
  • État partagé : Utiliser les Signal Stores (Services utilisant Signals) fournis au niveau approprié (Racine ou Composant).
  • Données réactives : Utiliser computed() pour l'état dérivé et effect() avec parcimonie pour les effets de bord.

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

    // Sélecteurs
    readonly lobby = computed(() => this._state().lobby);
    readonly connexion = computed(() => this._state().connection);

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

5. Styling et système de conception

Nous utilisons Tailwind CSS 4 avec une palette de couleurs sémantiques définie dans styles.css.

Règles d'utilisation

  1. Utility-First : Écrire les classes directement dans le HTML.
  2. Pas de nombres magiques : Utiliser les valeurs du thème (ex. p-4 pas p-[16px]).
  3. Mode sombre : Utiliser le modificateur dark: pour toutes les classes liées aux couleurs.

Palette de couleurs

L'application utilise une convention de nommage sémantique mappée aux couleurs Tailwind.

Couleurs principales

CatégorieNom sémantiqueMode clairMode sombreUtilisation
Arrière-planbackgroundgray-50gray-950Arrière-plan principal de l'application
Surfacesurfacewhitegray-900Cartes, modales, sections
Surface Altsurface-altgray-100gray-800Arrière-plans secondaires, champs de saisie
Primairebrandblue-600blue-600Actions principales, boutons, mises en avant
Primaire Atténuébrand-mutedblue-50blue-900/30États sélectionnés, surbrillances légères
Succèssuccessemerald-500emerald-600États de succès, confirmation
Succès Atténuésuccess-mutedemerald-50emerald-900/30Arrière-plans de succès
Dangerdangerred-600red-600Erreurs, actions destructrices
Danger Atténuédanger-mutedred-50red-900/30Arrière-plans d'erreur
Avertissementwarningamber-500amber-600Avertissements, états en attente
Avertiss. Atténuéwarning-mutedamber-50amber-900/30Arrière-plans d'avertissement

Typographie et bordures

CatégorieMode clairMode sombreUtilisation
Primairegray-900whiteTitres principaux et texte du corps
Secondairegray-500gray-400Sous-titres, étiquettes, info secondaire
Atténuégray-400gray-500Texte désactivé, espaces réservés
Borduregray-200gray-800Séparateurs standard et bordures de cartes

Implémentation dans styles.css

Les couleurs sont définies à l'aide de variables CSS dans le bloc @theme :

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

6. Modèles de composants courants

Cartes et conteneurs

Style standard pour les conteneurs de contenu (comme les cartes d'estimation, listes) :


<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">
    <!-- Contenu -->
</div>
  • Arrière-plan : bg-surface-100/60 (Clair) / dark:bg-gray-900/40 (Sombre)
  • Bordure : border border-surface-200 (Clair) / dark:border-gray-800/60 (Sombre)
  • Arrondi : rounded-md (Standard)
  • Séparateurs : divide-y divide-surface-300 dark:divide-gray-800

En-têtes typographiques


<div class="flex flex-col gap-1">
    <h2 class="text-2xl font-semibold leading-none text-gray-900 dark:text-white">Titre</h2>
    <span class="text-sm font-normal text-gray-600 dark:text-gray-400">Description du sous-titre</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

Skills associés