react-native-reusables
shadcn/ui-style components for React Native with NativeWind v4, RN Primitives, and CLI scaffolding. Use when building Expo apps with copy-paste UI components, theming, or overlay patterns.
How do I install this agent skill?
npx skills add https://github.com/maikotrindade/awesome-react-native-skills --skill react-native-reusablesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides comprehensive documentation and best practices for the React Native Reusables library, a UI system for Expo and React Native. It covers project initialization, component scaffolding via CLI, and theme customization. No malicious patterns or security risks were detected.
- Socketpass
No alerts
- Snykwarn
Risk: MEDIUM · 1 issue
What does this agent skill do?
React Native Reusables
Targets NativeWind v4, Expo SDK 52+, and Expo Router v4. For Expo SDK tooling see the
react-native-exposkill. For standalone state/navigation patterns see thereact-native-ecosystemskill.
React Native Reusables brings the shadcn/ui experience to React Native: copy-paste or CLI-scaffolded components, theming via CSS variables, and RN Primitives under the hood. It supports NativeWind and Uniwind, requires a root PortalHost for overlays, and uses a Text inheritance system and an Icon wrapper for Lucide.
Core References
| Topic | Description | Reference |
|---|---|---|
| Overview | What RNR is, differences from shadcn/ui (portals, no cascade, icons, etc.) | core-overview |
| Installation | CLI init vs manual setup, adding components, PortalHost, dependencies | core-installation |
| Customization | components.json, global.css, tailwind.config, theme.ts | core-customization |
Features
Components and patterns
| Topic | Description | Reference |
|---|---|---|
| Components overview | Button, Input, Dialog, variants, asChild, compound components | features-components-overview |
| Text and icons | TextClassContext inheritance, Icon wrapper with Lucide | features-text-and-icons |
| Forms & controls | Label, Input, Select, Checkbox, RadioGroup, react-hook-form integration | features-forms-controls |
| Overlays & portals | PortalHost, Dialog/Popover/SelectContent, contentInsets | features-overlays-portals |
| Registry and CLI | init, add, doctor; custom registry and registryDependencies | features-registry-cli |
| Blocks | Auth blocks, Clerk integration, adding blocks via CLI | features-blocks |
Best practices
| Topic | Description | Reference |
|---|---|---|
| Adding components | Prefer CLI, PortalHost placement, path aliases, cn helper, manual copy | best-practices-adding-components |
| Troubleshooting | doctor, --log-level all, PortalHost, aliases, dependencies | best-practices-troubleshooting |
Key Recommendations
- PortalHost is required for any overlay (Dialog, DropdownMenu, Popover, Tooltip) — place it last in the root layout
- Use the CLI (
npx react-native-reusables add <name>) so primitives and paths are wired correctly - Text inside Button — always use
<Text>from@/components/ui/textas the direct child soTextClassContextapplies variant styles - Icons — use
<Icon as={LucideIcon} />rather than wrapping each icon individually - NativeWind v4 — use
.dark:root(not.dark) inglobal.cssfor dark-mode CSS variables - Run
doctorafter manual setup or when something breaks before assuming a bug
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/maikotrindade/awesome-react-native-skills/react-native-reusables">View react-native-reusables on skillZs</a>