Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/diconium/ui-toolbox

Common UI components library to build similar themed React web applications faster.
https://github.com/diconium/ui-toolbox

components-library design-system diconium hacktoberfest opensource react react-component-library storybook tailwindcss toolbox ui

Last synced: 6 days ago
JSON representation

Common UI components library to build similar themed React web applications faster.

Awesome Lists containing this project

README

        

# @diconium/ui-toolbox - React UI Component Library








@diconium/ui-toolbox is a common UI components library to build faster similar themed React web applications.

[![Apache 2.0 License](https://img.shields.io/badge/License-Apache-2.svg)](https://choosealicense.com/licenses/apache-2.0/)
![Github Actions](https://github.com/diconium/ui-toolbox/actions/workflows/workflows.yaml/badge.svg)
[![Storybook](https://raw.githubusercontent.com/storybooks/brand/master/badge/badge-storybook.svg)](https://docs.toolbox.diconium.com/)



## Features

- **Customizable Components:** Each component in **@diconium/ui-toolbox** is designed to be highly customizable, allowing you to easily adapt the look and feel to match your application's design and branding.
- **Responsive and Mobile-Friendly:** **@diconium/ui-toolbox** components are built with responsiveness in mind, ensuring a seamless user experience across various devices and screen sizes.
- **Easy Integration:** Integrating **@diconium/ui-toolbox** components into your existing React project is a breeze. With simple import statements, you can start using the components right away.
- **Well-Documented:** We provide comprehensive documentation for each component, along with examples and usage guidelines to facilitate smooth integration.
- **Consistent Design Language:** **@diconium/ui-toolbox** components follow a consistent and coherent design language, promoting a polished and professional UI across your entire application.

## Installation

To install **@diconium/ui-toolbox** in your project, simply use npm:

```bash
npm install @diconium/ui-toolbox
```

## Linting

**@diconium/ui-toolbox** comes with a set of linting rules to maintain code consistency and readability. You can run the linting process using the following npm command:

```bash
npm run lint
// or
npm run lint:fix
```

## Usage

Using a component from **@diconium/ui-toolbox** is straightforward. Import the component you need and use it in your React application:

```jsx
import React from 'react';
import { Button } from '@diconium/ui-toolbox';

function App() {
return Click me;
}
```

### Run storybook locally

```
npm run build:css:fonts
npm run build:css:watch
npm run storybook
```

### Build the library

```
npm run build:prod
```

### Component generators

If you want to create a new component you can call the following command on the terminal to create all the required files at once.

```
npm run generate:component
```

## Components

**@diconium/ui-toolbox** provides the following set of components:

- Avatar
- Avatars
- Button
- Primary
- Secondary
- Quick
- Sticky
- Radio
- Text
- Toggle
- Icon
- PaginationDots
- Tag
- Chip
- Checkbox
- TextField
- Searchbar
- Badge
- BadgeContainer
- State
- StateContainer
- TopNavigation
- Drawer
- NavigationBar
- Utils/Swipeable
- Dot
- Toast
- ProgressBar
- Spinner
- Layout/Mobile
- Layout/Centered
- Layout/Desktop
- Modal
- List
- ListItem
- TextArea
- Tooltip
- Calendar
- Message
- Select
- Tabs
- Table
- SideNavigation
- TestProvider

Please refer to the [documentation](https://docs.toolbox.diconium.com) for each component to learn more about their props, customization options, and examples of usage.

## Contribute

If you want to enhance the **@diconium/ui-toolbox**, you are welcome to fork the repository and create a pull request.
Please take into account, that we will have to conduct a code review before accepting your changes.

More details on how to best do that are described in our [Contributing guideline](https://github.com/DicoAuto/toolbox/blob/main/CONTRIBUTING.md).

## Contributors









## License

**@diconium/ui-toolbox** is released under the Apache License 2.0.

Happy coding!

© 2024 diconium GmbH. All rights reserved.