# shadcn

> Acknowledging the amazing projects and people that made BNA UI possible.

**BNA UI** — a React Native / Expo component library.
These components render through `react-native`, not the DOM: there are no HTML
elements, no Tailwind classes and no Radix primitives. Source is copied into your
project and imported through `@/components/ui/*`, `@/components/charts/*`,
`@/hooks/*` and `@/theme/*`. Colours come from the `useColor` hook rather than
hardcoded hex; sizing tokens (`HEIGHT`, `FONT_SIZE`, `BORDER_RADIUS`, `CORNERS`)
come from `@/theme/globals`.

- Docs: https://ui.ahmedbna.com/docs/shadcn
- Markdown: https://ui.ahmedbna.com/docs/shadcn.md

---

## Credits

BNA UI stands on the shoulders of giants. This project and its documentation would not exist without the incredible work of the open source community and the visionary developers who came before us.

## Design & Inspiration

**[shadcn/ui](https://ui.shadcn.com)** - The cornerstone of modern React component design. BNA UI is deeply inspired by shadcn's elegant approach to component architecture, design tokens, and developer experience. We've adapted these principles for the mobile world while maintaining the same philosophy of beautiful, accessible, and customizable components.

## Documentation

This documentation site is built by [shadcn](https://twitter.com/shadcn). The original codebase has been thoughtfully modified and adapted for BNA UI's specific needs, but the foundation, design system, and user experience patterns remain faithful to shadcn's exceptional work.

**Original Documentation:** Created by [shadcn](https://github.com/shadcn-ui)\
**Modified for BNA UI by:** [BNA](https://github.com/ahmedbna)

## Core Technologies

- **[Next.js](https://nextjs.org)** - The React framework that powers our documentation site
- **[React Native](https://reactnative.dev)** - The foundation of our mobile component library
- **[Expo](https://expo.dev)** - The platform that makes React Native development delightful

## Animation & Interaction

- **[React Native Reanimated](https://docs.swmansion.com/react-native-reanimated)** - Bringing smooth, performant animations to mobile
- **[React Native Gesture Handler](https://docs.swmansion.com/react-native-gesture-handler)** - Native gesture recognition for intuitive interactions
- **[Expo Haptics](https://docs.expo.dev/versions/latest/sdk/haptics)** - Tactile feedback that makes interfaces feel alive
- **[Lucide React Native](https://lucide.dev)** - Beautiful, consistent iconography

## Community & Support

- **React Native Community** - For building an ecosystem that enables cross-platform mobile development
- **Expo Team** - For continuously improving the developer experience
- **shadcn** - For setting the standard for what component libraries can be

## Special Thanks

A heartfelt thank you to **[shadcn](https://twitter.com/shadcn)** for creating not just a component library, but a philosophy and approach to building user interfaces that prioritizes developer experience, accessibility, and beautiful design. BNA UI exists because shadcn/ui showed us what's possible.

## License

BNA UI is MIT licensed. The original shadcn/ui documentation template is also MIT licensed.

---

_Built with gratitude for the open source community_ 🙏