Imported from prowler-cloud/prowler (
skills/react-19/SKILL.md) via skills.sh. Install upstream withnpx skills add prowler-cloud/prowler --skill react-19. Copyright stays with the author (Apache-2.0).
No Manual Memoization (REQUIRED)
Prowler UI enables the React Compiler (reactCompiler: true in ui/next.config.js), so manual memoization is unnecessary. Lint rejects memo, useMemo, useCallback and default or namespace react imports, and runs the react-hooks compiler rules. For effects, follow no-use-effect.
// ✅ React Compiler handles optimization automatically
function Component({ items }) {
const filtered = items.filter(x => x.active);
const sorted = filtered.sort((a, b) => a.name.localeCompare(b.name));
const handleClick = (id) => {
console.log(id);
};
return <List items={sorted} onClick={handleClick} />;
}
// ❌ NEVER: Manual memoization
const filtered = useMemo(() => items.filter(x => x.active), [items]);
const handleClick = useCallback((id) => console.log(id), []);
Imports (REQUIRED)
// ✅ ALWAYS: Named imports
import { useState, useEffect, useRef } from "react";
// ❌ NEVER
import React from "react";
import * as React from "react";
Server Components First
// ✅ Server Component (default) - no directive
export default async function Page() {
const data = await fetchData();
return <ClientComponent data={data} />;
}
// ✅ Client Component - only when needed
"use client";
export function Interactive() {
const [state, setState] = useState(false);
return <button onClick={() => setState(!state)}>Toggle</button>;
}
When to use "use client"
- useState, useEffect, useRef, useContext
- Event handlers (onClick, onChange)
- Browser APIs (window, localStorage)
use() Hook
import { use } from "react";
// Read promises (suspends until resolved)
function Comments({ promise }) {
const comments = use(promise);
return comments.map(c => <div key={c.id}>{c.text}</div>);
}
// Conditional context (not possible with useContext!)
function Theme({ showTheme }) {
if (showTheme) {
const theme = use(ThemeContext);
return <div style={{ color: theme.primary }}>Themed</div>;
}
return <div>Plain</div>;
}
Actions & useActionState
// actions/feature/feature.ts
"use server";
// useActionState passes the previous state first, then the FormData
export async function submitForm(prevState: FormState, formData: FormData) {
await saveToDatabase(formData);
revalidatePath("/");
return { ok: true };
}
// Client component
"use client";
import { useActionState } from "react";
function Form() {
const [state, action, isPending] = useActionState(submitForm, { ok: false });
return (
<form action={action}>
<button disabled={isPending}>
{isPending ? "Saving..." : "Save"}
</button>
</form>
);
}
Most Prowler forms use react-hook-form + zodResolver and call the server action from handleSubmit instead (see prowler-ui).
react-hook-form Under the Compiler
The compiler caches blocks keyed on the stable form object. A form.formState.<field> read inside a cached expression never updates (a submit button stayed disabled this way), and form.watch() makes the compiler skip the whole component:
// ❌ Stale value or a skipped component
const mode = form.watch("mode");
const options = { canSubmit: form.formState.isValid };
// ✅ Subscribe through hooks
const mode = useWatch({ control: form.control, name: "mode" });
const { isValid, isSubmitting } = useFormState({ control: form.control });
react-hooks/incompatible-library reports watch() (and TanStack's useReactTable); stale formState reads have no lint rule. Unit tests (jsdom) do not compile with the React Compiler, so cover this in a *.integration.test.tsx.
ref as Prop (No forwardRef)
// ✅ React 19: ref is just a prop
function Input({ ref, ...props }) {
return <input ref={ref} {...props} />;
}
// ❌ Old way (unnecessary now)
const Input = forwardRef((props, ref) => <input ref={ref} {...props} />);
forwardRef still appears in the deprecated ui/components/ui/ shims; do not copy that pattern into new code.
