minimal.css

A simple stylesheet for simple webpages

The modern Web is full of eye-popping, heavy, javascript-laden sites. But some things just don’t have to be complicated. HTML is a powerful tool by itself, and it’s more than capable of producing an informative, complete website.

But it could use a little help. minimal.css is a <1kb stylesheet that makes plain HTML just a little nicer.

Features

Plus a couple other changes. For example, blockquotes have a border on the left so they stand out more, and the font is changed to sans-serif. In general, minimal.css tries to change as little as possible from the defaults.

Using minimal.css

The best option is to download minimal.css and copy it into your site files. This gives you full control of how the file is downloaded; no third party sites are involved.

Another easy option is to link it directly in your HTML using the following code in your head tag:

<link href="https://minimalcss.jwestman.net/minimal.min.css" rel="stylesheet" referrerpolicy="no-referrer" />

Either way, you should also add the following to your <head> tag to make sure your site is the correct size on mobile:

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

Demo

This demo page demonstrates how many HTML tags appear using minimal.css.

Development

View Repository on GitLab

I consider minimal.css to be basically complete so please file an issue before a merge request, no matter how minor the change is.

If you want to compile minimal.css for yourself, just clone the repository and edit minimal.sass. Then use the provided Makefile to compile your changes:

Public Domain

minimal.css is public domain under the CC0 public domain dedication. You may have received a copy of it with the code; if not, see here.