Getting started
Since Pollen is just CSS variables, it works everywhere without any preprocessor or environment requirements.
Installation
Install Pollen from NPM and include its CSS in your project, or link direct to it on the Unpkg CDN
Module import
CSS import (CDN)
HTML Link (CDN)
1
npm i pollen-css
Copied!
1
import 'pollen-css';
Copied!
Requires CSS support in your bundler (eg: Webpack, Rollup, etc)
1
@import "https://unpkg.com/pollen-css";
Copied!
1
<link rel="stylesheet" href="https://unpkg.com/pollen-css" />
Copied!
Once Pollen is included in your project, you can use its variables anywhere
Configuration
Pollen comes with a robust set of low-level defaults for building sophisticated designs. But every aspect can be easily customised, extended, or stripped out with the
pollen command line build tool. Instead of importing the default pollen.css file, create a pollen.config.js config file in the root of your project and run pollen to generate your own custom design system. Then import the generated CSS file as you normally would.IE Support
Pollen requires a small shim to work in Internet Explorer 11 and below, as it doesn't support the CSS variables that the library is built on. Enable IE support with the included
shimmie utility from pollen-css/utils1
import { shimmie } from 'pollen-css/utils';
2
​
3
shimmie();
Copied!
Shimmie will check for support and, if required, dynamically load and apply the excellent
css-vars-ponyfill shim with sane configuration.Editor Integration
VS Code
Enable intellisense autocompletion for Pollen in VS Code by installing the CSS Var Complete extension and adding Pollen's CSS in a
.vscode/settings.json file in the root of your project, along with some optional additional configuration.If you have configured a custom Pollen bundle make sure you add the output CSS file to the
cssvar.files array instead of the default pollen.css bundle..vscode/settings.json
1
{
2
"cssvar.files": [
3
// Or your custom Pollen bundle
4
"./node_modules/pollen-css/pollen.css",
5
],
6
// Use Pollen's inbuilt variable ordering
7
"cssvar.disableSort": true,
8
// Add support for autocomplete in other file types
9
"cssvar.extensions": ["css", "html", "jsx", "tsx"]
10
}
Copied!
Last modified 5mo ago
Copy link
Edit on GitHub