Skip to content

notque/vexjoy-agent / skills/frontend/frontend

frontend

Unverified

Frontend: UI design, distinctive visual styles, HTML artifacts, Three.js 3D, TypeScript/React/Next.js apps, e-commerce, portfolios, React Native, web performance.

FileKindSize
SKILL.mdskill md22.5 KB
SPEC.mdmarkdown4.3 KB
agents/html-builder.mdmarkdown5.9 KB
assets/base-template.htmlother495 B
references/design-refs/accessibility-review.mdmarkdown13.0 KB
references/design-refs/design-critique.mdmarkdown10.4 KB
references/design-refs/design-handoff.mdmarkdown9.9 KB
references/design-refs/design-systems.mdmarkdown9.3 KB
references/design-refs/llm-design-failure-modes.mdmarkdown9.1 KB
references/design-refs/ux-copy.mdmarkdown9.5 KB
references/distinctive-frontend-design-refs/animation-patterns.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/background-techniques.mdmarkdown10.5 KB
references/distinctive-frontend-design-refs/balatro-shader-breakdown.mdmarkdown14.9 KB
references/distinctive-frontend-design-refs/card-shader-patterns.mdmarkdown10.9 KB
references/distinctive-frontend-design-refs/color-inspirations.jsonconfig9.4 KB
references/distinctive-frontend-design-refs/css-audit-patterns.mdmarkdown4.7 KB
references/distinctive-frontend-design-refs/font-catalog.jsonconfig9.7 KB
references/distinctive-frontend-design-refs/game-ui-polish.mdmarkdown6.3 KB
references/distinctive-frontend-design-refs/honest-placeholders.mdmarkdown3.2 KB
references/distinctive-frontend-design-refs/implementation-examples.mdmarkdown7.7 KB
references/distinctive-frontend-design-refs/macrostructure-catalog.mdmarkdown9.3 KB
references/distinctive-frontend-design-refs/oklch-color-harmony.mdmarkdown7.3 KB
references/distinctive-frontend-design-refs/performance-budgets.mdmarkdown10.6 KB
references/distinctive-frontend-design-refs/phase-details.mdmarkdown4.8 KB
references/distinctive-frontend-design-refs/pptx-conversion.mdmarkdown9.7 KB
references/distinctive-frontend-design-refs/roll-text.mdmarkdown7.2 KB
references/distinctive-frontend-design-refs/shader-integration-react.mdmarkdown16.7 KB
references/distinctive-frontend-design-refs/slide-controller.mdmarkdown9.4 KB
references/distinctive-frontend-design-refs/text-animation-patterns.mdmarkdown4.3 KB
references/html-artifact-refs/design-system.mdmarkdown10.2 KB
references/html-artifact-refs/diagram-layering.mdmarkdown3.9 KB
references/html-artifact-refs/infographic-layouts.mdmarkdown4.9 KB
references/html-artifact-refs/pdf-export.mdmarkdown6.0 KB
references/html-artifact-refs/pptx-export.mdmarkdown10.2 KB
references/html-artifact-refs/shape-diagram-illustration.mdmarkdown4.3 KB
references/nextjs-ecommerce.mdmarkdown3.4 KB
references/nextjs-ecommerce/admin-dashboard.mdmarkdown9.8 KB
references/nextjs-ecommerce/error-catalog.mdmarkdown7.9 KB
references/nextjs-ecommerce/expertise.mdmarkdown5.1 KB
references/nextjs-ecommerce/patterns-and-errors.mdmarkdown4.6 KB
references/nextjs-ecommerce/preferred-patterns.mdmarkdown8.0 KB
references/nextjs-ecommerce/shopping-cart-patterns.mdmarkdown7.7 KB
references/nextjs-ecommerce/stripe-integration.mdmarkdown9.5 KB
references/performance-optimization.mdmarkdown9.9 KB
references/performance-optimization/browser-dom-optimizations.mdmarkdown6.0 KB
references/performance-optimization/bundle-optimization.mdmarkdown7.9 KB
references/performance-optimization/core-web-vitals.mdmarkdown9.6 KB
references/performance-optimization/js-algorithm-optimizations.mdmarkdown9.6 KB
references/performance-optimization/metrics-and-monitoring.mdmarkdown8.8 KB
references/performance-optimization/nextjs-optimization.mdmarkdown10.6 KB
references/performance-optimization/performance-testing.mdmarkdown9.6 KB
references/performance-optimization/preferred-patterns.mdmarkdown7.4 KB
references/performance-optimization/react-async-patterns.mdmarkdown7.0 KB
references/performance-optimization/react-bundle-optimization.mdmarkdown6.3 KB
references/performance-optimization/react-rendering-performance.mdmarkdown12.0 KB
references/react-native.mdmarkdown4.4 KB
references/react-native/animation-patterns.mdmarkdown3.9 KB
references/react-native/error-handling.mdmarkdown7.7 KB
references/react-native/list-performance.mdmarkdown5.4 KB
references/react-native/monorepo-config.mdmarkdown2.3 KB
references/react-native/navigation-patterns.mdmarkdown2.0 KB
references/react-native/rendering-patterns.mdmarkdown3.2 KB
references/react-native/state-management.mdmarkdown3.3 KB
references/react-native/testing.mdmarkdown6.2 KB
references/react-native/ui-patterns.mdmarkdown5.0 KB
references/react-portfolio.mdmarkdown7.7 KB
references/react-portfolio/gallery-patterns.mdmarkdown2.5 KB
references/react-portfolio/image-optimization.mdmarkdown3.4 KB
references/react-portfolio/lightbox-patterns.mdmarkdown6.1 KB
references/react-portfolio/nextjs-app-router.mdmarkdown4.9 KB
references/react-portfolio/performance.mdmarkdown3.9 KB
references/react-portfolio/portfolio-seo.mdmarkdown4.8 KB
references/react-portfolio/responsive-design.mdmarkdown3.3 KB
references/threejs-builder-refs/advanced-animation.mdmarkdown12.1 KB
references/threejs-builder-refs/advanced-topics.mdmarkdown11.0 KB
references/threejs-builder-refs/build-recipes.mdmarkdown7.4 KB
references/threejs-builder-refs/game-architecture.mdmarkdown10.4 KB
references/threejs-builder-refs/game-patterns.mdmarkdown12.5 KB
references/threejs-builder-refs/gltf-loading.mdmarkdown8.6 KB
references/threejs-builder-refs/performance-patterns.mdmarkdown11.8 KB
references/threejs-builder-refs/react-three-fiber.mdmarkdown17.8 KB
references/threejs-builder-refs/shader-patterns.mdmarkdown15.0 KB
references/threejs-builder-refs/visual-polish.mdmarkdown16.3 KB
references/threejs-builder-refs/webgpu.mdmarkdown20.4 KB
references/typescript-frontend.mdmarkdown5.3 KB
references/typescript-frontend/engineering-rules.mdmarkdown7.8 KB
references/typescript-frontend/nextjs-security.mdmarkdown2.6 KB
references/typescript-frontend/react-view-transitions.mdmarkdown5.4 KB
references/ui-design.mdmarkdown10.2 KB
references/ui-design/ai-slop-detection.mdmarkdown8.5 KB
references/ui-design/design-conventions.mdmarkdown2.8 KB
references/ui-design/motion-and-interaction.mdmarkdown5.6 KB
scripts-distinctive-frontend-design/css_slop_rules.pyscript15.3 KB
scripts-distinctive-frontend-design/tests/test_css_slop_rules.pyscript6.9 KB
scripts-distinctive-frontend-design/tests/test_validate_design_advisory.pyscript3.3 KB
scripts-distinctive-frontend-design/tests/test_validate_design_macro.pyscript4.3 KB
scripts-distinctive-frontend-design/validate_design.pyscript22.2 KB
scripts-html-artifact/assemble-template.pyscript7.5 KB
scripts-html-artifact/css_slop_rules.pyscript15.4 KB
scripts-html-artifact/detect-shape.pyscript7.0 KB
scripts-html-artifact/fill-template.pyscript5.5 KB
scripts-html-artifact/pptx-bridge/__init__.pyscript490 B
scripts-html-artifact/pptx-bridge/_pptx_engine.pyscript26.4 KB
scripts-html-artifact/pptx-bridge/extract_slides.pyscript13.5 KB
scripts-html-artifact/pptx-bridge/render_pptx.pyscript6.9 KB
scripts-html-artifact/pptx-bridge/run-unified.pyscript11.6 KB
scripts-html-artifact/render-github-issues.pyscript7.5 KB
scripts-html-artifact/tests/test_assemble_template.pyscript29.5 KB
scripts-html-artifact/tests/test_css_slop_emission.pyscript7.9 KB
scripts-html-artifact/tests/test_detect_shape.pyscript5.3 KB
scripts-html-artifact/tests/test_fill_template.pyscript5.2 KB
scripts-html-artifact/tests/test_to_pdf.pyscript13.3 KB
scripts-html-artifact/tests/test_validate_artifact.pyscript13.6 KB
scripts-html-artifact/to-pdf.pyscript12.5 KB
scripts-html-artifact/validate-artifact.pyscript11.0 KB
templates/base-reset.cssother1.2 KB
templates/components/collapsible.cssother1.1 KB
templates/components/collapsible.jsscript516 B
templates/components/copy-button.cssother534 B
templates/components/copy-button.jsscript334 B
templates/components/drag-drop.cssother612 B
templates/components/drag-drop.jsscript1.1 KB
templates/components/filter.cssother1.1 KB
templates/components/filter.jsscript987 B
templates/components/keyboard-nav.cssother249 B
templates/components/keyboard-nav.jsscript900 B
templates/components/scrollytelling.cssother1.5 KB
templates/components/scrollytelling.jsscript2.0 KB
templates/components/slider.cssother848 B
templates/components/tabs.cssother770 B
templates/components/tabs.jsscript508 B
templates/components/theme-toggle.cssother1.2 KB
templates/components/theme-toggle.jsscript178 B
templates/fonts/ArchivoBlack-OFL.txtmarkdown4.4 KB
templates/fonts/archivo-black.cssother13.7 KB
templates/print/code-review-print.cssother1.9 KB
templates/print/data-viz-print.cssother1.5 KB
templates/print/deck-print.cssother1.5 KB
templates/print/default-print.cssother1.6 KB
templates/print/diagram-print.cssother1.6 KB
templates/print/editor-print.cssother2.1 KB
templates/print/prototype-print.cssother1.4 KB
templates/print/report-print.cssother1.8 KB
templates/print/spec-print.cssother1.4 KB
templates/saved/README.mdmarkdown1.8 KB
templates/saved/business-review.htmlother17.1 KB
templates/saved/business-review.slots.jsonconfig1.5 KB
templates/saved/github-issues.htmlother34.0 KB
templates/saved/project-kickoff.htmlother17.3 KB
templates/saved/project-kickoff.slots.jsonconfig1.7 KB
templates/saved/system-design.htmlother16.9 KB
templates/saved/system-design.slots.jsonconfig1.6 KB
templates/shapes/code-review.cssother2.7 KB
templates/shapes/data-viz.cssother2.3 KB
templates/shapes/deck.cssother1.9 KB
templates/shapes/diagram.cssother2.7 KB
templates/shapes/editor.cssother2.8 KB
templates/shapes/prototype.cssother2.7 KB
templates/shapes/report.cssother2.9 KB
templates/shapes/spec.cssother3.0 KB
templates/themes/birchline.cssother2.4 KB
templates/themes/dark-focus.cssother2.6 KB
templates/themes/interactive-warm.cssother4.5 KB
templates/themes/minimal-document.cssother2.6 KB

