0503c9f7da
Add README and clean up module-level READMEs and HISTORYs |
||
---|---|---|
src | ||
.gitignore | ||
Gruntfile.js | ||
HISTORY.md | ||
LICENSE.md | ||
package.json | ||
README.md |
Pure
A set of small, responsive CSS modules that you can use in every web project. http://purecss.io/
Use From the 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 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.
-
Easy one-click customization with the Skin Builder
-
Extremely small file size: 4.8KB 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.0.2/pure-min.css">
Build From Source
Optionally, you can build Pure from its 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 files in the build/
directory follow these rules:
-
[module]-nr.css
: Rollup of[module]-core.css
+[module].css
+[module]-[feature].css
from thesrc/[module]/
dir. This is the non-responsive version of a module. -
[module].css
: Rollup of[module]-nr.css
+[module]-r.css
from thebuild/
dir. This is the responsive version of a module. -
*-min.css
: A minified file version of the files of the same name. -
pure-min.css
: A rollup of all[module]-min.css
files in thebuild/
dir. This is a responsive roll-up of everything. -
pure-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 feature branch, and submit your pull request
from it. Please do not submit pull requests from your master
branch.
Versioning
Pure adheres to Semantic Versioning 2.0.
License
This software is free to use under the Yahoo! Inc. BSD license. See the LICENSE file for license text and copyright information.