mirror of https://github.com/pure-css/pure.git synced 2024-10-05 19:24:19 +00:00

A set of small, responsive CSS modules that you can use in every web project.

css html pure

Go to file

Tilo Mitra 1b2d9b9f94 fill in README		2013-05-20 13:23:59 -04:00
src	remove module-level HISTORY and README	2013-05-20 12:47:02 -04:00
.gitignore	Add Grunt `release` task to create a .zip archive of the build/ dir	2013-05-14 15:58:25 -04:00
Gruntfile.js	Update Gruntfile.js with new `pure` prefix and re-import Normalize.css	2013-05-16 13:34:29 -04:00
HISTORY.md	update HISTORY.md NEXT to mention test file cleanup	2013-05-16 14:18:43 -04:00
LICENSE.md	Initial drop	2013-05-09 18:05:18 -04:00
package.json	Bump version to 0.0.3pre	2013-05-16 13:53:49 -04:00
README.md	fill in README	2013-05-20 13:23:59 -04:00

README.md

Pure

A set of small, responsive CSS modules that you can use in every web project.

Homepage: http://www.purecss.io Get it from CDN: <link rel="stylesheet" href="http://yui.yahooapis.com/pure/0.0.2/pure-min.css">

Features

Pure is meant to be a starting point for every website or web app. We take care of all the CSS work that every site needs, without making it look cookie-cutter:

A responsive grid that can be customized to your needs
A solid base built on normalize.css to fix cross-browser compatibility issues.
Consistently styled buttons
Styles for vertical and horizontal menus
Useful form alignments
Various common table styles
An extremely minimalist look that is super-easy to customize
Responsive by default, with a non-responsive option
Easy one-click customization with the Skin Builder
Extremely small file size: < 5KB!

Check out Pure today

Get Started

To get started using Pure, go to the Pure CSS website. The website has extensive documentation and examples necessary to get you started using Pure.

You can include the Pure CSS file in your project by fetching it from Yahoo's CDN:

<link rel="stylesheet" href="http://yui.yahooapis.com/pure/0.0.2/pure-min.css">

Build from source

Optionally, you can build Pure from it's source on Github. To do this, you'll need to have NodeJS and npm installed. We use Grunt to build Pure.

git clone git@github.com:yui/pure.git
cd pure
npm install
grunt

Now, all Pure CSS files should be built into the pure/build/ directory. All files that are in this build directory are also available on the CDN. The naming conventions of the built files follow these rules:

[module]-nr.css: Rollup of -core.css + [module].css + -[feature].css. This is the non-responsive version of a module.
[module].css: Rollup of -nr.css + -r.css. This is the responsive version of a module.
*-min.css: A minified file version of the files of the same name.
kimono-min.css: A rollup of all [module].css files. This is a responsive roll-up of everything.
kimono-nr-min.css: A Rollup of all modules without @media queries. This is a non-responsive roll-up of everything.

Building specific modules

You can build a specific module by passing in its name into Grunt:

grunt grids

Contributions and Code Standards

Feel free to file bugs and submit pull requests on Github! When submitting a pull request, please checkout a new branch. Don't submit pull requests from your master branch. To do this:

git checkout -b my-pull-request
git add .
git commit -m 'done all my commits'
git push origin my-pull-request

Submit a pull request from your origin/my-pull-request branch to pure/master.

Versioning

Pure adheres to Semantic Versioning 2.0.