Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

react-component-dev

/react-component-dev

Prowadzi tworzenie komponentów, formularzy i modali React z Tailwind CSS i hookami w projekcie Gemini-Subtitle-Pro.

Repozytorium
MioSub ↗
Licencja
AGPL-3.0
Ostatnia zmiana repozytorium
20.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
5
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 20.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

AGPL-3.0, copyleft: przeróbki udostępniane innym muszą mieć tę samą licencję.

Co robi i kiedy

Prowadzi tworzenie komponentów, formularzy i modali React z Tailwind CSS i hookami w projekcie Gemini-Subtitle-Pro.

Oryginalny opis (EN)

React/TypeScript component development guidelines for Gemini-Subtitle-Pro. Use when creating components, pages, modals, forms, or working with TailwindCSS, hooks, and React 19 patterns. Covers component architecture, styling with Tailwind, state management, performance optimization, and accessibility.

Jak działa

  1. Purpose
  2. When to Use This Skill
  3. Quick Start
  4. Component Architecture
  5. Core Principles
  6. Resource Files
Sekcje z nagłówków SKILL.md, w oryginale · 123 linii, 383 słów
Podgląd SKILL.md
---
name: react-component-dev
description: React/TypeScript component development guidelines for Gemini-Subtitle-Pro. Use when creating components, pages, modals, forms, or working with TailwindCSS, hooks, and React 19 patterns. Covers component architecture, styling with Tailwind, state management, performance optimization, and accessibility.
---

# React Component Development Guidelines

## Purpose

Establish consistency and best practices for React components in Gemini-Subtitle-Pro using React 19, TypeScript 5.8, and TailwindCSS 4.

## When to Use This Skill

Automatically activates when working on:

- Creating or modifying React components
- Building pages, modals, dialogs, forms
- Styling with TailwindCSS
- Working with React hooks
- Implementing state management
- Performance optimization

---

## Quick Start

### New Component Checklist

- [ ] **Location**: Place in `src/components/[feature]/`
- [ ] **TypeScript**: Define proper props interface
- [ ] **Styling**: Use TailwindCSS with `clsx` and `tw-merge`
- [ ] **Path Aliases**: Use `@components/*`, `@hooks/*`, etc.
- [ ] **State**: Use appropriate state pattern (local, context, etc.)
- [ ] **i18n**: Use `useTranslation` for all user-facing text

---

## Component Architecture

### File Organization

```
src/components/
├── common/              # Shared components (Button, Modal, etc.)
├── layout/              # Layout components (Header, Sidebar, etc.)
├── subtitle/            # Subtitle-related components
├── settings/            # Settings components
├── workspace/           # Workspace components
└── [feature]/           # Feature-specific components
```

### Naming Conventions

- **Components**: `PascalCase` - `SubtitleEditor.tsx`
- **Hooks**: `camelCase` with `use` prefix - `useSubtitleParser.ts`
- **Utils**: `camelCase` - `formatTimestamp.ts`

---

## Core Principles

### 1. Always Use Path Aliases

```typescript
// ❌ NEVER: Relative paths
import { Button } from '../../components/common/Button';

// ✅ ALWAYS: Path aliases
import { Button } from '@components/common/Button';
import { useWorkspace } from '@hooks/useWorkspace';
import { SubtitleEntry } from '@types/subtitle';
```

### 2. Define Props Interface

```typescript
// ✅ ALWAYS: Clear prop types
interface SubtitleEditorProps {
  entries: SubtitleEntry[];
  onUpdate: (index: number, entry: SubtitleEntry) => void;
  isReadOnly?: boolean;
}

export function SubtitleEditor({ entries, onUpdate, isReadOnly = false }: SubtitleEditorProps) {
  // ...
}
```

### 3. Use TailwindCSS with clsx

```typescript
import { clsx } from 'clsx';
import { twMerge } from 'tailwind-merge';

// ✅ Conditional classes
<div className={twMerge(clsx(
  'rounded-lg p-4',
  isActive && 'bg-blue-500 text-white',
  isDisabled && 'opacity-50 cursor-not-allowed'
))}>
```

### 4. Use i18n for All Text

```typescript
import { useTranslation } from 'react-i18next';

export function SettingsPanel() {
  const { t } = useTranslation();

  return (
    <h1>{t('settings.title')}</h1>
  );
}
```

---

## Resource Files

For detailed guidelines, see the resources directory:

- [component-patterns.md](resources/component-patterns.md) - Component design patterns
- [styling-guide.md](resources/styling-guide.md) - TailwindCSS styling patterns
- [hooks-patterns.md](resources/hooks-patterns.md) - Custom hooks patterns
- [performance.md](resources/performance.md) - Performance optimization
Pliki w paczce (5)
  • SKILL.md 3 KB
  • resources/component-patterns.md 2 KB
  • resources/hooks-patterns.md 3 KB
  • resources/performance.md 3 KB
  • resources/styling-guide.md 2 KB

Wersje

W bazie nie ma innych skilli o nazwie react-component-dev.

Identyczna treść występuje jeszcze w 4 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 463fd8addc9a (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100react-frontend-patterns
    Przegląda i buduje komponenty React 19 z Tailwind CSS i shadcn/ui, z naciskiem na dostępność, formularze i stan aplikacji.
  • 90react-component
    Generuje gotowe do produkcji komponenty React i TypeScript ze stylami Tailwind CSS i dostępnymi interakcjami w projektach React lub Next.js.
  • 100react-component-guidelines
    Dostarcza wytyczne pisania komponentów React przy tworzeniu nowego komponentu.
  • 100react-component-generator
    Generuje komponenty React z TypeScript, właściwymi propsami, hookami i dostępnością, także przy refaktoryzacji istniejących komponentów.
  • 100react-code-review
    Przegląda kod aplikacji React: architekturę komponentów, użycie hooków, wzorce React 19, zarządzanie stanem, wydajność, dostępność i integrację z TypeScript.
  • 100frontend-react
    Wspiera tworzenie aplikacji React z Next.js, React Server Components, Tailwind CSS i shadcn/ui oraz złożonym zarządzaniem stanem.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.