An open API service indexing awesome lists of open source software.

https://github.com/masumrpg/react-native-components


https://github.com/masumrpg/react-native-components

react react-native react-native-components

Last synced: 2 days ago
JSON representation

Awesome Lists containing this project

README

          

# React Native Components Theme

[![npm version](https://badge.fury.io/js/rnc-theme.svg)](https://badge.fury.io/js/rnc-theme)
![npm downloads](https://img.shields.io/npm/dt/rnc-theme)
[![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue.svg)](https://www.typescriptlang.org/)
[![React Native](https://img.shields.io/badge/React%20Native-Optimized-61DAFB.svg)](https://reactnative.dev/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

> A comprehensive React Native UI component library and theme system designed to accelerate your mobile application development. With a focus on customization, performance, and exceptional developer experience.

## ✨ Key Features

### πŸŒ“ Dynamic Theme Switching
Seamlessly switch between light and dark modes, or create your own custom themes.

### πŸ”’ Type-Safe
Complete TypeScript support with comprehensive type definitions for a safe development experience.

### 🎨 Highly Customizable
Easily customize every aspect of components using a flexible theme system.

### ⚑ React Native Optimized
Built specifically for React Native with optimal performance and perfect native experience.

### πŸ’Ύ Persistent Storage
Automatically saves user theme preferences for consistent experience.

### 🎯 Multiple Presets
Comes with various built-in theme presets that are ready to use and customizable.

## πŸš€ Installation

```bash
npm install rnc-theme
# or
yarn add rnc-theme
```

## πŸ“– Quick Start

```jsx
import React from 'react';
import { View } from 'react-native';
import { RNCProvider, Button, Typography } from 'rnc-theme';
import { GestureHandlerRootView } from 'react-native-gesture-handler';

const App = () => {
return (



Welcome!
console.log('Button pressed!')}>
Press Me




);
};

export default App;
```

## πŸ“¦ 30+ UI Components Ready to Use

### πŸ”˜ Button & FAB
Customizable buttons with various variants, sizes, and Floating Action Button.

### πŸ“ Typography
Complete typography system with various heading, body, and caption variants.

### πŸ“‹ Form Controls
Input, Checkbox, Radio, Switcher, Toggle, Slider, and integrated Form Control.

### πŸ—οΈ Layout & Navigation
Card, Divider, Layout components, Modal, Bottom Sheet, and Accordion.

### πŸ“Š Data Display
Table, Badge, Avatar, Progress, Rating, and Skeleton loading.

### πŸ’¬ Feedback & Interaction
Toast notifications, Tooltip, Spinner, and various other interactive components.

### πŸ–ΌοΈ Media & Content
Image Carousel, Calendar, Date Picker for displaying multimedia content.

### πŸš€ Advanced Features
Combobox, Scroll components, and Internationalization (i18n) support.

## πŸ“š Documentation

Visit our comprehensive documentation for detailed guides and examples:

### [πŸš€ Getting Started](https://rnc.masum.cloud/)
Complete guide to start using rnc-theme in your project.

### [🎨 Theming Guide](https://rnc.masum.cloud/)
Learn how to create and customize themes according to your brand.

### [🧩 Components](https://rnc.masum.cloud/)
Explore all available components with complete usage examples.

### [πŸ’‘ Examples](https://rnc.masum.cloud/)
See real implementation examples and best practices.

## 🀝 Contributing

We warmly welcome contributions from the community! Please read our comprehensive contribution guidelines:

πŸ“‹ **[Contributing Guide](CONTRIBUTING.md)** - Complete guide for contributing
πŸ“œ **[Code of Conduct](CODE_OF_CONDUCT.md)** - Community rules and ethics
πŸ”’ **[Security Policy](SECURITY.md)** - Security policy and vulnerability reporting
πŸ—ΊοΈ **[Roadmap](ROADMAP.md)** - Future development plans
πŸ‘₯ **[Authors](AUTHORS.md)** - List of contributors and maintainers
πŸ“ **[Changelog](CHANGELOG.md)** - Version change history

### Quick Start for Contributors

1. **Fork** this repository
2. **Clone** your fork: `git clone https://github.com/YOUR_USERNAME/react-native-components.git`
3. **Install** dependencies: `bun install`
4. **Create** feature branch: `git checkout -b feature/amazing-feature`
5. **Make** your changes and **test** thoroughly
6. **Commit** with conventional format: `git commit -m "feat: add amazing feature"`
7. **Push** to branch: `git push origin feature/amazing-feature`
8. **Create** Pull Request using the provided template

### How to Contribute

- πŸ› **Report Bugs**: Use [bug report template](.github/ISSUE_TEMPLATE/bug_report.md)
- ✨ **Request Features**: Use [feature request template](.github/ISSUE_TEMPLATE/feature_request.md)
- πŸ’» **Code Contributions**: Follow [development guidelines](CONTRIBUTING.md#development-guidelines)
- πŸ“š **Improve Documentation**: Any documentation improvements are highly appreciated
- 🎨 **Design & UX**: Help improve design system and user experience
- πŸ§ͺ **Testing**: Help test new features and bug fixes
- 🌍 **Translation**: Help translate documentation to other languages

## πŸ“„ License

MIT - See [LICENSE](LICENSE) for details

---

Made with ❀️ for the React Native community