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/react-native/error-handling.md

View on GitHub
# Error Handling Reference
<!-- Loaded via react-native.md when task involves error boundaries, Sentry, crash recovery, try/catch, ErrorBoundary, error states -->

> **Scope**: Production error handling: Error Boundaries, Sentry, promise rejection capture, crash-safe rendering.
> **Version range**: React 18+, React Native 0.72+, @sentry/react-native 5+
> **Generated**: 2026-04-12

---

## Pattern Table

| Pattern | Version | Use When | Avoid When |
|---------|---------|----------|------------|
| `ErrorBoundary` (class component) | React 16+ | Render-phase errors | Async errors in event handlers |
| `react-native-error-boundary` | any | Quick ErrorBoundary with fallback UI | Custom recovery logic needed |
| `Sentry.init()` in app entry | `@sentry/react-native 5+` | Production crash reporting | Local dev |
| `unhandledRejection` global handler | RN 0.68+ | All unhandled promise rejections | Replacing proper `try/catch` |
| `InteractionManager.runAfterInteractions` | any | Deferring error-prone work past animations | Time-sensitive fetching |

---

## Correct Patterns

### Wrap Screen Roots in ErrorBoundary

```tsx
import { ErrorBoundary } from 'react-error-boundary'

function FeedScreen() {
  return (
    <ErrorBoundary
      fallbackRender={({ error, resetErrorBoundary }) => (
        <View style={styles.errorContainer}>
          <Text>Something went wrong.</Text>
          <Pressable onPress={resetErrorBoundary}>
            <Text>Try again</Text>
          </Pressable>
        </View>
      )}
      onError={(error, info) => {
        captureException(error, { extra: { componentStack: info.componentStack } })
      }}
    >
      <FeedContent />
    </ErrorBoundary>
  )
}
```

Without a boundary, any render-phase throw crashes the entire React tree.

---

### Initialize Sentry Before the React Tree

```ts
// index.js — before importing App
import * as Sentry from '@sentry/react-native'

Sentry.init({
  dsn: process.env.EXPO_PUBLIC_SENTRY_DSN,
  environment: process.env.EXPO_PUBLIC_ENV ?? 'development',
  tracesSampleRate: process.env.EXPO_PUBLIC_ENV === 'production' ? 0.1 : 1.0,
  enabled: process.env.EXPO_PUBLIC_ENV !== 'development',
})

import { registerRootComponent } from 'expo'
import App from './App'
registerRootComponent(App)
```

Errors during app initialization are lost if Sentry isn't set up first.

---

### Capture Unhandled Promise Rejections

```ts
const handleUnhandledRejection = (event: PromiseRejectionEvent) => {
  console.error('Unhandled promise rejection:', event.reason)
  captureException(event.reason, { tags: { type: 'unhandled_rejection' } })
}

// Hermes engine (RN 0.64+)
if (global.HermesInternal) {
  const tracking = require('promise/setimmediate/rejection-tracking')
  tracking.enable({
    allRejections: true,
    onUnhandled: (id: number, rejection: unknown) => {
      captureException(rejection, { tags: { rejection_id: id } })
    },
  })
}
```

Fire-and-forget async calls fail silently in production without a global handler.

---

### Type Fetch Errors — Never Assume the Shape

```ts
async function fetchUser(id: string): Promise<User> {
  let res: Response

  try {
    res = await fetch(`${API_URL}/users/${id}`)
  } catch (err) {
    throw new Error(`Network error fetching user ${id}: ${String(err)}`)
  }

  if (!res.ok) {
    const text = await res.text().catch(() => '<unreadable>')
    throw new Error(`HTTP ${res.status} fetching user ${id}: ${text.slice(0, 200)}`)
  }

  try {
    return res.json() as Promise<User>
  } catch (err) {
    throw new Error(`Invalid JSON for user ${id}: ${String(err)}`)
  }
}
```

`fetch` does NOT throw on 4xx/5xx. Calling `res.json()` on an HTML error page throws a misleading parse error. Wrap each phase separately for actionable Sentry messages.

---

## Pattern Catalog

### Report Errors to a Crash Service

**Detection**:
```bash
grep -rn 'console\.error' --include="*.tsx" --include="*.ts" | grep -v "\.test\." | grep -v "\.spec\."
```

