OpenParable
Skip to content
← Back to skills

Using Reacticx

Development
using-reacticx

Using Reacticx is an Agent Skill for development published in the rit3zh/reacticx repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

Use when adding Reacticx components to a React Native or Expo project, when asked about "reacticx" or "reactctx" components, or when integrating animated UI primitives via the Reacticx CLI.

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/rit3zh/reacticx/blob/HEAD/skills/using-reacticx/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/using-reacticx, 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.

Using Reacticx

Overview

Reacticx is a copy-paste animated component library for React Native and Expo. Components are added to your project via CLI — there is no npm package to install.

Quick Reference

TaskCommand
Add a componentnpx reacticx add <cli-key>
Add to specific dirnpx reacticx add <cli-key> --dir src/components/ui
List all componentsnpx reacticx list
List by categorynpx reacticx list -c molecules

Use bunx, npx, or pnpm dlx depending on your package manager.

Setup

Configure output directory in component.config.json at project root:

{
  "outDir": "src/components/ui"
}

Implementation Pattern

  1. Check if the component already exists before adding.
  2. Run npx reacticx add <cli-key>.
  3. Install any missing dependencies listed in the component's docs.
  4. Import and use the component from your outDir.
  5. Run type-check and lint before committing.

Dependency Notes

  • Reacticx components depend on common RN animation libraries (Reanimated, Gesture Handler, Skia, etc.).
  • react-native-blur used by some components is a GitHub fork: sbaiahmed1/react-native-blur — install with npm install sbaiahmed1/react-native-blur (not the npm react-native-blur).
  • After adding any native dependency, rebuild the native target (e.g., npx expo run:ios) — a Metro restart alone is not enough.
  • react-native-skia is published as @shopify/react-native-skia on npm.

Component Catalog

See references/components.md for the full catalog of 95+ components organized by category (Base, Micro Interactions, Molecules, Organisms, Templates, Other). Each entry includes the CLI key, description, dependencies, and docs URL.

Common Mistakes

  • Installing react-native-blur from npm instead of the required GitHub fork (sbaiahmed1/react-native-blur).
  • Forgetting to rebuild after adding native dependencies.
  • Adding a component that already exists in outDir.
  • Missing a dependency — always check the component's docs page for the exact install command.