Using Reacticx
Developmentusing-reacticxUsing 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.
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
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
| Task | Command |
|---|---|
| Add a component | npx reacticx add <cli-key> |
| Add to specific dir | npx reacticx add <cli-key> --dir src/components/ui |
| List all components | npx reacticx list |
| List by category | npx reacticx list -c molecules |
Use
bunx,npx, orpnpm dlxdepending on your package manager.
Setup
Configure output directory in component.config.json at project root:
{
"outDir": "src/components/ui"
}
Implementation Pattern
- Check if the component already exists before adding.
- Run
npx reacticx add <cli-key>. - Install any missing dependencies listed in the component's docs.
- Import and use the component from your
outDir. - Run type-check and lint before committing.
Dependency Notes
- Reacticx components depend on common RN animation libraries (Reanimated, Gesture Handler, Skia, etc.).
react-native-blurused by some components is a GitHub fork:sbaiahmed1/react-native-blur— install withnpm install sbaiahmed1/react-native-blur(not the npmreact-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-skiais published as@shopify/react-native-skiaon 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-blurfrom 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.