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/nextjs-ecommerce/error-catalog.md

View on GitHub
# Error Catalog Reference
<!-- Loaded via nextjs-ecommerce.md when task involves error handling, payment failures, webhook errors, or inventory conflicts -->

Four categories: payment failures (user-recoverable), auth errors (session/permission), inventory conflicts (race conditions), infrastructure errors (rate limits, webhooks).

## Payment Failures

### Card Declined
**Stripe code:** `card_declined`
**User message:** "Your card was declined. Please try a different payment method."
**Recovery:** Show alternative payment method options. Do not retry automatically.

```typescript
function mapStripeError(error: Stripe.StripeError): string {
  switch (error.code) {
    case 'card_declined':
      return error.decline_code === 'insufficient_funds'
        ? 'Your card has insufficient funds. Please try a different card.'
        : 'Your card was declined. Please try a different payment method.'
    case 'expired_card':
      return 'Your card has expired. Please update your payment method.'
    case 'incorrect_cvc':
      return 'Your security code is incorrect. Please check and try again.'
    case 'processing_error':
      return 'A processing error occurred. Please try again in a moment.'
    case 'authentication_required':
      return 'Your bank requires additional verification. Please complete authentication.'
    default:
      return 'Payment could not be processed. Please try a different method.'
  }
}
```

### Insufficient Funds
**Stripe decline_code:** `insufficient_funds`
**What happens:** Payment Intent created, confirmation fails.
**Recovery:** Show specific message about insufficient funds, suggest alternative card.

### Expired Card
**Stripe code:** `expired_card`
**What happens:** Stripe rejects the card before creating a Payment Intent.
**Recovery:** Prompt user to update card details.

### Authentication Required (3D Secure)
**Stripe code:** `authentication_required`
**What happens:** Bank requires 3DS challenge; `stripe.confirmPayment` triggers the flow automatically.
**Recovery:** Handled automatically by Stripe Elements unless using manual confirmation.

---

## Auth Errors

### Unauthenticated Access to Protected Route
**HTTP status:** 401
**Cause:** Session expired or user not logged in.

```typescript
// middleware.ts — redirect to login for protected routes
import { NextResponse } from 'next/server'
import type { NextRequest } from 'next/server'
import { getToken } from 'next-auth/jwt'

export async function middleware(request: NextRequest) {
  const PROTECTED = ['/account', '/orders', '/admin']
  const isProtected = PROTECTED.some(path => request.nextUrl.pathname.startsWith(path))

  if (!isProtected) return NextResponse.next()

  const token = await getToken({ req: request })
  if (!token) {
    const loginUrl = new URL('/login', request.url)
    loginUrl.searchParams.set('callbackUrl', request.nextUrl.pathname)
    return NextResponse.redirect(loginUrl)
  }

  return NextResponse.next()
}
```

### Insufficient Permissions (Admin Routes)
**HTTP status:** 403
**Cause:** Authenticated user accessing admin-only resource.

```typescript
// Verify admin role in Server Component
import { getServerSession } from 'next-auth'
import { authOptions } from '@/lib/auth'

export default async function AdminPage() {
  const session = await getServerSession(authOptions)

  if (session?.user?.role !== 'admin') {
    notFound() // Prefer notFound() over forbidden() to avoid revealing admin routes exist
  }

  return <AdminDashboard />
}
```

---

## Inventory Conflicts

### Out of Stock at Checkout
**When:** Product in stock when added to cart, sold out before payment.

```typescript
// actions/checkout.ts — validate stock before creating order
export async function validateCartStock(cartId: string): Promise<{
  valid: boolean
  outOfStock: Array<{ productId: string; name: string; available: number }>
}> {
  const cart = await db.cart.findUniqueOrThrow({
    where: { id: cartId },
    include: { items: { include: { product: true } } },
  })

  const outOfStock = cart.items
    .filter(item => item.product.stock < item.quantity)
    .map(item => ({
      productId: item.productId,
      name: item.product.name,
      available: item.product.stock,
    }))

  return { valid: outOfStock.length === 0, outOfStock }
}
```