references/design-refs/design-systems.md

View on GitHub
# Design Systems Reference

Domain knowledge for design token architecture, component API design, and system governance. Concrete patterns that change model behavior.

---

## Design Token Architecture

### Token Layers

Tokens organize into three layers. Each layer serves a different audience.

| Layer | Purpose | Example | Consumer |
|-------|---------|---------|----------|
| **Global** | Raw values | `blue-500: #3B82F6` | System maintainers only |
| **Semantic** | Meaning-mapped | `color-primary: {blue-500}` | Component authors |
| **Component** | Context-specific | `button-bg-primary: {color-primary}` | Implementation detail |

**Key rule**: Components reference semantic tokens. Semantic tokens reference global tokens. Components do not reference global tokens directly. This indirection enables theming.

### Color Token System

| Category | Tokens | Usage |
|----------|--------|-------|
| **Brand** | `color-brand-primary`, `color-brand-secondary`, `color-brand-accent` | Brand identity, primary CTAs, key UI accents |
| **Semantic** | `color-success`, `color-warning`, `color-error`, `color-info` | Status communication, form validation, alerts |
| **Neutral** | `color-neutral-50` through `color-neutral-900` | Text, backgrounds, borders, dividers |
| **Surface** | `color-surface-primary`, `color-surface-secondary`, `color-surface-elevated` | Background layers, cards, modals |
| **Interactive** | `color-interactive-default`, `color-interactive-hover`, `color-interactive-active`, `color-interactive-disabled` | Buttons, links, form controls |
| **Text** | `color-text-primary`, `color-text-secondary`, `color-text-disabled`, `color-text-inverse` | Typography hierarchy |

