October 26, 2018

478 words 3 mins read



Simple CSS library for semantic HTML markup

repo name igoradamenko/awsm.css
repo link https://github.com/igoradamenko/awsm.css
homepage https://igoradamenko.github.io/awsm.css/
language HTML
size (curr.) 1360 kB
stars (curr.) 1114
created 2015-09-12
license Other


npm version

awsm.css is a simple CSS library for semantic HTML, which doesn’t require classes, ids, attributes, etc.

Just start to create page with HTML5 tags, link awsm.css and get simple, clean and beautiful markup.

Check out examples or sample markup here.


Demo picture

Previous versions

Current master points to v3 of the library.

If you want to see or download previous versions, here they are:


<link rel="stylesheet" href="awsm.min.css">

Also don’t forget to add viewport info to the <head> for adaptation to mobile. Like this:

<meta name="viewport" content="width=device-width, initial-scale=1.0">

It’s also available as the npm package, which supports PostCSS API.


Download the latest version here — awsm.css.

Minified — awsm.min.css (≈3 Kb after gzip).


Current version contains some themes that you can use.

Check them on the demo page.


Also you can use unpkg for link latest or exact version of library:

<link rel="stylesheet" href="https://unpkg.com/awsm.css/dist/awsm.min.css">

Get more information about the unpkg CDN on unpkg.com.


If you install npm package, you can use library as PostCSS plugin:

const postcss = require('postcss');
const awsm = require('awsm.css');

postcss([awsm({ theme: 'tasman', sealed: true })]).process('a {color: red}').then(result => {
  console.log(result.css); // awsm.css prepends your CSS 

For more information about options check out docs.


I have to create simple pages in my daily work. Sometimes it’s compiled Markdown and sometimes it’s pure HTML. I’d like to make them more beautiful without additional classes, ids, etc. So I did it.


awsm.css licensed under the MIT.

The MIT License places almost no restrictions on what you can do with this lib. You are free to use it in commercial projects as long as the copyright is left intact.


Website for this repo uses awsm.css. Check this out. Also there are examples of blog and homepage built with awsm.css.

And I use the lib for my own website.

If you use the library in your project, feel free to open issue and we will add your url in this list :)


Short list of projects that use v3 of the library:


List of projects that use v2 of the library:

Got questions? Any troubles?

If you have questions or general suggestions, don’t hesitate to submit a new GitHub issue.

comments powered by Disqus