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/admin-dashboard.md

View on GitHub
# Admin Dashboard Reference
<!-- Loaded via nextjs-ecommerce.md when task involves admin UI, order management, product CRUD, inventory tracking, analytics, or role-based access -->

Every destructive action needs confirmation; every mutation needs authorization.

## Role-Based Access Control
**When to use:** Any admin route. Gate at middleware and repeat in Server Components (defense in depth).

```typescript
// lib/auth.ts — extend NextAuth session with role
import { DefaultSession } from 'next-auth'

declare module 'next-auth' {
  interface Session {
    user: DefaultSession['user'] & {
      id: string
      role: 'customer' | 'admin' | 'staff'
    }
  }
}

export const authOptions: NextAuthOptions = {
  callbacks: {
    session({ session, token }) {
      return {
        ...session,
        user: {
          ...session.user,
          id: token.sub!,
          role: token.role as 'customer' | 'admin' | 'staff',
        },
      }
    },
    jwt({ token, user }) {
      if (user) token.role = (user as any).role
      return token
    },
  },
}
```

```typescript
// middleware.ts — block non-admin at the edge
export async function middleware(request: NextRequest) {
  if (!request.nextUrl.pathname.startsWith('/admin')) return NextResponse.next()

  const token = await getToken({ req: request })
  if (!token || token.role !== 'admin') {
    return NextResponse.redirect(new URL('/', request.url))
  }

  return NextResponse.next()
}

export const config = { matcher: ['/admin/:path*'] }
```

```typescript
// app/admin/layout.tsx — secondary check in Server Component
export default async function AdminLayout({ children }: { children: React.ReactNode }) {
  const session = await getServerSession(authOptions)

  // Belt and suspenders — middleware already blocked, but verify again
  if (session?.user?.role !== 'admin') notFound()

  return <div className="admin-shell">{children}</div>
}
```

---

## Order Management
**When to use:** Admin view of all orders with filtering, status updates, and fulfillment tracking.

```typescript
// app/admin/orders/page.tsx
import { db } from '@/lib/db'

interface OrdersPageProps {
  searchParams: { status?: string; page?: string }
}

export default async function OrdersPage({ searchParams }: OrdersPageProps) {
  const page = parseInt(searchParams.page ?? '1')
  const pageSize = 25
  const status = searchParams.status

  const [orders, total] = await Promise.all([
    db.order.findMany({
      where: status ? { status: status as OrderStatus } : undefined,
      include: {
        user: { select: { name: true, email: true } },
        items: {
          include: { product: { select: { name: true } } },
        },
      },
      orderBy: { createdAt: 'desc' },
      skip: (page - 1) * pageSize,
      take: pageSize,
    }),
    db.order.count({ where: status ? { status: status as OrderStatus } : undefined }),
  ])

  return (
    <div>
      <OrderFilters currentStatus={status} />
      <OrderTable orders={orders} />
      <Pagination page={page} total={total} pageSize={pageSize} />
    </div>
  )
}
```

```typescript
// actions/admin/orders.ts — update order status
'use server'
import { z } from 'zod'
import { requireAdmin } from '@/lib/auth-helpers'

const UpdateOrderSchema = z.object({
  orderId: z.string().cuid(),
  status: z.enum(['pending', 'processing', 'shipped', 'delivered', 'refunded', 'cancelled']),
  note: z.string().max(500).optional(),
})

export async function updateOrderStatus(formData: FormData) {
  await requireAdmin() // throws if not admin

  const parsed = UpdateOrderSchema.safeParse({
    orderId: formData.get('orderId'),
    status: formData.get('status'),
    note: formData.get('note'),
  })

  if (!parsed.success) throw new Error('Invalid form data')

  await db.$transaction(async (tx) => {
    await tx.order.update({
      where: { id: parsed.data.orderId },
      data: { status: parsed.data.status },
    })
    // Audit log — every status change is traceable
    await tx.orderAuditLog.create({
      data: {
        orderId: parsed.data.orderId,
        previousStatus: 'unknown', // fetch before update in real usage
        newStatus: parsed.data.status,
        note: parsed.data.note,
        adminId: (await getServerSession(authOptions))!.user.id,
      },
    })
  })

  revalidatePath('/admin/orders')
}
```

---

## Product CRUD
**When to use:** Admin product management — create, edit, archive products. Use `archive` instead of `delete` to preserve order history references.

