https://github.com/viur-framework/viur-ignite
A sizzling PostCSS boilerplate
https://github.com/viur-framework/viur-ignite
css css-framework css-modules css3 framework-css npm npm-package postcss postcss-boilerplate viur
Last synced: 3 months ago
JSON representation
A sizzling PostCSS boilerplate
- Host: GitHub
- URL: https://github.com/viur-framework/viur-ignite
- Owner: viur-framework
- License: mit
- Created: 2017-07-24T09:47:54.000Z (over 8 years ago)
- Default Branch: main
- Last Pushed: 2024-10-24T14:22:30.000Z (over 1 year ago)
- Last Synced: 2025-09-29T15:47:22.947Z (4 months ago)
- Topics: css, css-framework, css-modules, css3, framework-css, npm, npm-package, postcss, postcss-boilerplate, viur
- Language: CSS
- Homepage: https://ignite.viur.dev
- Size: 6.71 MB
- Stars: 11
- Watchers: 10
- Forks: 3
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
- awesome-viur - ViUR-Ignite - The CSS toolkit written in less for ViUR (Official ViUR Resources / Further Repositories)
README
[](https://www.npmjs.com/package/@viur/ignite) [](https://raw.githubusercontent.com/viur-ignite/ignite/master/LICENSE)
# Ignite
> ViUR Ignite is a sizzling PostCSS boilerplate
Our goal is to create a boilerplate that is sturdy and scalable
yet lightweight and adaptable to our different customer projects.
Our approach to CSS is influenced by many modern CSS principles: object oriented, functional and structured.
It uses the power of PostCSS.
For a detailed introduction and examples have a look at [ignite.viur.dev](https://ignite.viur.dev).
## What is this framework for?
* Ignite is a development toolkit for sturdy HTML and CSS
* It is a lightweight collection of helpful CSS
* It is responsive and adaptable
* It is built with PostCSS
* It is a solid foundation for [Shoelace](https://github.com/viur-framework/vi-shoelace) and [VUEJS](https://github.com/viur-framework/vi-vue-components)
## Foundation
* _basic.css_ – styling of all application basics (body, fonts, headlines, lists etc.).
* _color.css_ – is a collection of color tables.
* _config.css_ – stores all default variables and constants.
* _mediaqueries.css_ – is a really simple solution for media queries.
* _reset.css_ – resets all browsers to the same base state.
## Themes
* _dark.css_ - is a starting point for a dark theme
* _light.css_ - is a starting point for a light theme
## Utilities
* _shoelace.css_ – the ignite shoelace adapter (ISA)
* _utilities.css_ – useful helpers
---
## Usage
**NPM**
Use NPM to install Ignite:
```bash
npm install @viur/ignite
```
Please use [postcss-import](https://www.npmjs.com/package/postcss-import) with your PostCSS pipeline.
This way you are able to get rid of ugly `../node_modules/@viur/ignite/ignite.css` imports:
```postcss
@import url('@viur/ignite/ignite.css');
```
**Submodule**
You can add Ignite as submodule to your project as well:
```bash
git submodule add git@github.com:viur-framework/ignite.git
```
or
```bash
git submodule add https://github.com/viur-framework/ignite.git
```
Now you can import Ignite in your projects style.css
```postcss
@import url('ignite/ignite.css');
```
**Builds**
Preprocessed versions of Ignite can be found in `dist` folder:
Bundled:
```postcss
@import url('@viur/ignite/dist/ignite.css');
```
Minified:
```postcss
@import url('@viur/ignite/dist/ignite.min.css');
```
---
## Contribution guidelines
* Available for use under the MIT license
---
## Who do I talk to?
* [@phneutral](https://github.com/phneutral)
* [@sveneberth](https://github.com/sveneberth)