**Contrast rule**: Every text/background pairing must meet WCAG 2.1 AA. Document the contrast ratio for each pairing in the token spec.

### Typography Token System

| Token | Purpose | Example Value |
|-------|---------|---------------|
| `font-family-sans` | UI text | Inter, system-ui, sans-serif |
| `font-family-mono` | Code, data | JetBrains Mono, monospace |
| `font-size-xs` | Captions, badges | 12px / 0.75rem |
| `font-size-sm` | Helper text, metadata | 14px / 0.875rem |
| `font-size-md` | Body text | 16px / 1rem |
| `font-size-lg` | Section headings | 18px / 1.125rem |
| `font-size-xl` | Page headings | 24px / 1.5rem |
| `font-size-2xl` | Hero text | 30px / 1.875rem |
| `font-size-3xl` | Display | 36px / 2.25rem |
| `font-weight-regular` | Body text | 400 |
| `font-weight-medium` | Emphasis, labels | 500 |
| `font-weight-semibold` | Headings, buttons | 600 |
| `font-weight-bold` | Strong emphasis | 700 |
| `line-height-tight` | Headings | 1.25 |
| `line-height-normal` | Body text | 1.5 |
| `line-height-relaxed` | Long-form content | 1.75 |

**Type scale**: Use a consistent ratio (1.25 major third or 1.333 perfect fourth). Every size derives from base * ratio^n. This creates visual harmony and prevents arbitrary sizing.

