Simple CSS library for semantic HTML markup
Switch branches/tags
Clone or download


Build Status GitHub release

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..

..or watch demo video:

Demo video


<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">

And if you want to get beautiful font, add β€œPT Serif” from Google Fonts (specify subset if you need cyrillic or something else):

<link href=",400i,700,700i" rel="stylesheet">

It 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).


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

<link rel="stylesheet" href="">

Get more information about the unpkg CDN on


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

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

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


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.

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

Other examples:

Got questions? Any troubles?

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