OpenParable
Skip to content
← Back to skills

React Class To Functional

Development
react-class-to-functional

React Class To Functional is an Agent Skill for development published in the cockroachdb/cockroach repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Convert React class components to functional components with hooks

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/cockroachdb/cockroach/blob/HEAD/pkg/ui/.claude/skills/react-class-to-functional/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/react-class-to-functional, but wait for my approval before writing files or running scripts.

Copying this prompt does not install or run the skill. Review third-party files before use.

React Class to Functional Component Converter

Convert the React class component at $ARGUMENTS to a functional component using React hooks.

Conversion Rules

State

  • this.state = { ... } → individual useState hooks
  • this.setState({ key: value }) → setter function
  • this.setState(prev => ...) → functional update form
  • Mutable objects (Set/Map) must be cloned on update:
    setExpandedRows(prev => { const next = new Set(prev); next.add(key); return next; });
    

Lifecycle → useEffect

ClassFunctional
componentDidMountuseEffect(fn, [])
componentDidUpdateuseEffect(fn) or useEffect(fn, [deps])
componentWillUnmountuseEffect(() => cleanup, [])
mount + unmountsingle useEffect with cleanup return

Other Mappings

  • React.createRef() → useRef(null)
  • static contextType → useContext(MyContext)
  • Bound methods / arrow class methods → local function inside functional component
  • Non-reactive instance variables (this.timer) → useRef
  • createSelector (reselect) → useMemo with explicit dependency array

Props and Defaults

  • this.props.x → destructured props
  • static defaultProps → default parameter values
  • Critical: mark defaultProps as optional (?) in the interface:
    interface Props { sortSetting?: SortSetting; }
    function Component({ sortSetting = defaultValue }: Props) { ... }
    

setState with Callback

this.setState(update, callback) has no direct hook equivalent. Use ref + useEffect:

const pendingRef = useRef(false);
const prevRef = useRef(value);

const onUpdate = useCallback(() => {
  pendingRef.current = true;
  setValue(newValue);
}, []);

useEffect(() => {
  if (pendingRef.current && prevRef.current !== value) {
    pendingRef.current = false;
    doCallback();
  }
  prevRef.current = value;
}, [value, doCallback]);

Generic Components

  • class MyTable extends SortedTable<Row> {} → const MyTable = SortedTable<Row>;
  • Exported type aliases require the props interface to also be exported (else "cannot be named" build errors)
  • TypeScript may fail to infer generics with spread props — add explicit type params: <SortedTable<Row> {...props} />

Workflow

  1. Read the file and summarize: state vars, lifecycle methods, refs, methods, generics, files extending this class
  2. Before converting each method, verify it's actually called — delete dead code, don't convert it
  3. Write the converted component, preserving imports/comments/exports and adding hook imports
  4. Search for and update dependent files that extend the class

Verification Checklist

  • All this. references removed
  • Hooks follow Rules of Hooks (top level, consistent order)
  • TypeScript types preserved; exports unchanged
  • defaultProps marked optional in interface
  • Exported type aliases have their props interfaces exported
  • Files extending the class updated to type alias pattern
  • No dead code converted (every useCallback is actually called)
  • No orphaned helpers (if logic was inlined, delete the original)
  • No unused destructured props
  • No failed intermediate attempts left behind
  • Within the appropriate directory with package.json, run ESLint (fix) and Tests