**Signal**:
```tsx
try { await syncData() } catch (err) { console.error('Sync failed', err) }
```

`console.error` is stripped in production builds. Errors are invisible.

**Preferred action**: Use `captureException(err)`. Keep `console.error` only in `__DEV__`.

---

### Handle Errors in Every Catch Block

**Detection**:
```bash
grep -rn 'catch\s*(.*)\s*{\s*}' --include="*.ts" --include="*.tsx"
```

**Signal**:
```ts
try { await loadUserPreferences() } catch (err) { /* TODO */ }
```

Silent swallow. No stack trace, no fallback, inconsistent state.

**Preferred action**: Report and reset to safe default:
```ts
try { await loadUserPreferences() } catch (err) {
  captureException(err)
  await setDefaultPreferences()
}
```

---

### Wrap Navigation Root in ErrorBoundary

**Detection**:
```bash
grep -rn 'Stack.Screen\|Tabs.Screen' --include="*.tsx" | grep -v ErrorBoundary
```

**Signal**:
```tsx
export default function RootLayout() {
  return (
    <Stack>
      <Stack.Screen name="(tabs)" component={TabsLayout} />
      <Stack.Screen name="profile" component={ProfileScreen} />
    </Stack>
  )
}
```

If any screen throws during render, the entire navigation tree white-screens.

**Preferred action**: Wrap each screen or the navigator root in an ErrorBoundary.

---

### Validate API Response Shape Before Accessing

**Detection**:
```bash
grep -rn '\.data\.' --include="*.ts" --include="*.tsx" | grep -v "\.test\." | grep "await fetch\|axios"
```

**Signal**:
```ts
const json = await response.json()
setUser(json.data.profile.name)  // throws if data or profile is undefined
```

**Preferred action**: Validate or use optional chaining with fallback:
```ts
if (!json.data?.profile) {
  throw new Error(`Unexpected API shape: ${JSON.stringify(json).slice(0, 200)}`)
}
```

---

## Error-Fix Mappings

| Error Message | Root Cause | Fix |
|---------------|------------|-----|
| `TypeError: Cannot read properties of undefined` | Null access on API response | Optional chaining or null check |
| `Network request failed` | No network or wrong host | Check `__DEV__` vs production API URL |
| `JSON Parse error: Unrecognized token '<'` | Server returned HTML instead of JSON | Check `res.ok` before `res.json()` |
| `Maximum update depth exceeded` | State setter in render or effect without deps | Move to event handler or fix deps array |
| `Can't perform state update on unmounted component` | Async completes after unmount | Return cleanup from `useEffect` |
| `Invariant Violation` from native module | Native call outside main thread | Move to dedicated service |

---

## Version-Specific Notes

| Version | Change | Impact |
|---------|--------|--------|
| RN 0.71 | `Promise.allSettled` default in Hermes | Use for partial results on failure |
| RN 0.73 | Improved async stack traces in Hermes | Update Sentry sourcemap upload |
| React 18 | `startTransition` errors fall back to ErrorBoundary | Transitions no longer crash whole tree |
| `@sentry/react-native` 5.0 | `Sentry.wrap(App)` deprecated | Use `Sentry.init()` then `withSentry(App)` |

---

## Detection Commands Reference

```bash
# console.error as only reporting (not in tests)
grep -rn 'console\.error' --include="*.tsx" --include="*.ts" | grep -v "\.test\.\|\.spec\."

# Empty catch blocks
grep -rn 'catch\s*(.*)\s*{\s*}' --include="*.ts" --include="*.tsx"

# Fetch without .ok check
grep -rn 'await fetch\|\.json()' --include="*.ts" --include="*.tsx" | grep -v 'res\.ok\|response\.ok'

# Deep property access without null guards
grep -rn '\.data\.\|\.result\.' --include="*.ts" --include="*.tsx" | grep -v '\?\.'

# Missing ErrorBoundary around screens
grep -rn 'Stack\.Screen\|Tabs\.Screen' --include="*.tsx" | grep -v 'ErrorBoundary'
```

---

## See Also

- `rendering-patterns.md` — Text component and conditional render crashes
- `state-management.md` — Stale state causing incorrect error recovery
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