Almond.CSS is a collection of class-less CSS styles to make simple websites look better. Almond.CSS helps in two ways: it normalizes the CSS styles to provide similar experience cross-browser, and it spices things a little by adding custom styles (that can be personalized!)

Use the different HTML5 semantic tags on your website, include the library in your project, and let CSS and the browser work their magic. Just combine your HTML and Almond CSS (no JavaScript needed.) You can see a demo in this repo running.

The main goals of this project are:

How to include Almond.CSS in your project


Almond.CSS is available as an npm package to make it easy to install and use on any project. These are the steps to include it in any project (using npm):

  1. Install the package:

     npm install almond.css
  2. Add the import to the app entry point (e.g. in apps created with create-react-app, it would be App.js):

     import "almond.css/dist/almond.min.js";
  3. Build and start your app


There are CDN services like jsDelivr or unpkg, that work with github and npm libraries, providing a fast and reliable delivery.

You can include Almond.CSS using the <link> tag (You only need one, not all):

<!-- loads all the styles (including icons and images) from jsDelivr -->
<link rel="stylesheet" href="" />

<!-- loads the light version of the library from jsDelivr -->
<link rel="stylesheet" href="" />

<!-- loads all the styles (including icons and images) from unpkg -->
<link rel="stylesheet" href="" />

<!-- loads the light version of the library from unpkg -->
<link rel="stylesheet" href="" />


We based the theming on CSS variables and HSL colors. HSL allows to define a color based on three parameters: Hue, Saturation, and Lightness. Provide a primary and secondary colors using HSL, and see the demo page change automatically.

The default primary color is a dark pale blue, and the default secondary color is a medium gray.

Some values that devs can specify:

Variable Description Default Value
--primaryH Primary color hue value 210
--primaryS Primary color saturation value 50%
--primaryL Primary color lightness value 40%
--primary-bg Primary color background white
--secondaryH Secondary color hue value 0
--secondaryS Secondary color saturation value 0%
--secondaryL Secondary color lightness value 13%
--secondary-bg Secondary color background white
--font-family Set of fonts for the text Helvetica, Arial, sans-serif
--font-size-root Default font size (root) 16px
--font-weight-bolder Font weight value (bolder text) 700
--font-weight-bold Font weight value (bold text) 400
--font-weight-normal Font weight value (normal text) 200
--font-weight-thin Font weight value (thin text) 100
--line-height Line-height of paragraphs and lists 1.75rem
--heading-margin Margin applied to the headings and heading groups 1.5rem 0 1rem
--border-radius Border radius 2px


By combining some “not-too common” HTML attributes with some CSS variables, we can generate a series of widgets without the need to use JavaScript or HTML classes.

Here is a list of the widgets available at the moment:


Here are the instructions on how to copy the code of this library into your local machine and build it. They use npm, but you can run similar commands with yarn.

Clone the repository:

git clone

Enter the project directory (almond.css):

cd almond.css

Install the development dependencies:

npm i

Build the library by compiling the sass files:

npm run build

This will generate four files in the dist folder:

You can test the library by opening the static HTML file located in the demo directory.

Instead of having to run the build script each time that a change is made, you can add a watch functionality that will generate the almond.css file every time there is a change in any of the sass files:

npm run watch

Notice that only the almond.css file (used in the demo html page) will be generated. Once you are ready to build for production, you will have to run the build script to generate the light and minified versions described above.