Skip to content

ever-co/ever-works / .cursor/skills/vercel-react-best-practices

vercel-react-best-practices

Verified

React 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.

FileKindSize
AGENTS.mdmarkdown58.3 KB
SKILL.mdskill md5.4 KB
rules/advanced-event-handler-refs.mdmarkdown1.4 KB
rules/advanced-use-latest.mdmarkdown1.2 KB
rules/async-api-routes.mdmarkdown1.1 KB
rules/async-defer-await.mdmarkdown1.9 KB
rules/async-dependencies.mdmarkdown943 B
rules/async-parallel.mdmarkdown650 B
rules/async-suspense-boundaries.mdmarkdown2.4 KB
rules/bundle-barrel-imports.mdmarkdown2.3 KB
rules/bundle-conditional.mdmarkdown843 B
rules/bundle-defer-third-party.mdmarkdown882 B
rules/bundle-dynamic-imports.mdmarkdown791 B
rules/bundle-preload.mdmarkdown1.1 KB
rules/client-event-listeners.mdmarkdown1.9 KB
rules/client-swr-dedup.mdmarkdown1.1 KB
rules/js-batch-dom-css.mdmarkdown1.8 KB
rules/js-cache-function-results.mdmarkdown1.9 KB
rules/js-cache-property-access.mdmarkdown534 B
rules/js-cache-storage.mdmarkdown1.6 KB
rules/js-combine-iterations.mdmarkdown765 B
rules/js-early-exit.mdmarkdown1.1 KB
rules/js-hoist-regexp.mdmarkdown1.0 KB
rules/js-index-maps.mdmarkdown835 B
rules/js-length-check-first.mdmarkdown1.7 KB
rules/js-min-max-loop.mdmarkdown2.0 KB
rules/js-set-map-lookups.mdmarkdown532 B
rules/js-tosorted-immutable.mdmarkdown1.7 KB
rules/rendering-activity.mdmarkdown557 B
rules/rendering-animate-svg-wrapper.mdmarkdown1.1 KB
rules/rendering-conditional-render.mdmarkdown936 B
rules/rendering-content-visibility.mdmarkdown786 B
rules/rendering-hoist-jsx.mdmarkdown990 B
rules/rendering-hydration-no-flicker.mdmarkdown2.2 KB
rules/rendering-svg-precision.mdmarkdown588 B
rules/rerender-defer-reads.mdmarkdown966 B
rules/rerender-dependencies.mdmarkdown823 B
rules/rerender-derived-state.mdmarkdown724 B
rules/rerender-functional-setstate.mdmarkdown2.9 KB
rules/rerender-lazy-state-init.mdmarkdown1.9 KB
rules/rerender-memo.mdmarkdown1.1 KB
rules/rerender-transitions.mdmarkdown1.0 KB
rules/server-after-nonblocking.mdmarkdown1.9 KB
rules/server-cache-lru.mdmarkdown1.3 KB
rules/server-cache-react.mdmarkdown680 B
rules/server-parallel-fetching.mdmarkdown1.4 KB
rules/server-serialization.mdmarkdown1000 B

rules/js-cache-storage.md

View on GitHub
---
title: Cache Storage API Calls
impact: LOW-MEDIUM
impactDescription: reduces expensive I/O
tags: javascript, localStorage, storage, caching, performance
---

## Cache Storage API Calls

`localStorage`, `sessionStorage`, and `document.cookie` are synchronous and expensive. Cache reads in memory.

**Incorrect (reads storage on every call):**

```typescript
function getTheme() {
	return localStorage.getItem('theme') ?? 'light';
}
// Called 10 times = 10 storage reads
```

**Correct (Map cache):**

```typescript
const storageCache = new Map<string, string | null>();

function getLocalStorage(key: string) {
	if (!storageCache.has(key)) {
		storageCache.set(key, localStorage.getItem(key));
	}
	return storageCache.get(key);
}

function setLocalStorage(key: string, value: string) {
	localStorage.setItem(key, value);
	storageCache.set(key, value); // keep cache in sync
}
```

Use a Map (not a hook) so it works everywhere: utilities, event handlers, not just React components.

**Cookie caching:**

```typescript
let cookieCache: Record<string, string> | null = null;

function getCookie(name: string) {
	if (!cookieCache) {
		cookieCache = Object.fromEntries(document.cookie.split('; ').map((c) => c.split('=')));
	}
	return cookieCache[name];
}
```

**Important (invalidate on external changes):**

If storage can change externally (another tab, server-set cookies), invalidate cache:

```typescript
window.addEventListener('storage', (e) => {
	if (e.key) storageCache.delete(e.key);
});

document.addEventListener('visibilitychange', () => {
	if (document.visibilityState === 'visible') {
		storageCache.clear();
	}
});
```
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