Skip to content
A minimalist Sass boilerplate that provides helpful, browser-consistent styling for default HTML elements.
Branch: master
Clone or download
Latest commit 5cac71f Apr 12, 2019

README.md

Primitive UI License: MIT

A minimalist Sass boilerplate that provides helpful, browser-consistent styling for default HTML elements - buttons, forms, tables, lists, and typography.

Motivation

Primitive was originally built by Tania Rascia to understand how a responsive CSS framework works from the inside-out, and how to use Sass, the CSS preprocessor.

Primitive makes it incredibly simple to set the foundation for a sustainable styling system. You get the freedom to design your site however you want, with a solid, easy-to-understand underlying framework.

Many websites have been built with Primitive, such as taniarascia.com, Laconia, Cafe Ba-Ba-Reeba!, Shaw's Crab House, Tokio Pub, Krispy Kreme Pacific Northwest, and more.

Getting Started

CSS quick start (easy)

<link rel="stylesheet" href="https://unpkg.com/primitive-ui/dist/css/main.css">

It's all set to go and your HTML elements will be given sensible default styling.

Sass integration (recommended)

The beauty of Primitive is the ease with which you can create unique designs in a beautiful, simple system. Simply clone the repo:

git clone https://github.com/taniarascia/primitive.git
cd primitive

And run a Sass watch on the project.

npm run sass

Now you can begin modifying variables in variables.scss. This file will define your colors, typography, sizes, breakpoints, buttons, borders, and more. Define all your variables here to keep your project organized.

You can view dist/test.html or templates/template.html to see some example elements as you make changes.

Documentation

All documentation can be found at https://taniarascia.github.io/primitive.

Todos

  • Clean up comments
  • Add simple flex grid back in
  • Look into autoprefixing
  • Improve documentation

Acknowledgements

  • Dave Gamache for building Skeleton CSS, the original inspiration for building Primitive and understanding responsive CSS.

Contributing

Please feel free to fork, comment, critique, or submit a pull request.

Author

License

This project is open source and available under the MIT License.

You can’t perform that action at this time.