lidge-jun/codexclaw / plugins/codexclaw/skills/dev-frontend
cxc-dev-frontend
UnverifiedUse for frontend code and UI fixes. Triggers: CSS, responsive, animation, React, Vue, Svelte, Tailwind, redesign, anti-slop, 프론트엔드, UI 작업, 반응형, 디자인 수정.
references/core/performance-budget.md
View on GitHub# Performance Budget
## Core Web Vitals Targets
| Metric | Good | Needs Work | Poor | Measures |
|--------|------|------------|------|----------|
| LCP | ≤ 2.5s | ≤ 4.0s | > 4.0s | Hero load time |
| INP | ≤ 200ms | ≤ 500ms | > 500ms | Input responsiveness |
| CLS | ≤ 0.1 | ≤ 0.25 | > 0.25 | Visual stability |
- Every page targets "Good" on all three
- LCP element: identify early, preload it
- INP: never block main thread > 50ms
- CLS: every image/video/embed needs explicit `width`+`height` or `aspect-ratio`
## Bundle Size Budgets
| Resource | Budget (compressed) |
|----------|-------------------|
| Total page weight | <= 500KB first load (LANDING/EXPERIENCE motion media exempt - see FE-MEDIA-BUDGET-01) |
| JavaScript (per route) | ≤ 150KB |
| CSS (total) | ≤ 50KB |
| Hero image | <= 100KB (LANDING/EXPERIENCE motion media exempt - see FE-MEDIA-BUDGET-01) |
| Images (above fold) | <= 200KB (LANDING/EXPERIENCE motion media exempt - see FE-MEDIA-BUDGET-01) |
| Web fonts | ≤ 100KB |
- Measure compressed (gzip/brotli) sizes
- Tree-shake: `import { x } from 'lib'`, never `import lib`
- Dynamic import for below-fold: `lazy(() => import('./Modal'))`
- Bundle analyzer mandatory for builds > 200KB JS
## Motion Media Budget Exemption (FE-MEDIA-BUDGET-01) (DEFAULT)
On LANDING/EXPERIENCE-bucket surfaces (see `motion.md` FE-MOTION-BUCKET-01), motion media
is exempt from byte-cap rows with no byte ceiling: autoplay loop video,
scroll-scrub video, frame sequences, and large hero imagery. Budget freedom is
not correctness freedom: Core Web Vitals field gates remain supreme (LCP <= 2.5s,
INP <= 200ms, CLS <= 0.1).
This exemption applies only when the loading mechanics hold:
- Poster-first LCP; the poster itself counts toward the hero image budget.
- Lazy or Intersection Observer-gated loading outside first paint.
- `prefers-reduced-motion` and `prefers-reduced-data` fallbacks to poster/still.
- Stable layout; no CLS from media swap.
- Poster-first loading; the still is useful before heavy media arrives.
- Explicit skip or pause control for authored playback/choreography.
- Adaptive quality selected from device, network, and reduced-data capability.
- Primary copy and the primary CTA are never blocked on media readiness.
- Measured LCP meets the field gate; do not infer it from asset size.
- Measured interaction cost meets the INP field gate during choreography.
Heavy media still needs a product reason plus the mechanics above. Do not ship
large video, frame sequences, or heavy hero imagery just because the byte cap is
exempt.
## Font Loading
```html
<link rel="preload" href="/fonts/primary.woff2" as="font" type="font/woff2" crossorigin>
```
```css
@font-face {
font-family: 'Primary';
src: url('/fonts/primary.woff2') format('woff2');
font-display: swap;
unicode-range: U+0020-007F, U+AC00-D7AF;
}
```
- `font-display: swap` for body, `optional` for decorative
- Preload only the primary font file
- Subset: Latin + target script only
- Max 2 families, 4 weights total
- Self-host when possible
## Image Optimization
| Format | Use For | Quality |
|--------|---------|---------|
| WebP | Photos, complex | 75-85% |
| AVIF | Photos (modern) | 65-75% |
| SVG | Icons, logos | N/A |
| PNG | Screenshots, transparency | Lossless |
- `<picture>` with AVIF → WebP → fallback for hero
- `loading="lazy"` below-fold, `loading="eager" fetchpriority="high"` for hero
- Max 2x display size for retina
- Responsive `srcset` + `sizes` for content images
## Build-Time Gates
- Lighthouse Performance score is advisory smoke only; CWV field metrics are the gate
- Bundle regression: fail if JS increases > 10KB
- Image audit: flag > 200KB, excluding declared LANDING/EXPERIENCE motion-media assets (frame sequences, posters of IO-gated video)
- Unused CSS: flag > 5KB dead CSS
## Runtime Rules
- No `querySelectorAll` in scroll/resize handlers
- Debounce scroll: 100ms min, `requestAnimationFrame` for visual
- Intersection Observer for lazy loading
- `content-visibility: auto` on below-fold sections
## Pre-flight
- [ ] Hero image <= 100KB, `fetchpriority="high"`, explicit dimensions; LANDING/EXPERIENCE motion media exempt per FE-MEDIA-BUDGET-01 when poster-first/loading mechanics hold
- [ ] Below-fold images have `loading="lazy"`
- [ ] No JS bundle > 150KB compressed
- [ ] `font-display: swap` + `preload` on primary font
- [ ] Every `<img>`/`<video>` has `width`+`height`
- [ ] Lighthouse Performance score is advisory smoke only; CWV field metrics are the gate
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| 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: 322k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |
| 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: 197k | Updated | Claude CodeCodex | Verified | Install |