Show user which items are unavailable; offer to adjust quantities or remove items.

### Oversell Race Condition
**When:** Two users purchase the last unit simultaneously.
**Fix:** Atomic transaction with pessimistic lock — see `shopping-cart-patterns.md`.

---

## Webhook Delivery Failures

### Signature Verification Failed
**Cause:** Raw body was parsed before signature check, or wrong webhook secret.

```typescript
// Correct: read raw body BEFORE any parsing
export async function POST(req: Request) {
  const body = await req.text()  // NOT req.json()
  const sig = headers().get('stripe-signature')!
  // ...
}
```

**Debugging:** Use `stripe listen` locally to see the exact body and signature Stripe sends.

### Webhook Timeout
**Cause:** Handler doing too much work synchronously.
**Fix:** Acknowledge immediately, process asynchronously.

```typescript
export async function POST(req: Request) {
  const event = await verifyWebhook(req) // fast — just signature check

  // Queue for async processing
  await queue.add('stripe-event', { eventId: event.id, type: event.type })

  // Acknowledge to Stripe immediately — prevents retry
  return Response.json({ received: true })
}
```

Stripe retries with exponential backoff if no 2xx within 30 seconds.

### Duplicate Webhook Events
**Cause:** Stripe guarantees at-least-once delivery.
**Fix:** Check order/event status before processing. See `stripe-integration.md` webhook idempotency section.

---

## Rate Limits

### Stripe API Rate Limits
**Stripe limit:** 100 requests/second in test, 25 in live mode (per account).
**Symptoms:** `429 Too Many Requests` from Stripe SDK.

```typescript
// Implement retry with exponential backoff
async function stripeWithRetry<T>(
  fn: () => Promise<T>,
  maxRetries = 3
): Promise<T> {
  for (let attempt = 0; attempt <= maxRetries; attempt++) {
    try {
      return await fn()
    } catch (err) {
      if (err instanceof Stripe.errors.StripeRateLimitError && attempt < maxRetries) {
        const delay = Math.pow(2, attempt) * 1000 + Math.random() * 1000
        await new Promise(resolve => setTimeout(resolve, delay))
        continue
      }
      throw err
    }
  }
  throw new Error('Max retries exceeded')
}
```

### Database Connection Pool Exhausted
**Cause:** Too many concurrent requests, connection pool too small.
**Symptoms:** Prisma throws `P2024` (connection pool timeout).

```typescript
// prisma/schema.prisma
datasource db {
  provider  = "postgresql"
  url       = env("DATABASE_URL")
  // Increase pool size for high-traffic checkout flows
  // connection_limit and pool_timeout via URL params
}
```

Add `?connection_limit=20&pool_timeout=10` to `DATABASE_URL` for higher-traffic sites.

---

## Error Response Patterns

Consistent error shapes for predictable client-side handling:

```typescript
// types/api.ts
interface ApiSuccess<T> {
  success: true
  data: T
}

interface ApiError {
  success: false
  error: string
  code?: string    // machine-readable code for programmatic handling
  field?: string   // which form field caused the error, if applicable
}

type ApiResponse<T> = ApiSuccess<T> | ApiError

// Usage in Server Action
export async function processCheckout(
  cartId: string
): Promise<ApiResponse<{ orderId: string }>> {
  try {
    const { valid, outOfStock } = await validateCartStock(cartId)
    if (!valid) {
      return {
        success: false,
        error: `${outOfStock[0].name} is out of stock`,
        code: 'OUT_OF_STOCK',
      }
    }
    const order = await createOrder(cartId)
    return { success: true, data: { orderId: order.id } }
  } catch (err) {
    console.error('Checkout error:', err)
    return { success: false, error: 'Checkout failed. Please try again.', code: 'INTERNAL' }
  }
}
```
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