pico README

The project's README from github.com/picocss/pico. As one markdown file: README.md.

Pico CSS

Github release npm version License X (formerly Twitter)

Minimal CSS Framework for Semantic HTML

A minimalist and lightweight starter kit that prioritizes semantic syntax, making every HTML element responsive and elegant by default.

Write HTML, Add Pico CSS, and Voilà!

What’s new in v2?

Pico v2.0 features better accessibility, easier customization with SASS, a complete color palette, a new group component, and 20 precompiled color themes totaling over 100 combinations accessible via CDN.

Read more

A Superpowered HTML Reset

With just the right amount of everything, Pico is great starting point for a clean and lightweight design system.

Table of contents

Quick start

There are 4 ways to get started with pico.css:

Install manually

Download Pico and link /css/pico.min.css in the <head> of your website.

<link rel="stylesheet" href="css/pico.min.css">

Usage from CDN

Alternatively, you can use jsDelivr CDN to link pico.css.

<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.min.css">

Install with NPM

npm install @picocss/pico

Or

yarn add @picocss/pico

Then, import Pico into your SCSS file with @use:

@use "pico";

Install with Composer

composer require picocss/pico

Starter HTML template

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="color-scheme" content="light dark">
    <link rel="stylesheet" href="css/pico.min.css">
    <title>Hello world!</title>
  </head>
  <body>
    <main class="container">
      <h1>Hello world!</h1>
    </main>
  </body>
</html>

Class-less version

Pico provides a .classless version.

In this version, <header>, <main>, and <footer> inside <body> act as containers to define a centered or a fluid viewport.

Use the default .classless version if you need centered viewports:

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.classless.min.css"
/>

Or use the .fluid.classless version if you need a fluid container:

<link
  rel="stylesheet"
  href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.fluid.classless.min.css"
>

Then just write pure HTML, and it should look great:

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1">
    <meta name="color-scheme" content="light dark">
    <link
      rel="stylesheet"
      href="https://cdn.jsdelivr.net/npm/@picocss/pico@2/css/pico.classless.min.css"
    >
    <title>Hello, world!</title>
  </head>
  <body>
    <main>
      <h1>Hello, world!</h1>
    </main>
  </body>
</html>

Limitations

Pico CSS can be used without custom CSS for quick or small projects. However, it’s designed as a starting point, like a “reset CSS on steroids”. As Pico does not integrate any helpers or utilities .classes, this minimal CSS framework requires SCSS or CSS knowledge to build large projects.

Read more

Documentation

Getting started

Customization

Layout

Content

Forms

Components

About

Browser Support

Pico CSS is designed and tested for the latest stable Chrome, Firefox, Edge, and Safari releases. It does not support any version of IE, including IE 11.

Contributing

If you are interested in contributing to Pico CSS, please read our contributing guidelines.

Licensed under the MIT License.

pico (picocss/pico)

minimalist
Searching Database…

16.8K ·GitHub
archived
What is this?Pico is a minimal CSS framework for semantic HTML: one stylesheet that makes plain HTML elements responsive and elegant by default. MIT-licensed and built around writing HTML, not classes.
So is it just another CSS reset?More than a reset — the README calls it a starting point for a clean, lightweight design system. It styles semantic elements directly, so you write almost class-free HTML.
How do I add it to my site?Four ways: download and link css/pico.min.css, load it from the jsDelivr CDN, install via npm and import into SCSS with @use, or install with Composer.
Does it need JavaScript or a build step to work?No — it is just CSS: no JavaScript, no dependencies, and no build for the CDN or manual route. SCSS only enters if you take the npm path for customization.
Can I use it for a large project without writing custom CSS?Not really — Pico ships no helpers or utility classes, so larger projects need your own SCSS or CSS knowledge. Treat it as a foundation, like a 'reset CSS on steroids'.
Is Pico still actively maintained?No — the GitHub repository is archived and read-only, so it will not receive further updates. Version 2 remains fully usable via CDN or npm, but treat the project as frozen.
Why pick Pico over a blank stylesheet?You get clean, responsive styling for every semantic element out of the box, so you start from a lightweight design-system base instead of an empty CSS file — and it stays small enough to customize with SASS.
Is there a starter template to try it quickly?Yes — the quick start links a starter HTML template: copy it, add Pico, and you immediately see semantic HTML rendered with the framework's default styling.
Creator
picocss
Size
10.1 MB
Stars
16.8K
Age
6y
Commits · 90 Days