vercel-react-best-practices
React and Next.js performance optimization guidelines from Vercel Engineering
- License 许可
- MIT
- 所属仓库
- HigorAlves/orc
- 最近更新
- 2026-11-07
- Stars
- ★ 7
- Forks
- 0
01 前言 Front Matter
- name
- vercel-react-best-practices
- license
- MIT
- metadata
- { "author": "vercel", "version": "1.0.0" }
- description
- React and Next.js performance optimization guidelines from Vercel Engineering
- when_to_use
- Use when writing, reviewing, or refactoring React/Next.js components, data fetching, or bundles for performance.
02 资源文件 76
- 参考文档AGENTS.md105.7 KB
- 参考文档metadata.json921 B
- 参考文档README.md3.3 KB
- 参考文档references/RULE-INDEX.md5.4 KB
- 参考文档rules/_sections.md1.5 KB
- 参考文档rules/_template.md631 B
- 参考文档rules/advanced-effect-event-deps.md1.8 KB
- 参考文档rules/advanced-event-handler-refs.md1.4 KB
- 参考文档rules/advanced-init-once.md958 B
- 参考文档rules/advanced-use-latest.md1.0 KB
- 参考文档rules/async-api-routes.md1.1 KB
- 参考文档rules/async-cheap-condition-before-await.md1.2 KB
- 参考文档rules/async-defer-await.md2.2 KB
- 参考文档rules/async-dependencies.md1.3 KB
- 参考文档rules/async-parallel.md654 B
- 参考文档rules/async-suspense-boundaries.md2.5 KB
- 参考文档rules/bundle-analyzable-paths.md2.3 KB
- 参考文档rules/bundle-barrel-imports.md2.7 KB
- 参考文档rules/bundle-conditional.md949 B
- 参考文档rules/bundle-defer-third-party.md920 B
- 参考文档rules/bundle-dynamic-imports.md791 B
- 参考文档rules/bundle-preload.md1.1 KB
- 参考文档rules/client-event-listeners.md1.9 KB
- 参考文档rules/client-localstorage-schema.md1.9 KB
- 参考文档rules/client-passive-event-listeners.md1.6 KB
- 参考文档rules/client-swr-dedup.md1.1 KB
- 参考文档rules/js-batch-dom-css.md3.2 KB
- 参考文档rules/js-cache-function-results.md1.9 KB
- 参考文档rules/js-cache-property-access.md532 B
- 参考文档rules/js-cache-storage.md1.6 KB
- 参考文档rules/js-combine-iterations.md753 B
- 参考文档rules/js-early-exit.md1.1 KB
- 参考文档rules/js-flatmap-filter.md1.4 KB
- 参考文档rules/js-hoist-regexp.md1.0 KB
- 参考文档rules/js-index-maps.md837 B
- 参考文档rules/js-length-check-first.md1.7 KB
- 参考文档rules/js-min-max-loop.md2.2 KB
- 参考文档rules/js-request-idle-callback.md2.6 KB
- 参考文档rules/js-set-map-lookups.md532 B
- 参考文档rules/js-tosorted-immutable.md1.7 KB
- 参考文档rules/rendering-activity.md564 B
- 参考文档rules/rendering-animate-svg-wrapper.md1.2 KB
- 参考文档rules/rendering-conditional-render.md980 B
- 参考文档rules/rendering-content-visibility.md815 B
- 参考文档rules/rendering-hoist-jsx.md1.0 KB
- 参考文档rules/rendering-hydration-no-flicker.md2.3 KB
- 参考文档rules/rendering-hydration-suppress-warning.md872 B
- 参考文档rules/rendering-resource-hints.md2.5 KB
- 参考文档rules/rendering-script-defer-async.md1.8 KB
- 参考文档rules/rendering-svg-precision.md588 B
- 参考文档rules/rendering-usetransition-loading.md2.0 KB
- 参考文档rules/rerender-defer-reads.md973 B
- 参考文档rules/rerender-dependencies.md824 B
- 参考文档rules/rerender-derived-state-no-effect.md1.2 KB
- 参考文档rules/rerender-derived-state.md728 B
- 参考文档rules/rerender-functional-setstate.md2.9 KB
- 参考文档rules/rerender-lazy-state-init.md2.0 KB
- 参考文档rules/rerender-memo-with-default-value.md1.1 KB
- 参考文档rules/rerender-memo.md1.1 KB
- 参考文档rules/rerender-move-effect-to-event.md1.2 KB
- 参考文档rules/rerender-no-inline-components.md2.1 KB
- 参考文档rules/rerender-simple-expression-in-memo.md1018 B
- 参考文档rules/rerender-split-combined-hooks.md1.8 KB
- 参考文档rules/rerender-transitions.md1.0 KB
- 参考文档rules/rerender-use-deferred-value.md1.8 KB
- 参考文档rules/rerender-use-ref-transient-values.md1.7 KB
- 参考文档rules/server-after-nonblocking.md2.0 KB
- 参考文档rules/server-auth-actions.md2.6 KB
- 参考文档rules/server-cache-lru.md1.3 KB
- 参考文档rules/server-cache-react.md2.2 KB
- 参考文档rules/server-dedup-props.md2.0 KB
- 参考文档rules/server-hoist-static-io.md4.3 KB
- 参考文档rules/server-no-shared-module-state.md1.7 KB
- 参考文档rules/server-parallel-fetching.md1.5 KB
- 参考文档rules/server-parallel-nested-fetching.md992 B
- 参考文档rules/server-serialization.md996 B
03 SKILL.md 正文
Vercel React Best Practices
Comprehensive performance optimization guide for React and Next.js applications, maintained by Vercel. Contains 70 rules across 8 categories, prioritized by impact to guide automated refactoring and code generation.
When to Apply
Reference these guidelines when:
- Writing new React components or Next.js pages
- Implementing data fetching (client or server-side)
- Reviewing code for performance issues
- Refactoring existing React/Next.js code
- Optimizing bundle size or load times
Rule Categories by Priority
| Priority | Category | Impact | Prefix |
|---|---|---|---|
| 1 | Eliminating Waterfalls | CRITICAL | async- |
| 2 | Bundle Size Optimization | CRITICAL | bundle- |
| 3 | Server-Side Performance | HIGH | server- |
| 4 | Client-Side Data Fetching | MEDIUM-HIGH | client- |
| 5 | Re-render Optimization | MEDIUM | rerender- |
| 6 | Rendering Performance | MEDIUM | rendering- |
| 7 | JavaScript Performance | LOW-MEDIUM | js- |
| 8 | Advanced Patterns | LOW | advanced- |
Quick Reference
Every rule id with a one-line summary, by category: RULE-INDEX.md. Read it to pick the rules that apply to the code at hand; each id names its file under rules/.
How to Use
Read individual rule files for detailed explanations and code examples:
rules/async-parallel.md
rules/bundle-barrel-imports.md
Each rule file contains:
- Brief explanation of why it matters
- Incorrect code example with explanation
- Correct code example with explanation
- Additional context and references
Full Compiled Document
For the complete guide with all rules expanded: AGENTS.md
04 同仓库更多 Skills
writing-plans
Write a comprehensive implementation plan of bite-sized TDD tasks that an engineer with zero codebase context could execute — exact files, code, tests, and verification steps
writing-for-agents
orc's doctrine layer for writing any document an agent consumes — skills, AGENTS.md/CLAUDE.md, reference docs
workspace-mode
Use when cwd is a parent dir holding multiple sibling git repos — defines repo auto-detection, --repos/--repo/--all-repos/--this-repo precedence, per-repo dispatch, and linked-PR mechanics.
wizard
Generate an interactive bash wizard walking a human through work only they can perform — credentials, secrets, one-off migrations
wait-what
Stop and re-pitch — the last message did not land; say it again simply, in the project's own vocabulary.
vitest
Vitest fast unit testing framework powered by Vite with Jest-compatible API