@upv/react-ui-core/README.md

**USHI Design System — Modern UI Component Library**

# 🧪 react-ui-core

**USHI Design System — Modern UI Component Library**

`react-ui-core` is a modular, themeable UI component library for React applications, built for **modern healthcare, education, and social platforms**. It powers the USHI app and supports responsive, accessible, and beautiful components for web and mobile experiences.

---

## 🚀 Features

- ✨ **Beautiful, accessible UI** with a modern, TikTok/Instagram-inspired aesthetic  
- 🎨 **Fully themeable** with light/dark mode and gradient support  
- ⚛️ **Reusable React + TypeScript components**  
- 💅 Built with **`styled-components`**  
- 📚 **Storybook support** for documentation and previews  
- 🧱 Covers layouts, forms, LMS blocks, gamification, social UX, and clinical tools

---

## 📦 Installation

```bash
# via npm
npm install react-ui-core

# via yarn
yarn add react-ui-core