web-complete — Master Web Development Skill Suite
1. Overview
This skill is the hub for all 14 web development sub-skills organized across three tiers. Use it to orient yourself, then invoke the specific sub-skill for deep patterns.
How to use this suite:
- Start here to identify which skills apply to your current build
- Use the Quick Reference Table to pick the right sub-skill
- Follow the Stack Decision Guide when combining skills for a specific project type
- Each skill section below gives 2-3 actionable patterns — the full treatment lives in the named sub-skill
The three tiers:
- Tier 1 — Core: Patterns every web project needs (copy, forms, motion, scroll)
- Tier 2 — Integrations: Third-party systems that require deliberate wiring (auth, payments, email, analytics)
- Tier 3 — Advanced: Capabilities that differentiate production apps (PWA, maps, realtime, i18n, OG images)
2. Quick Reference Table
| Skill |
One-line description |
Reach for it when... |
| web-copywriting |
Conversion-first copy patterns |
You're writing headlines, CTAs, value props, or pricing copy |
| web-forms |
Accessible, validated forms |
You need inputs, multi-step flows, or server-side validation |
| web-animations-gsap |
GSAP animation system |
You want timeline-driven, scroll-triggered, or SVG animations |
| web-scrollytelling |
Scroll-driven narrative UI |
You're building a story section pinned to scroll progress |
| web-micro-interactions |
Hover, focus, feedback states |
Buttons, toggles, loaders, skeleton screens need polish |
| web-auth |
Authentication flows |
Login, signup, OAuth, session management, protected routes |
| web-ecommerce |
Cart, checkout, product UI |
You're building a store, product page, or checkout flow |
| web-email-capture |
Lead capture and opt-in flows |
Newsletter signups, waitlists, lead magnets |
| web-analytics |
Event tracking and funnels |
You need pageview tracking, conversion events, or A/B setup |
| web-og-images |
Dynamic Open Graph image generation |
Social sharing previews need to be generated per-page |
| web-pwa |
Progressive Web App patterns |
Offline support, install prompt, service worker, push notifications |
| web-maps |
Interactive maps and geolocation |
You need embedded maps, markers, clustering, or routing |
| web-realtime |
WebSocket and live update patterns |
Chat, live scores, collaborative editing, presence indicators |
| web-i18n |
Internationalization and localization |
Multi-language support, locale routing, RTL layout |
3. Tier 1 — Core Skills
web-copywriting
Goal: Write copy that converts — not copy that describes.
Key patterns:
Problem-first headline structure
Lead with the pain, not the product. "Stop losing clients to slow proposals" outperforms "Proposal software for agencies." Follow with the outcome in the subheadline.
CTA specificity rule
Replace vague verbs (Get started, Learn more) with outcome verbs tied to the offer. "Send my first proposal free" converts higher than "Sign up."
Pricing page anchoring
Always show the highest tier first. Users anchor to the first price they see — everything below feels like a deal.
See web-copywriting for full patterns: benefit ladders, objection handling, microcopy for error states, and testimonial placement rules.
web-forms
Goal: Forms that are accessible, validate correctly, and feel fast.
Key patterns:
Inline validation timing
Validate on blur for most fields, not on input. Exception: password strength meters validate live. Never validate on submit-only — users hate discovering errors late.
Error message anatomy
Every error needs three parts: what went wrong, why it matters, how to fix it. "Invalid email" fails all three. "Email must include @ — check for typos like gmail,com" passes.
Multi-step form state
Persist step data to sessionStorage on every field change. Users lose progress on accidental back-navigation — this is a silent conversion killer.
See web-forms for full patterns: fieldset grouping, ARIA live regions, file upload UX, and server-side validation error mapping.
web-animations-gsap
Goal: Timeline-driven animations with scroll integration.
Key patterns:
Timeline registration
Always register plugins at the top of the module, not inside components or effects. gsap.registerPlugin(ScrollTrigger, SplitText) called twice causes duplicate registration warnings.
ScrollTrigger cleanup
In React/Vue, kill all ScrollTrigger instances in the cleanup function. Use ScrollTrigger.getAll().forEach(t => t.kill()) or scope to a context: ctx.revert().
Stagger from center
For grid reveals, stagger: { from: "center", amount: 0.6 } reads more intentional than sequential stagger. Combine with autoAlpha (not opacity) so hidden elements don't take up interaction area.
See web-animations-gsap for full patterns: SVG path drawing, morphing, flip animations, and matchMedia for reduced-motion.
web-scrollytelling
Goal: Scroll-driven narrative where the story advances as the user scrolls.
Key patterns:
Pin + scrub anatomy
The trigger element is the section container. The pinned element is the sticky visual. pin: true, scrub: 1, start: "top top", end: "+=300%". The scrub value (1-2) controls lag — lower feels snappier.
Progress-driven state
Map self.progress (0-1) to discrete story beats with gsap.utils.mapRange. Avoid too-fine-grained updates — 4-6 beats per section is readable; 20 beats is overwhelming.
Mobile fallback
Pinning on mobile causes layout thrash. Use ScrollTrigger.matchMedia to swap scroll-driven animations for static reveals below 768px.
See web-scrollytelling for full patterns: horizontal scroll, canvas-based sequences, video scrubbing, and performance profiling.
web-micro-interactions
Goal: Every interactive element has a designed hover, focus, active, and feedback state.
Key patterns:
Button states as a system
Define all five states in CSS custom properties: default, hover, focus-visible, active, disabled. Disabled state must not use pointer-events: none alone — add aria-disabled and handle keyboard.
Skeleton screens over spinners
Spinners communicate waiting with no information. Skeletons communicate the shape of what's loading. Use animation: shimmer 1.5s infinite on a gradient background-position shift.
Optimistic UI pattern
On form submit, immediately update the UI to the success state. Roll back with an error toast if the request fails. Never make users wait for confirmation of low-risk actions.
See web-micro-interactions for full patterns: toggle animations, drag handles, progress indicators, and notification badge behavior.
4. Tier 2 — Integration Skills
web-auth
Goal: Secure, usable authentication without reinventing session management.
Key patterns:
Use a provider, not homebrew
Clerk, Auth.js, Supabase Auth, or Firebase Auth. Rolling your own session tokens, password hashing, and refresh logic is a security liability — not a feature.
Protected route pattern
Check session server-side on every protected request, not just on client mount. Client-side guards are UX only — they are not security.
OAuth error handling
Always handle error and error_description query params on the callback route. Users who deny OAuth consent land back on your app — if you don't handle the error param, they see a broken page.
See web-auth for full patterns: magic links, passkeys, role-based access, JWT rotation, and middleware guard patterns.
web-ecommerce
Goal: Cart, product, and checkout flows that convert.
Key patterns:
Cart persistence
Sync cart to localStorage and to a server-side session if the user is logged in. Anonymous carts must survive page reload. Merge anonymous + logged-in carts on sign-in.
Checkout field minimalism
Every additional field reduces conversion. Collect only what you need to ship. Defer account creation to post-purchase — "guest checkout" is not optional.
Product image zoom
Mobile: pinch-to-zoom on the native image. Desktop: CSS transform: scale() on hover with overflow: hidden on the container. Never implement custom touch handlers for zoom.
See web-ecommerce for full patterns: Stripe integration, inventory checks, shipping calculator, upsell placement, and abandoned cart recovery.
web-email-capture
Goal: High-converting lead capture with deliverability hygiene.
Key patterns:
Exit-intent timing
Trigger the modal on mouseleave targeting the document (not the window). Add a 3-second page-time minimum and a 30-day cookie to suppress repeat shows.
Double opt-in flow
Send confirmation immediately on signup. Confirmation email subject line: "Confirm your email — one click" — not "Welcome." Unconfirmed subscribers degrade sender reputation.
Lead magnet specificity
"Free guide" converts less than "The 7-step checklist we use to cut proposal time in half — PDF." Specificity signals value.
See web-email-capture for full patterns: Mailchimp/ConvertKit/Resend integration, inline vs. modal placement testing, and GDPR consent handling.
web-analytics
Goal: Accurate event tracking that connects to business outcomes.
Key patterns:
Event naming convention
Use object_action format: signup_completed, checkout_started, video_played. Avoid vague names like click or button_pressed — they are unactionable in reports.
Funnel instrumentation order
Track the exit point before the entry point. If checkout completion is the goal, instrument checkout_completed first, then work backward through checkout_started, cart_viewed, product_viewed.
First-party over third-party
Plausible, PostHog, or Umami over GA4 for privacy-first projects. If using GA4, proxy the script through your own domain to survive adblocker blocking.
See web-analytics for full patterns: custom dimensions, cohort tracking, A/B test result reading, and Segment integration.
5. Tier 3 — Advanced Skills
web-og-images
Goal: Per-page Open Graph images generated dynamically at build or request time.
Key patterns:
Vercel OG / @vercel/og
Use JSX-in-edge-function approach for Next.js. Generate at the edge, cache with Cache-Control: public, max-age=31536000, immutable. Regenerate only when content changes.
Design constraints
OG images render at 1200x630. Use minimum 48px font size — smaller type disappears in feed previews. Test in the Twitter Card Validator and LinkedIn Post Inspector before shipping.
Fallback image
Always define a static /og-default.png in <meta> as the fallback. Dynamic generation can fail; a missing OG image makes shared links look broken.
See web-og-images for full patterns: Satori for non-Next.js, font loading in edge functions, screenshot-based generation with Playwright, and cache invalidation.
web-pwa
Goal: Installable, offline-capable web apps with push notification support.
Key patterns:
Service worker scope
Register from the root (/sw.js) so the scope covers the entire app. A service worker at /app/sw.js only controls routes under /app/.
Cache strategy by resource type
- HTML: network-first (always fresh shell)
- JS/CSS with hash: cache-first (immutable assets)
- API responses: stale-while-revalidate
- Images: cache-first with 30-day expiry
Install prompt deferral
Capture beforeinstallprompt, suppress the browser default, and show your own install CTA at a moment of demonstrated value (after 3 visits, after a key action). Do not show it on first page load.
See web-pwa for full patterns: Workbox configuration, push notification subscription flow, background sync, and iOS Safari install prompt workarounds.
web-maps
Goal: Performant, accessible maps with markers and optional routing.
Key patterns:
Lazy-load the map library
Mapbox GL JS is 280kb gzipped. Load it only when the map container enters the viewport using IntersectionObserver. Placeholder: a static image of the map area via the Static Tiles API.
Marker clustering
Above 50 markers, clustering is required for performance and readability. Use supercluster for Mapbox or the built-in clustering for Google Maps. Uncluster at zoom 14+.
Accessibility
Maps are not keyboard-navigable by default. Provide a text alternative: a list of locations with addresses. Use role="application" on the map container and aria-label describing what the map shows.
See web-maps for full patterns: Mapbox vs. Google Maps decision matrix, custom marker design, geolocation, routing via Directions API, and choropleth overlays.
web-realtime
Goal: Live updates, presence, and collaborative features with minimal backend complexity.
Key patterns:
WebSocket vs. SSE decision
Use Server-Sent Events (SSE) for one-way server-to-client streams (notifications, live scores, feed updates). Use WebSocket for bidirectional (chat, collaborative editing, presence). SSE works through HTTP/2 multiplexing — no upgrade required.
Reconnection with exponential backoff
Never reconnect immediately on disconnect. Start at 1s, double each attempt, cap at 30s, add jitter. Without backoff, a server restart causes a thundering herd of simultaneous reconnections.
Optimistic UI + conflict resolution
For collaborative features, apply local changes immediately. On server conflict (someone else edited the same field), show a non-blocking inline diff — never silently discard the user's change.
See web-realtime for full patterns: Supabase Realtime, Pusher/Ably integration, CRDT basics, presence indicators, and typing state broadcasting.
web-i18n
Goal: Multi-language support with locale routing, RTL layout, and number/date formatting.
Key patterns:
Locale routing strategy
Prefer path-based routing (/en/, /fr/) over subdomain (en.site.com) for SEO and caching simplicity. Use hreflang tags on every page pointing to all locale variants.
Translation key naming
Use dot-notated namespaces: checkout.summary.total, nav.links.about. Flat keys (checkout_summary_total) become unmanageable past 200 strings. Group by page or feature, not by component.
RTL layout
Use CSS logical properties (margin-inline-start not margin-left, padding-block-end not padding-bottom) from the start. RTL retrofit of physical properties is expensive. Set dir="rtl" on <html> and test Hebrew or Arabic early.
See web-i18n for full patterns: next-intl / i18next / Paraglide setup, pluralization rules, date/currency formatting with Intl, and translation file management with Crowdin or Localazy.
6. Stack Decision Guide
Landing page (marketing, SaaS, product)
Required: web-copywriting, web-forms, web-animations-gsap, web-micro-interactions, web-og-images, web-analytics, web-email-capture
Optional: web-scrollytelling (hero story section), web-i18n (multi-market)
Avoid overbuilding: auth, maps, realtime — none of these belong on a landing page unless the product requires them.
SaaS app (logged-in product)
Required: web-auth, web-forms, web-analytics, web-micro-interactions, web-realtime (if collaborative), web-pwa (if mobile-critical)
Optional: web-i18n (if selling internationally), web-og-images (if user-shareable content), web-email-capture (for in-app upsell)
Skip: web-scrollytelling, web-animations-gsap (unless you have a marketing page attached)
Ecommerce store
Required: web-ecommerce, web-forms, web-analytics, web-micro-interactions, web-og-images, web-email-capture
Optional: web-auth (accounts vs. guest checkout tradeoff — see web-auth), web-maps (store locator), web-pwa (repeat buyer mobile experience)
Skip: web-realtime, web-scrollytelling (unless brand storytelling is a differentiator)
Portfolio / creative site
Required: web-animations-gsap, web-scrollytelling, web-micro-interactions, web-og-images, web-copywriting
Optional: web-forms (contact form), web-analytics (lightweight — Plausible)
Skip: auth, ecommerce, realtime, i18n — unless the brief specifically calls for them.
Content site / blog / publication
Required: web-copywriting, web-analytics, web-email-capture, web-og-images, web-i18n (if multi-language), web-pwa (if offline reading matters)
Optional: web-forms (comments, contact), web-maps (if location content)
Skip: ecommerce, realtime, auth (unless subscriber-gated content)
7. Related Skills
- ui-ux-pro-max — Design system patterns, component hierarchy, and UX decision frameworks. Use this when you need to design before you build.
- frontend-design-direction — Visual direction setting: choosing a style, building a palette, typography pairing. Use this before writing any CSS.
- motion-advanced — Deep GSAP, Framer Motion, and CSS animation patterns beyond what web-animations-gsap covers. Use for complex timeline choreography or physics-based motion.
- remotion-video-creation — Programmatic video generation with React. Use when you need rendered video exports, not just in-browser animation.
- awesome-websites — Curated references and teardowns of exceptional web work. Use for inspiration and benchmarking before starting a high-polish project.
1---2name: web-complete3description: The complete web development skill suite — all 14 specialized skills in one. Covers copywriting, forms, GSAP animations, scrollytelling, micro-interactions, auth, ecommerce, email capture, analytics, OG images, PWA, maps, real-time features, and i18n. Use this as your entry point, then drill into specific skills as needed.4origin: community5tags: [web, complete, full-stack, landing-page, ecommerce, pwa, i18n, realtime, gsap, auth]6metadata:7 source: https://skillmd.com/skills/dinaf2026-web/web-complete8---910# web-complete — Master Web Development Skill Suite1112## 1. Overview1314This skill is the hub for all 14 web development sub-skills organized across three tiers. Use it to orient yourself, then invoke the specific sub-skill for deep patterns.1516**How to use this suite:**17- Start here to identify which skills apply to your current build18- Use the Quick Reference Table to pick the right sub-skill19- Follow the Stack Decision Guide when combining skills for a specific project type20- Each skill section below gives 2-3 actionable patterns — the full treatment lives in the named sub-skill2122**The three tiers:**23- **Tier 1 — Core:** Patterns every web project needs (copy, forms, motion, scroll)24- **Tier 2 — Integrations:** Third-party systems that require deliberate wiring (auth, payments, email, analytics)25- **Tier 3 — Advanced:** Capabilities that differentiate production apps (PWA, maps, realtime, i18n, OG images)2627---2829## 2. Quick Reference Table3031| Skill | One-line description | Reach for it when... |32|---|---|---|33| web-copywriting | Conversion-first copy patterns | You're writing headlines, CTAs, value props, or pricing copy |34| web-forms | Accessible, validated forms | You need inputs, multi-step flows, or server-side validation |35| web-animations-gsap | GSAP animation system | You want timeline-driven, scroll-triggered, or SVG animations |36| web-scrollytelling | Scroll-driven narrative UI | You're building a story section pinned to scroll progress |37| web-micro-interactions | Hover, focus, feedback states | Buttons, toggles, loaders, skeleton screens need polish |38| web-auth | Authentication flows | Login, signup, OAuth, session management, protected routes |39| web-ecommerce | Cart, checkout, product UI | You're building a store, product page, or checkout flow |40| web-email-capture | Lead capture and opt-in flows | Newsletter signups, waitlists, lead magnets |41| web-analytics | Event tracking and funnels | You need pageview tracking, conversion events, or A/B setup |42| web-og-images | Dynamic Open Graph image generation | Social sharing previews need to be generated per-page |43| web-pwa | Progressive Web App patterns | Offline support, install prompt, service worker, push notifications |44| web-maps | Interactive maps and geolocation | You need embedded maps, markers, clustering, or routing |45| web-realtime | WebSocket and live update patterns | Chat, live scores, collaborative editing, presence indicators |46| web-i18n | Internationalization and localization | Multi-language support, locale routing, RTL layout |4748---4950## 3. Tier 1 — Core Skills5152### web-copywriting5354**Goal:** Write copy that converts — not copy that describes.5556**Key patterns:**57581. **Problem-first headline structure**59 Lead with the pain, not the product. "Stop losing clients to slow proposals" outperforms "Proposal software for agencies." Follow with the outcome in the subheadline.60612. **CTA specificity rule**62 Replace vague verbs (Get started, Learn more) with outcome verbs tied to the offer. "Send my first proposal free" converts higher than "Sign up."63643. **Pricing page anchoring**65 Always show the highest tier first. Users anchor to the first price they see — everything below feels like a deal.6667See `web-copywriting` for full patterns: benefit ladders, objection handling, microcopy for error states, and testimonial placement rules.6869---7071### web-forms7273**Goal:** Forms that are accessible, validate correctly, and feel fast.7475**Key patterns:**76771. **Inline validation timing**78 Validate on `blur` for most fields, not on `input`. Exception: password strength meters validate live. Never validate on submit-only — users hate discovering errors late.79802. **Error message anatomy**81 Every error needs three parts: what went wrong, why it matters, how to fix it. "Invalid email" fails all three. "Email must include @ — check for typos like gmail,com" passes.82833. **Multi-step form state**84 Persist step data to `sessionStorage` on every field change. Users lose progress on accidental back-navigation — this is a silent conversion killer.8586See `web-forms` for full patterns: fieldset grouping, ARIA live regions, file upload UX, and server-side validation error mapping.8788---8990### web-animations-gsap9192**Goal:** Timeline-driven animations with scroll integration.9394**Key patterns:**95961. **Timeline registration**97 Always register plugins at the top of the module, not inside components or effects. `gsap.registerPlugin(ScrollTrigger, SplitText)` called twice causes duplicate registration warnings.98992. **ScrollTrigger cleanup**100 In React/Vue, kill all ScrollTrigger instances in the cleanup function. Use `ScrollTrigger.getAll().forEach(t => t.kill())` or scope to a context: `ctx.revert()`.1011023. **Stagger from center**103 For grid reveals, `stagger: { from: "center", amount: 0.6 }` reads more intentional than sequential stagger. Combine with `autoAlpha` (not `opacity`) so hidden elements don't take up interaction area.104105See `web-animations-gsap` for full patterns: SVG path drawing, morphing, flip animations, and matchMedia for reduced-motion.106107---108109### web-scrollytelling110111**Goal:** Scroll-driven narrative where the story advances as the user scrolls.112113**Key patterns:**1141151. **Pin + scrub anatomy**116 The trigger element is the section container. The pinned element is the sticky visual. `pin: true`, `scrub: 1`, `start: "top top"`, `end: "+=300%"`. The `scrub` value (1-2) controls lag — lower feels snappier.1171182. **Progress-driven state**119 Map `self.progress` (0-1) to discrete story beats with `gsap.utils.mapRange`. Avoid too-fine-grained updates — 4-6 beats per section is readable; 20 beats is overwhelming.1201213. **Mobile fallback**122 Pinning on mobile causes layout thrash. Use `ScrollTrigger.matchMedia` to swap scroll-driven animations for static reveals below 768px.123124See `web-scrollytelling` for full patterns: horizontal scroll, canvas-based sequences, video scrubbing, and performance profiling.125126---127128### web-micro-interactions129130**Goal:** Every interactive element has a designed hover, focus, active, and feedback state.131132**Key patterns:**1331341. **Button states as a system**135 Define all five states in CSS custom properties: default, hover, focus-visible, active, disabled. Disabled state must not use `pointer-events: none` alone — add `aria-disabled` and handle keyboard.1361372. **Skeleton screens over spinners**138 Spinners communicate waiting with no information. Skeletons communicate the shape of what's loading. Use `animation: shimmer 1.5s infinite` on a gradient background-position shift.1391403. **Optimistic UI pattern**141 On form submit, immediately update the UI to the success state. Roll back with an error toast if the request fails. Never make users wait for confirmation of low-risk actions.142143See `web-micro-interactions` for full patterns: toggle animations, drag handles, progress indicators, and notification badge behavior.144145---146147## 4. Tier 2 — Integration Skills148149### web-auth150151**Goal:** Secure, usable authentication without reinventing session management.152153**Key patterns:**1541551. **Use a provider, not homebrew**156 Clerk, Auth.js, Supabase Auth, or Firebase Auth. Rolling your own session tokens, password hashing, and refresh logic is a security liability — not a feature.1571582. **Protected route pattern**159 Check session server-side on every protected request, not just on client mount. Client-side guards are UX only — they are not security.1601613. **OAuth error handling**162 Always handle `error` and `error_description` query params on the callback route. Users who deny OAuth consent land back on your app — if you don't handle the error param, they see a broken page.163164See `web-auth` for full patterns: magic links, passkeys, role-based access, JWT rotation, and middleware guard patterns.165166---167168### web-ecommerce169170**Goal:** Cart, product, and checkout flows that convert.171172**Key patterns:**1731741. **Cart persistence**175 Sync cart to `localStorage` and to a server-side session if the user is logged in. Anonymous carts must survive page reload. Merge anonymous + logged-in carts on sign-in.1761772. **Checkout field minimalism**178 Every additional field reduces conversion. Collect only what you need to ship. Defer account creation to post-purchase — "guest checkout" is not optional.1791803. **Product image zoom**181 Mobile: pinch-to-zoom on the native image. Desktop: CSS `transform: scale()` on hover with `overflow: hidden` on the container. Never implement custom touch handlers for zoom.182183See `web-ecommerce` for full patterns: Stripe integration, inventory checks, shipping calculator, upsell placement, and abandoned cart recovery.184185---186187### web-email-capture188189**Goal:** High-converting lead capture with deliverability hygiene.190191**Key patterns:**1921931. **Exit-intent timing**194 Trigger the modal on `mouseleave` targeting the `document` (not the window). Add a 3-second page-time minimum and a 30-day cookie to suppress repeat shows.1951962. **Double opt-in flow**197 Send confirmation immediately on signup. Confirmation email subject line: "Confirm your email — one click" — not "Welcome." Unconfirmed subscribers degrade sender reputation.1981993. **Lead magnet specificity**200 "Free guide" converts less than "The 7-step checklist we use to cut proposal time in half — PDF." Specificity signals value.201202See `web-email-capture` for full patterns: Mailchimp/ConvertKit/Resend integration, inline vs. modal placement testing, and GDPR consent handling.203204---205206### web-analytics207208**Goal:** Accurate event tracking that connects to business outcomes.209210**Key patterns:**2112121. **Event naming convention**213 Use `object_action` format: `signup_completed`, `checkout_started`, `video_played`. Avoid vague names like `click` or `button_pressed` — they are unactionable in reports.2142152. **Funnel instrumentation order**216 Track the exit point before the entry point. If checkout completion is the goal, instrument `checkout_completed` first, then work backward through `checkout_started`, `cart_viewed`, `product_viewed`.2172183. **First-party over third-party**219 Plausible, PostHog, or Umami over GA4 for privacy-first projects. If using GA4, proxy the script through your own domain to survive adblocker blocking.220221See `web-analytics` for full patterns: custom dimensions, cohort tracking, A/B test result reading, and Segment integration.222223---224225## 5. Tier 3 — Advanced Skills226227### web-og-images228229**Goal:** Per-page Open Graph images generated dynamically at build or request time.230231**Key patterns:**2322331. **Vercel OG / @vercel/og**234 Use JSX-in-edge-function approach for Next.js. Generate at the edge, cache with `Cache-Control: public, max-age=31536000, immutable`. Regenerate only when content changes.2352362. **Design constraints**237 OG images render at 1200x630. Use minimum 48px font size — smaller type disappears in feed previews. Test in the Twitter Card Validator and LinkedIn Post Inspector before shipping.2382393. **Fallback image**240 Always define a static `/og-default.png` in `<meta>` as the fallback. Dynamic generation can fail; a missing OG image makes shared links look broken.241242See `web-og-images` for full patterns: Satori for non-Next.js, font loading in edge functions, screenshot-based generation with Playwright, and cache invalidation.243244---245246### web-pwa247248**Goal:** Installable, offline-capable web apps with push notification support.249250**Key patterns:**2512521. **Service worker scope**253 Register from the root (`/sw.js`) so the scope covers the entire app. A service worker at `/app/sw.js` only controls routes under `/app/`.2542552. **Cache strategy by resource type**256 - HTML: network-first (always fresh shell)257 - JS/CSS with hash: cache-first (immutable assets)258 - API responses: stale-while-revalidate259 - Images: cache-first with 30-day expiry2602613. **Install prompt deferral**262 Capture `beforeinstallprompt`, suppress the browser default, and show your own install CTA at a moment of demonstrated value (after 3 visits, after a key action). Do not show it on first page load.263264See `web-pwa` for full patterns: Workbox configuration, push notification subscription flow, background sync, and iOS Safari install prompt workarounds.265266---267268### web-maps269270**Goal:** Performant, accessible maps with markers and optional routing.271272**Key patterns:**2732741. **Lazy-load the map library**275 Mapbox GL JS is 280kb gzipped. Load it only when the map container enters the viewport using IntersectionObserver. Placeholder: a static image of the map area via the Static Tiles API.2762772. **Marker clustering**278 Above 50 markers, clustering is required for performance and readability. Use `supercluster` for Mapbox or the built-in clustering for Google Maps. Uncluster at zoom 14+.2792803. **Accessibility**281 Maps are not keyboard-navigable by default. Provide a text alternative: a list of locations with addresses. Use `role="application"` on the map container and `aria-label` describing what the map shows.282283See `web-maps` for full patterns: Mapbox vs. Google Maps decision matrix, custom marker design, geolocation, routing via Directions API, and choropleth overlays.284285---286287### web-realtime288289**Goal:** Live updates, presence, and collaborative features with minimal backend complexity.290291**Key patterns:**2922931. **WebSocket vs. SSE decision**294 Use Server-Sent Events (SSE) for one-way server-to-client streams (notifications, live scores, feed updates). Use WebSocket for bidirectional (chat, collaborative editing, presence). SSE works through HTTP/2 multiplexing — no upgrade required.2952962. **Reconnection with exponential backoff**297 Never reconnect immediately on disconnect. Start at 1s, double each attempt, cap at 30s, add jitter. Without backoff, a server restart causes a thundering herd of simultaneous reconnections.2982993. **Optimistic UI + conflict resolution**300 For collaborative features, apply local changes immediately. On server conflict (someone else edited the same field), show a non-blocking inline diff — never silently discard the user's change.301302See `web-realtime` for full patterns: Supabase Realtime, Pusher/Ably integration, CRDT basics, presence indicators, and typing state broadcasting.303304---305306### web-i18n307308**Goal:** Multi-language support with locale routing, RTL layout, and number/date formatting.309310**Key patterns:**3113121. **Locale routing strategy**313 Prefer path-based routing (`/en/`, `/fr/`) over subdomain (`en.site.com`) for SEO and caching simplicity. Use `hreflang` tags on every page pointing to all locale variants.3143152. **Translation key naming**316 Use dot-notated namespaces: `checkout.summary.total`, `nav.links.about`. Flat keys (`checkout_summary_total`) become unmanageable past 200 strings. Group by page or feature, not by component.3173183. **RTL layout**319 Use CSS logical properties (`margin-inline-start` not `margin-left`, `padding-block-end` not `padding-bottom`) from the start. RTL retrofit of physical properties is expensive. Set `dir="rtl"` on `<html>` and test Hebrew or Arabic early.320321See `web-i18n` for full patterns: next-intl / i18next / Paraglide setup, pluralization rules, date/currency formatting with `Intl`, and translation file management with Crowdin or Localazy.322323---324325## 6. Stack Decision Guide326327### Landing page (marketing, SaaS, product)328329**Required:** web-copywriting, web-forms, web-animations-gsap, web-micro-interactions, web-og-images, web-analytics, web-email-capture330331**Optional:** web-scrollytelling (hero story section), web-i18n (multi-market)332333**Avoid overbuilding:** auth, maps, realtime — none of these belong on a landing page unless the product requires them.334335---336337### SaaS app (logged-in product)338339**Required:** web-auth, web-forms, web-analytics, web-micro-interactions, web-realtime (if collaborative), web-pwa (if mobile-critical)340341**Optional:** web-i18n (if selling internationally), web-og-images (if user-shareable content), web-email-capture (for in-app upsell)342343**Skip:** web-scrollytelling, web-animations-gsap (unless you have a marketing page attached)344345---346347### Ecommerce store348349**Required:** web-ecommerce, web-forms, web-analytics, web-micro-interactions, web-og-images, web-email-capture350351**Optional:** web-auth (accounts vs. guest checkout tradeoff — see web-auth), web-maps (store locator), web-pwa (repeat buyer mobile experience)352353**Skip:** web-realtime, web-scrollytelling (unless brand storytelling is a differentiator)354355---356357### Portfolio / creative site358359**Required:** web-animations-gsap, web-scrollytelling, web-micro-interactions, web-og-images, web-copywriting360361**Optional:** web-forms (contact form), web-analytics (lightweight — Plausible)362363**Skip:** auth, ecommerce, realtime, i18n — unless the brief specifically calls for them.364365---366367### Content site / blog / publication368369**Required:** web-copywriting, web-analytics, web-email-capture, web-og-images, web-i18n (if multi-language), web-pwa (if offline reading matters)370371**Optional:** web-forms (comments, contact), web-maps (if location content)372373**Skip:** ecommerce, realtime, auth (unless subscriber-gated content)374375---376377## 7. Related Skills378379- **ui-ux-pro-max** — Design system patterns, component hierarchy, and UX decision frameworks. Use this when you need to design before you build.380- **frontend-design-direction** — Visual direction setting: choosing a style, building a palette, typography pairing. Use this before writing any CSS.381- **motion-advanced** — Deep GSAP, Framer Motion, and CSS animation patterns beyond what web-animations-gsap covers. Use for complex timeline choreography or physics-based motion.382- **remotion-video-creation** — Programmatic video generation with React. Use when you need rendered video exports, not just in-browser animation.383- **awesome-websites** — Curated references and teardowns of exceptional web work. Use for inspiration and benchmarking before starting a high-polish project.