### Spacing Token System

| Token | Value | Usage |
|-------|-------|-------|
| `space-0` | 0 | Reset |
| `space-1` | 4px | Tight grouping (icon + label) |
| `space-2` | 8px | Related elements within a group |
| `space-3` | 12px | Between form fields |
| `space-4` | 16px | Standard component padding |
| `space-5` | 20px | Section content padding |
| `space-6` | 24px | Between related sections |
| `space-8` | 32px | Between distinct sections |
| `space-10` | 40px | Major section separation |
| `space-12` | 48px | Page-level spacing |
| `space-16` | 64px | Layout columns, major gaps |

**Base unit**: 4px. All spacing values are multiples of 4. This creates a consistent rhythm and prevents "just add 3px" drift.

### Elevation Token System

| Token | Shadow | Usage |
|-------|--------|-------|
| `elevation-0` | none | Flat elements, inline content |
| `elevation-1` | `0 1px 2px rgba(0,0,0,0.05)` | Cards, raised surfaces |
| `elevation-2` | `0 4px 6px rgba(0,0,0,0.07)` | Dropdowns, popovers |
| `elevation-3` | `0 10px 15px rgba(0,0,0,0.1)` | Modals, dialogs |
| `elevation-4` | `0 20px 25px rgba(0,0,0,0.15)` | Notifications, toasts |

**Rule**: Higher elevation = closer to user = more important. Elevation communicates layer hierarchy. Two elements at the same elevation should not overlap.

### Motion Token System

| Token | Value | Usage |
|-------|-------|-------|
| `duration-instant` | 100ms | Micro-interactions (hover, focus ring) |
| `duration-fast` | 150ms | Toggles, color changes |
| `duration-normal` | 250ms | Modals, panels, expand/collapse |
| `duration-slow` | 400ms | Page transitions, complex animations |
| `easing-default` | `ease-in-out` | Most transitions |
| `easing-enter` | `ease-out` | Elements appearing (modal enters) |
| `easing-exit` | `ease-in` | Elements leaving (modal exits) |
| `easing-spring` | `cubic-bezier(0.34, 1.56, 0.64, 1)` | Playful, bouncy interactions |

---

## Component API Design Patterns

### Naming Conventions

