Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/designsystems-os/design-ui

CSS-in-JS (styled-components, emotion and more...) starter design systems with react and docz
https://github.com/designsystems-os/design-ui

cli css-in-js design-systems docz emotion jest react styled-components

Last synced: about 3 hours ago
JSON representation

CSS-in-JS (styled-components, emotion and more...) starter design systems with react and docz

Awesome Lists containing this project

README

        





fully customizable design systems w/ styled-components and more...




## **Description**

**Design-UI** is a collection of starter templates built on top of `create-react-app v2+` to give you the ability to create a design system from scratch with:

- Different **CSS-in-JS** libraries (_`styled-components`, `emotion` etc._)
- `React v16.8+` ([ 📖 _docs_ ](https://reactjs.org/))
- `Docz` ([ 📖 _docs_ ](https://www.docz.site))

## 🚀 **Getting Started**

### Install the CLI Globally

```bash
npm install -g @design-ui/[library]
```

### Generate Your Design System

```bash
design-ui-[library]
```

### Running Your Project

To get up and running with your design system:

```bash
# Install Your Dependencies
yarn

# Run Your Test Suite
yarn test

# Lint Your Styled Components
yarn lint:css

# Serve Your Documentation
yarn docs
```


## 💁🏾 **Styling Components**

You can use the design system components standalone or as wrappers for your React components that contain additional logic to separate concerns

### Basic Usage w/ Default Styles

```html
// Standalone

// Wrapper

```

### Custom Styling

```html
// Customizable Style Props

```

## 📃 **Documentation**

**Docz** ( _.mdx_ ) documentation files are represented in each component folder but can be rearranged to suit your desired project structure

Screen-Shot-2019-02-23-at-2-37-23-PM

You can customize documentation styling in the **doczrc.js** file at the root of the default project

## ✏️ **Testing**

The template comes with out-of-the-box testing with `jest` for your React components (_included with `create-react-app`_) and testing compatible with your specific CSS-in-JS library


## **Contributors**

### Built with 💖 by this human:

[Jazz Lyles](https:/jazz-lyles.com/)

[✉️](mailto:[email protected])

## **License**

Licensed under MIT

Copyright © 2019 [Jazz Lyles](https://jazz-lyles.com)