```typescript
// actions/admin/products.ts
'use server'
import { z } from 'zod'
import { requireAdmin } from '@/lib/auth-helpers'

const ProductSchema = z.object({
  name:        z.string().min(1).max(200),
  description: z.string().max(5000),
  price:       z.number().positive().multipleOf(0.01),
  stock:       z.number().int().min(0),
  categoryId:  z.string().cuid(),
  published:   z.boolean().default(false),
})

export async function createProduct(formData: FormData) {
  await requireAdmin()

  const parsed = ProductSchema.safeParse({
    name:        formData.get('name'),
    description: formData.get('description'),
    price:       parseFloat(formData.get('price') as string),
    stock:       parseInt(formData.get('stock') as string),
    categoryId:  formData.get('categoryId'),
    published:   formData.get('published') === 'true',
  })

  if (!parsed.success) {
    return { success: false, errors: parsed.error.flatten().fieldErrors }
  }

  const product = await db.product.create({ data: parsed.data })

  revalidatePath('/admin/products')
  revalidatePath('/products') // invalidate public product listing

  return { success: true, productId: product.id }
}

export async function archiveProduct(productId: string) {
  await requireAdmin()

  // Soft delete — preserve for order history
  await db.product.update({
    where: { id: productId },
    data: { archivedAt: new Date(), published: false },
  })

  revalidatePath('/admin/products')
  revalidatePath('/products')
}
```

---

## Inventory Tracking
**When to use:** Admin inventory view showing current stock levels, low-stock alerts, and restock history.

```typescript
// app/admin/inventory/page.tsx
export default async function InventoryPage() {
  const LOW_STOCK_THRESHOLD = 5

  const products = await db.product.findMany({
    where: { archivedAt: null },
    select: {
      id: true,
      name: true,
      stock: true,
      sku: true,
    },
    orderBy: { stock: 'asc' }, // lowest stock first
  })

  const lowStock = products.filter(p => p.stock <= LOW_STOCK_THRESHOLD)

  return (
    <div>
      {lowStock.length > 0 && (
        <div role="alert" className="rounded bg-amber-50 border border-amber-200 p-4 mb-6">
          <h2 className="font-semibold text-amber-900">
            {lowStock.length} product{lowStock.length > 1 ? 's' : ''} low on stock
          </h2>
          <ul className="mt-2 text-sm text-amber-800">
            {lowStock.map(p => (
              <li key={p.id}>{p.name} — {p.stock} remaining</li>
            ))}
          </ul>
        </div>
      )}
      <InventoryTable products={products} threshold={LOW_STOCK_THRESHOLD} />
    </div>
  )
}
```

```typescript
// actions/admin/inventory.ts — manual stock adjustment
export async function adjustStock(productId: string, delta: number, reason: string) {
  await requireAdmin()

  await db.$transaction(async (tx) => {
    const product = await tx.product.update({
      where: { id: productId },
      data: { stock: { increment: delta } },
      select: { stock: true },
    })

    if (product.stock < 0) {
      throw new Error('Stock cannot be negative')
    }

    await tx.inventoryLog.create({
      data: {
        productId,
        delta,
        reason,
        adminId: (await getServerSession(authOptions))!.user.id,
      },
    })
  })

  revalidatePath('/admin/inventory')
}
```

---

## Analytics Dashboard
**When to use:** Admin overview of revenue, order volume, and top products. Use aggregation queries rather than loading all records.

```typescript
// app/admin/analytics/page.tsx
export default async function AnalyticsPage() {
  const thirtyDaysAgo = new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)

  const [revenue, orderCount, topProducts] = await Promise.all([
    // Total revenue last 30 days
    db.order.aggregate({
      where: {
        createdAt: { gte: thirtyDaysAgo },
        status: { in: ['fulfilled', 'shipped', 'delivered'] },
      },
      _sum: { total: true },
    }),

    // Order count last 30 days
    db.order.count({
      where: { createdAt: { gte: thirtyDaysAgo } },
    }),

    // Top 5 products by units sold last 30 days
    db.orderItem.groupBy({
      by: ['productId'],
      where: {
        order: { createdAt: { gte: thirtyDaysAgo } },
      },
      _sum: { quantity: true },
      orderBy: { _sum: { quantity: 'desc' } },
      take: 5,
    }),
  ])

  return (
    <div className="grid grid-cols-1 md:grid-cols-3 gap-6">
      <MetricCard
        label="Revenue (30d)"
        value={new Intl.NumberFormat('en-US', { style: 'currency', currency: 'USD' })
          .format(revenue._sum.total ?? 0)}
      />
      <MetricCard label="Orders (30d)" value={orderCount.toString()} />
      <TopProductsList items={topProducts} />
    </div>
  )
}
```

---

## Audit Logging
**When to use:** Any destructive or financial admin action.

```typescript
// lib/audit.ts
interface AuditEntry {
  action: string
  entityType: string
  entityId: string
  adminId: string
  before?: Record<string, unknown>
  after?: Record<string, unknown>
}

export async function auditLog(entry: AuditEntry): Promise<void> {
  await db.auditLog.create({
    data: {
      ...entry,
      before: entry.before ?? undefined,
      after:  entry.after ?? undefined,
      createdAt: new Date(),
    },
  })
}

// Usage
await auditLog({
  action: 'order.status_changed',
  entityType: 'order',
  entityId: orderId,
  adminId: session.user.id,
  before: { status: previousStatus },
  after:  { status: newStatus },
})
```
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