| Entity | Convention | Examples |
|--------|-----------|----------|
| Components | PascalCase, noun-based | `Button`, `TextField`, `DataTable` |
| Variants | Descriptive adjective or purpose | `primary`, `secondary`, `ghost`, `destructive` |
| Sizes | T-shirt sizing | `sm`, `md`, `lg` (avoid `small`, `medium`, `large` — more characters, same info) |
| States | Present participle or adjective | `disabled`, `loading`, `selected`, `expanded` |
| Slots | Noun describing the content | `icon`, `label`, `description`, `badge` |
| Events | `on` + PascalCase verb | `onClick`, `onChange`, `onDismiss` |
| Booleans | `is` or `has` prefix | `isDisabled`, `hasError`, `isOpen` |

**Consistency rule**: Pick one convention and apply it everywhere. A component that uses `variant` while another uses `type` for the same concept creates confusion.

### Variant Strategies

| Strategy | When to Use | Example |
|----------|-------------|---------|
| **Prop-based** | Few, orthogonal variations | `<Button variant="primary" size="md">` |
| **Compound** | Complex components with sub-parts | `<Select><Select.Option>` |
| **Composition** | Maximum flexibility needed | `<Card><CardHeader><CardBody>` |
| **Polymorphic** | Component renders different elements | `<Button as="a" href="...">` |

### State Management

Every interactive component defines these states:

| State | Visual Treatment | Behavior |
|-------|-----------------|----------|
| Default | Base appearance | Interactive |
| Hover | Subtle highlight (background or border shift) | Shows interactivity |
| Focus | Visible focus ring (2px offset, high contrast) | Keyboard accessible |
| Active/Pressed | Darker/depressed appearance | Confirms activation |
| Disabled | Reduced opacity (0.5), muted colors | Non-interactive, cursor: not-allowed |
| Loading | Spinner or skeleton, text preserved for layout | Non-interactive during load |
| Error | Error color border/outline, error icon | Shows validation failure |
| Selected | Distinct background or check indicator | Shows current selection |

---

## Composition Patterns

### Slot-Based Composition

Components expose named slots for content injection:

```
<Card>
  <Card.Header>       → title area
  <Card.Media>         → image/video area
  <Card.Body>          → main content
  <Card.Actions>       → button area
</Card>
```

**Rule**: Slots define where content goes. The component controls layout. The consumer controls content.

### Render Prop Pattern

For components that need to expose internal state:

```
<Combobox>
  {({ isOpen, selectedItem }) => (
    <Combobox.Input />
    <Combobox.Options />
  )}
</Combobox>
```

### Provider Pattern

For cross-cutting concerns (theme, locale, feature flags):

```
<ThemeProvider theme={darkTheme}>
  <App />    → all descendants access theme tokens
</ThemeProvider>
```

---

## Theme Architecture

| Concern | Implementation | Example |
|---------|---------------|---------|
| Light/dark mode | Swap semantic token values | `color-surface-primary: white` (light) / `#1a1a1a` (dark) |
| Brand theming | Override brand tokens | `color-brand-primary: {partner-blue}` |
| Density | Adjust spacing and sizing tokens | `space-4: 12px` (compact) / `16px` (default) / `20px` (comfortable) |
| Color scheme | Semantic tokens map to different global palettes | `color-primary: {indigo-600}` (default) / `{teal-600}` (alt) |

**Theme structure**: Themes override semantic tokens only. Global tokens remain stable. Components do not need to know which theme is active.

---

## Documentation Standards

Every component's documentation includes:

| Section | Contents |
|---------|----------|
| Description | What it is, when to use it, when to use something else |
| Props table | Name, type, default, description for every prop |
| Variants gallery | Visual example of every variant |
| States reference | Visual example of every state |
| Accessibility | ARIA role, keyboard behavior, screen reader announcements |
| Usage guidelines | Do's (with rationale) and alternatives (with context) |
| Code examples | Minimum viable, common patterns, edge cases |
| Related components | What's similar and when to pick which |

**Do/Instead pattern for documentation**:

| Do | Instead of |
|------|-----------|
| Use `Button variant="destructive"` for delete actions | Using `variant="primary"` with a red color override |
| Compose `Card` with `Card.Header` for titled content | Passing `title` as a string prop (limits formatting) |
| Use `TextField` with `type="email"` for email inputs | Building a custom input with regex validation |
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall