vite-react-best-practices

frontendclaudiocebpaz

Comprehensive React and Vite SPA performance, architecture, and deployment guidelines. Use this skill when building, reviewing, or refactoring React applications built with Vite (SPA). Covers Vite-specific build configurations, static hosting requirements, and core React performance patterns.

Install

npx skills add https://github.com/claudiocebpaz/vite-react-best-practices --skill vite-react-best-practices

SKILL.md

---name: vite-react-best-practicesdescription: Comprehensive React and Vite SPA performance, architecture, and deployment guidelines. Use this skill when building, reviewing, or refactoring React applications built with Vite (SPA). Covers Vite-specific build configurations, static hosting requirements, and core React performance patterns.license: MITmetadata: author: ant-gravityversion: 1.1.0---

Vite React Best Practices

A senior-level guide for building production-ready React Single Page Applications (SPAs) with Vite.

When to Apply

Reference these guidelines when:

Setting up a new Vite + React project
Configuring build pipelines and CI/CD for SPAs
Troubleshooting production build or caching issues
Refactoring React components for performance

Rule Categories

1. Vite SPA Deployment (CRITICAL)

Static Rewrites - Mandatory for client-side routing.
Caching Strategy - Immutable assets, no-cache index.html.
Build Validation - Preview before push.
Environment Variables - VITE_ prefix and security.

2. React Core Performance

Route Splitting - Lazy load pages.
Server State - Use React Query/SWR.
Memoization - When to use useMemo/useCallback.
Image Optimization - CLS prevention.

3. Architecture & Cleanup

Colocation - Feature-based structure.
Anti-Patterns: Import from Dist - Avoid bundling twice.
Troubleshooting - Common Vite fixes.

Full Compiled Document

For the complete guide with all rules expanded: AGENTS.md

Related skills

vercel-react-best-practicesvercel-labs751KReact and Next.js performance optimization guidelines from Vercel Engineering. This skill should be used when writing, reviewing, or refactoring React/Next.js code to ensure optimal performance patterns. Triggers on tasks involving React components, Next.js pages, data fetching, bundle optimization, or performance improvements.vercel-composition-patternsvercel-labs361KReact composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.vercel-react-view-transitionsvercel-labs135KGuide for implementing smooth, native-feeling animations using React's View Transition API (`<ViewTransition>` component, `addTransitionType`, and CSS view transition pseudo-elements). Use this skill whenever the user wants to add page transitions, animate route changes, create shared element animations, animate enter/exit of components, animate list reorder, implement directional (forward/back) navigation animations, or integrate view transitions in Next.js. Also use when the user mentions view pick-ui-libraryemilkowalski124KPick the right library for a given frontend task from a curated, opinionated list — numbers, OTP inputs, charts, command menus, virtualization, drag and drop, toasts, state, styling, and more. Only runs when explicitly invoked; it does not trigger on its own.