1
mirror of https://github.com/pure-css/pure synced 2024-11-22 05:32:20 +01:00
Go to file
2015-03-04 15:33:17 -08:00
src adding some new tests for tables 2015-02-05 17:12:41 -08:00
tasks Use grunt-pure-grids package 2014-02-18 11:55:22 -05:00
.bowerrc Set Bower's "json" setting to bower.json for greater compatibility 2013-05-24 17:25:08 +01:00
.csslintrc Improve CSSLint config to work on a per-module basis 2013-11-27 14:38:03 -05:00
.gitignore Ignore soon-to-be created folders from Screwdriver CI builds 2013-06-11 12:03:48 -04:00
.npmignore redundant 2015-03-04 15:27:18 -08:00
.travis.yml Remove global grunt dep. 2013-09-26 17:17:35 +02:00
bower.json updating version to -pre 2015-02-23 15:48:47 -08:00
CONTRIBUTING.md Update URLs to point to Yahoo org on GitHub 2014-08-26 12:06:14 -04:00
Gruntfile.js breaking up menu into smaller files 2015-01-29 15:23:21 -08:00
HISTORY.md updating the rc version in a couple more spots 2015-02-03 17:27:11 -08:00
LICENSE.md Update copyright to 2014 2014-02-06 00:11:08 -05:00
package.json adding prepublish step 2015-03-04 15:33:17 -08:00
README.md updating a couple of things in the readme 2015-02-23 15:24:22 -08:00

Pure

![Gitter](https://badges.gitter.im/Join Chat.svg)

Pure

A set of small, responsive CSS modules that you can use in every web project. http://purecss.io/

Build Status

Use From the CDN:

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

Note: You can customize which Pure modules you need.

Install with Bower:

$ bower install --save pure

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 that work with <a> and <button> elements.

  • Styles for vertical and horizontal menus, including support for dropdown menus.

  • Useful form alignments that look great on all screen sizes.

  • Various common table styles.

  • An extremely minimalist look that is super-easy to customize.

  • Responsive by default, with a non-responsive option.

  • Extremely small file size: 4.5KB minified + gzip.

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.6.0/pure-min.css">

You can also install Pure using Bower, using the following command:

$ bower install --save pure

Build From Source

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

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

Build Files

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 files in the build/ directory follow these rules:

  • [module]-core.css: The minimal set of styles, ususally structural, that provide the base on which the rest of the module's styles build.

  • [module]-nr.css: Rollup of [module]-core.css + [module].css + [module]-[feature].css from the src/[module]/ dir. This is the non-responsive version of a module.

  • [module].css: Rollup of [module]-nr.css + [module]-r.css from the build/ dir. This is the responsive version of a module.

  • *-min.css: A minified file version of the files of the same name.

  • pure.css: A rollup of all [module].css files in the build/ dir. This is a responsive roll-up of everything, non-minified.

  • pure-min.css: Minified version of pure.css that should be used in production.

  • pure-nr.css: A Rollup of all modules without @media queries. This is a non-responsive roll-up of everything, non-minified.

  • pure-nr-min.css: Minified version of pure-nr.css that should be used in production.

  • grids-responsive.css: Unminified version of Pure's grid stylesheet which includes @media queries.

  • grids-responsive-min.css: Minified version of grids-responsive.css that should be used in production.

Browser Support and Testing

Pure is tested and works in:

  • IE 8+
  • Latest Stable: Firefox, Chrome, Safari
  • iOS 6-8
  • Android 4.x

Docs and Website

Pure's website is also open source, so please open any issues or pull requests for the docs and website over at the pure-site repository.

Contributing

See the CONTRIBUTING file for information on how to contribute to Pure.

License

This software is free to use under the Yahoo! Inc. BSD license. See the LICENSE file for license text and copyright information.