css3-colors
Version:
Colors classess for css3
142 lines (104 loc) • 5.39 kB
Markdown
# css3-colors
Css3-colors is a package that helps you with color management, `css3-colors` brings variable classes with the colors that have the package [`scss-colors`](https://github.com/yoicalsin/sass-colors)
To see all the colors and their shades, click [here](https://yoicalsin.github.io/sass-colors/)
<!-- ALL-CONTRIBUTORS-BADGE:END -->
<a href="https://github.com/yoicalsin/css3-colors"><img src="https://img.shields.io/spiget/stars/1000?color=brightgreen&label=Star&logo=github" /></a>
<a href="https://www.npmjs.com/css3-colors" target="_blank">
<img src="https://img.shields.io/npm/v/css3-colors" alt="NPM Version" /></a>
<a href="https://www.npmjs.com/css3-colors" target="_blank">
<img src="https://img.shields.io/npm/l/css3-colors" alt="Package License" /></a>
<a href="https://www.npmjs.com/css3-colors" target="_blank">
<img src="https://img.shields.io/npm/dm/css3-colors" alt="NPM Downloads" /></a>
<a href="https://github.com/yoicalsin/css3-colors" target="_blank">
<img src="https://s3.amazonaws.com/assets.coveralls.io/badges/coveralls_95.svg" alt="Coverage" /></a>
<a href="https://github.com/yoicalsin/css3-colors"><img src="https://img.shields.io/badge/Github%20Page-sass.colors-yellow?style=flat-square&logo=github" /></a>
<a href="https://github.com/yoicalsin"><img src="https://img.shields.io/badge/Author-Yoni%20Calsin-blueviolet?style=flat-square&logo=appveyor" /></a>
<a href="https://twitter.com/yoicalsin" target="_blank">
<img src="https://img.shields.io/twitter/follow/yoicalsin.svg?style=social&label=Follow"></a>
## 🎉 Colors Demo
Preview live click [here](https://yoicalsin.github.io/sass-colors/)
## 📦 Installation
Before using, we have to **install** the package via npm or download it directly !
```bash
# To install
npm install --save css3-colors
```
## ▶️ Usage
To use it is very simple, first you have to import the css file into your main file of _html_.
When you install or download the package you will have two css files, `index.css` and `index.min.css`
- File `index.css` this file is customizable as it is not mined.
- File `index.min.css` this file brings all the classes with the colors, but unlike the other one, this one will come mirified, that is to say to use it in production.
```html
<html lang="en">
<head>
<meta charset="UTF-8" />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<title>css-colors - Created by Yoni Calsin</title>
<!-- This way you'll have to care -->
<link rel="stylesheet" href="dist/index.css" />
</head>
<body>
<!-- Here he adds all his html code -->
</body>
</html>
```
But if you want to import it from javascript, you will have to do it this way:
```js
import '~css3-colors/dist/index.css';
```
### 🎨 Color classes
To be able to use the classes are as follows.
The colors are iterated from a map !
```scss
/**
* Red Colors
**/
$red: (
'base': #f44336,
'lighten-5': #ffebee,
'lighten-4': #ffcdd2,
'lighten-3': #ef9a9a,
'lighten-2': #e57373,
'lighten-1': #ef5350,
'darken-1': #e53935,
'darken-2': #d32f2f,
'darken-3': #c62828,
'darken-4': #b71c1c,
'accent-1': #ff8a80,
'accent-2': #ff5252,
'accent-3': #ff1744,
'accent-4': #d50000,
);
```
For example we will use the color red, and if you want more simply add the classes of `.lighten-{number}` or `.accent-{number}`.
```html
<div class="red">
<h1 class="blue-text">Css3-colors</h1>
</div>
```
To give colors to the texts, it is also very simple, you can use the same classes, _you will have to add the word `-text` to the **end**_
```html
<h1 class="red-text lighten-3">Red title - lighten-3</h1>
```
## ⭐ Support for
css3-colors is an open source project licensed by [MIT](LICENSE). You can grow thanks to the sponsors and the support of the amazing sponsors. If you want to join them, [contact me here](mailto:helloyoicalsin@gmail.com).
## 🎩 Stay in touch
- Author [Yoni Calsin](https://github.com/yoicalsin)
- Twitter [Yoni Calsin](https://twitter.com/yoicalsin)
## Contributors ✨
Thanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):
<!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section -->
<!-- prettier-ignore-start -->
<!-- markdownlint-disable -->
<table>
<tr>
<td align="center"><a href="https://twitter.com/yoicalsin"><img src="https://avatars0.githubusercontent.com/u/58490737?v=4" width="70px;" alt=""/><br /><sub><b>Yoni Calsin</b></sub></a><br /><a href="https://github.com/css3-colors/css3-colors/commits?author=yoicalsin" title="Code">💻</a> <a href="https://github.com/css3-colors/css3-colors/issues?q=author%3Ayoicalsin" title="Bug reports">🐛</a> <a href="https://github.com/css3-colors/css3-colors/commits?author=yoicalsin" title="Documentation">📖</a> <a href="#blog-yoicalsin" title="Blogposts">📝</a></td>
</tr>
</table>
<!-- markdownlint-enable -->
<!-- prettier-ignore-end -->
<!-- ALL-CONTRIBUTORS-LIST:END -->
This project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!
## 📜 License
css3-colors is [MIT licensed](LICENSE).