Communitygithub.com

ComeOnOliver/skillshub

Guessimate Angular UI의 프론트엔드 코딩 표준, 컴포넌트 패턴 및 디자인 시스템을 정의합니다. 프론트엔드 코드 작성 또는 리뷰 시 참조하세요.

skillshub란 무엇인가요?

이 스킬은 Guessimate Angular 프론트엔드 개발을 위한 포괄적인 코딩 표준, 아키텍처 패턴 및 디자인 시스템을 제공합니다. Angular 20+, Tailwind CSS 4, Angular Signals 및 RxJS를 기반으로 하는 기술 스택을 사용합니다. 기능 기반 디렉토리 구조를 따르며, 독립형 컴포넌트, 명시적 임포트, 새로운 Angular 제어 흐름 구문 사용을 권장합니다. 상태 관리는 로컬 상태에 `signal()`, 공유 상태에 Signal Store를 사용하고, 파생 상태에 `computed()`, 부수 효과에 `effect()`를 제한적으로 사용합니다. 디자인 시스템은 의미론적 색상 팔레트와 유틸리티 우선 Tailwind CSS 접근 방식을 정의하여 일관된 UI와 다크 모드 지원을 보장합니다. 이 스킬은 Cursor, Claude Code, Codex와 같은 AI 에이전트가 Guessimate 프로젝트에서 프론트엔드 코드를 작성하거나 리뷰할 때 지침을 제공합니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

프론트엔드 스타일 가이드 및 코딩 규칙

이 문서는 Guessimate Angular 프론트엔드의 코딩 표준, 아키텍처 패턴 및 디자인 시스템을 정의합니다.

1. 기술 스택

  • 프레임워크: Angular 20+
  • 스타일링: Tailwind CSS 4
  • 상태 관리: Angular Signals 및 RxJS
  • 빌드 시스템: Angular CLI (Esbuild)

2. 프로젝트 구조

기능 기반(Feature-Based) 디렉토리 구조를 따릅니다. 코드는 기술 유형이 아닌 도메인 기능별로 구성됩니다.

src/app/
├── core/            # 전역 싱글톤 (가드, 인터셉터, 전역 서비스)
├── layout/          # 레이아웃 컴포넌트 (내비게이션, 푸터, 쉘)
├── features/        # 기능 모듈 (도메인 로직)
│   ├── home/
│   ├── session/
│   │   ├── components/  # 멍청한/프레젠테이션 컴포넌트
│   │   ├── pages/       # 스마트/컨테이너 컴포넌트 (라우팅됨)
│   │   ├── services/    # 기능별 상태/로직
│   │   └── models/      # 기능별 타입
│   └── ...
├── websocket/       # WebSocket 인프라
└── shared/          # 공유 유틸리티 (파이프, 디렉티브, 일반 UI)

명명 규칙

  • 파일: 케밥 케이스 (예: session-page.component.ts, auth.service.ts).
  • 클래스: 파스칼 케이스 (예: SessionPageComponent, AuthService).
  • 선택자: app- 접두사, 케밥 케이스 (예: app-user-profile).
  • 시그널: 접미사 없음, 설명적인 명사/동사 (예: user(), isLoading()).
  • 옵저버블: $ 접미사 (예: user$).

3. 컴포넌트 표준

정의

  • 독립형 컴포넌트(Standalone Components) 사용 (standalone: true는 v19+에서 기본값).
  • 대부분의 컴포넌트에 인라인 템플릿(Inline Templates) 을 선호하여 로직과 뷰를 함께 배치합니다.
  • 외부 CSS 파일을 피하고 템플릿에서 직접 Tailwind CSS 유틸리티 클래스를 사용합니다.

@Component({
    selector: 'app-example',
    imports: [CommonModule, RouterLink], // 명시적 임포트
    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');
}

제어 흐름

새로운 내장 Angular 제어 흐름 구문을 사용합니다.

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

의존성 주입

더 나은 타입 추론과 깔끔한 코드를 위해 생성자 주입보다 inject() 함수를 선호합니다.

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

// 가능하면 피할 것
constructor(private
route: ActivatedRoute
)
{
}

4. 상태 관리

  • 로컬 상태: 기본 상태에 signal() 사용.
  • 공유 상태: 적절한 수준(루트 또는 컴포넌트)에서 제공되는 Signal Store(시그널을 사용하는 서비스) 사용.
  • 반응형 데이터: 파생 상태에 computed() 사용, 부수 효과는 effect()를 제한적으로 사용.

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

    // 선택자
    readonly lobby = computed(() => this._state().lobby);
    readonly connection = computed(() => this._state().connection);

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

5. 스타일링 및 디자인 시스템

Tailwind CSS 4를 사용하며 styles.css에 정의된 의미론적 색상 팔레트를 사용합니다.

사용 규칙

  1. 유틸리티 우선: HTML에 직접 클래스를 작성합니다.
  2. 매직 넘버 금지: 테마 값 사용 (예: p-[16px] 대신 p-4).
  3. 다크 모드: 모든 색상 관련 클래스에 dark: 수정자를 사용합니다.

색상 팔레트

애플리케이션은 Tailwind 색상에 매핑된 의미론적 명명 규칙을 사용합니다.

핵심 색상

카테고리의미론적 이름라이트 모드다크 모드용도
배경backgroundgray-50gray-950주요 애플리케이션 배경
표면surfacewhitegray-900카드, 모달, 섹션
대체 표면surface-altgray-100gray-800보조 배경, 입력 필드
기본/브랜드brandblue-600blue-600주요 동작, 버튼, 하이라이트
기본/브랜드 흐림brand-mutedblue-50blue-900/30선택된 상태, 약한 하이라이트
성공successemerald-500emerald-600성공 상태, 확인
성공 흐림success-mutedemerald-50emerald-900/30성공 배경
위험dangerred-600red-600오류, 파괴적 동작
위험 흐림danger-mutedred-50red-900/30오류 배경
경고warningamber-500amber-600경고, 보류 상태
경고 흐림warning-mutedamber-50amber-900/30경고 배경

타이포그래피 및 테두리

카테고리라이트 모드다크 모드용도
기본gray-900white주요 제목 및 본문 텍스트
보조gray-500gray-400부제목, 레이블, 보조 정보
흐림gray-400gray-500비활성화된 텍스트, 플레이스홀더
테두리gray-200gray-800표준 구분선 및 카드 테두리

styles.css에서의 구현

색상은 @theme 블록 내에서 CSS 변수를 사용하여 정의됩니다:

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

6. 일반 컴포넌트 패턴

카드 및 컨테이너

콘텐츠 컨테이너(예: 추정 카드, 목록)의 표준 스타일:


<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">
    <!-- 내용 -->
</div>
  • 배경: bg-surface-100/60 (라이트) / dark:bg-gray-900/40 (다크)
  • 테두리: border border-surface-200 (라이트) / dark:border-gray-800/60 (다크)
  • 둥글기: rounded-md (표준)
  • 구분선: divide-y divide-surface-300 dark:divide-gray-800

타이포그래피 헤더


<div class="flex flex-col gap-1">
    <h2 class="text-2xl font-semibold leading-none text-gray-900 dark:text-white">제목</h2>
    <span class="text-sm font-normal text-gray-600 dark:text-gray-400">부제목 설명</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

관련 스킬