ink

Use Ink components where Box replaces div and Text replaces span, laid out with Yoga flexbox. Call render() with your root component, handle keys with useInput, and await instance.waitUntilExit() before post-render cleanup.

Move immutable output like completed tasks and log lines into the Static component, which renders once and never re-renders. Also enable incrementalRendering in render options so only changed lines are redrawn.

Ink crashes when calling setRawMode on non-TTY stdin. Check isRawModeSupported from useStdin before rendering interactive prompts, and fall back to plain output or default values in non-interactive mode.

Every useInput hook in the tree fires unless you pass the isActive option. Set isActive conditionally, such as isActive: isFocused, so only the relevant component responds to keyboard input.

Use ink-testing-library, which provides render with lastFrame() for asserting output and stdin.write() for simulating input. For snapshot-style tests, use renderToString from ink with a fixed column width.

Ink 6.x requires ESM and pairs with React 19. Set module and moduleResolution to NodeNext in tsconfig, use the react-jsx automatic runtime, and add .js extensions to local imports even for .tsx source files.