Comparing version 4.0.1-beta to 4.0.1
114
package.json
{ | ||
"name": "tachyons", | ||
"version": "4.0.1-beta", | ||
"description": "CSS for humans", | ||
"version": "4.0.1", | ||
"description": "Functional CSS for humans", | ||
"author": "mrmrs", | ||
"style": "src/tachyons.css", | ||
"style": "css/tachyons.css", | ||
"main": "css/tachyons.css", | ||
"files": [ | ||
@@ -14,4 +15,6 @@ "css", | ||
"css", | ||
"sass", | ||
"oocss", | ||
"functional css", | ||
"design", | ||
"responsive", | ||
"performance" | ||
@@ -23,45 +26,7 @@ ], | ||
"immutable-css-cli": "^1.1.1", | ||
"normalize.css": "^3.0.3", | ||
"tachyons-background-size": "^3.0.2", | ||
"tachyons-border-colors": "^4.0.4", | ||
"tachyons-border-radius": "^3.1.0", | ||
"tachyons-border-style": "^3.0.0", | ||
"tachyons-border-widths": "^2.0.1", | ||
"tachyons-borders": "^2.0.2", | ||
"tachyons-box-sizing": "^3.1.0", | ||
"tachyons-clears": "^2.0.3", | ||
"tachyons-cli": "^0.3.3", | ||
"tachyons-colors": "^5.1.0", | ||
"tachyons-coordinates": "^2.2.0", | ||
"tachyons-debug": "^1.1.1", | ||
"tachyons-display": "^3.0.3", | ||
"tachyons-floats": "^2.0.3", | ||
"tachyons-font-family": "^4.1.1", | ||
"tachyons-font-style": "^2.2.2", | ||
"tachyons-font-weight": "^4.0.2", | ||
"tachyons-forms": "^2.0.1", | ||
"tachyons-heights": "^4.0.2", | ||
"tachyons-hovers": "^2.0.4", | ||
"tachyons-images": "^1.0.3", | ||
"tachyons-letter-spacing": "^2.1.0", | ||
"tachyons-line-height": "^2.0.3", | ||
"tachyons-links": "^3.0.0", | ||
"tachyons-lists": "^2.0.3", | ||
"tachyons-max-widths": "^3.1.0", | ||
"tachyons-modules": "^1.0.3", | ||
"tachyons-opacity": "^1.0.0", | ||
"tachyons-overflow": "^3.0.0", | ||
"tachyons-position": "^5.0.0", | ||
"tachyons-spacing": "^5.0.2", | ||
"tachyons-skins": "^3.1.0", | ||
"tachyons-text-align": "^2.0.3", | ||
"tachyons-text-decoration": "^3.1.0", | ||
"tachyons-text-transform": "^3.0.3", | ||
"tachyons-type-scale": "^5.0.1", | ||
"tachyons-typography": "^2.0.3", | ||
"tachyons-utilities": "^1.1.3", | ||
"tachyons-vertical-align": "^2.0.2", | ||
"tachyons-visibility": "^1.0.3", | ||
"tachyons-white-space": "^3.0.0", | ||
"tachyons-widths": "^4.0.1" | ||
"normalize.css": "^4.1.1", | ||
"tachyons-cli": "^0.6.0", | ||
"tachyons-flexbox": "^1.0.0", | ||
"tachyons-modules": "^1.1.3", | ||
"watch": "^0.19.1" | ||
}, | ||
@@ -91,7 +56,56 @@ "contributors": [ | ||
"scripts": { | ||
"build": "node build.js && npm start", | ||
"start": "npm run build", | ||
"mutations": "immutable-css src/tachyons.css --strict", | ||
"start": "tachyons src/tachyons.css > css/tachyons.css && tachyons src/tachyons.css -m > css/tachyons.min.css" | ||
"build": "node build/index.js && npm run build:css && npm run build:minify", | ||
"build:css": "tachyons src/tachyons.css > css/tachyons.css", | ||
"build:minify": "tachyons src/tachyons.css -m > css/tachyons.min.css", | ||
"build:watch": "watch 'npm start' ./src/" | ||
}, | ||
"dependencies": {} | ||
"dependencies": { | ||
"tachyons-background-size": "^4.0.0", | ||
"tachyons-border-colors": "^4.1.0", | ||
"tachyons-border-radius": "^4.2.0", | ||
"tachyons-border-style": "^3.0.2", | ||
"tachyons-border-widths": "^2.1.0", | ||
"tachyons-borders": "^2.2.1", | ||
"tachyons-box-sizing": "^3.1.2", | ||
"tachyons-box-shadow": "^1.1.0", | ||
"tachyons-clears": "^2.2.0", | ||
"tachyons-colors": "^5.1.2", | ||
"tachyons-coordinates": "^3.0.1", | ||
"tachyons-debug": "^1.1.2", | ||
"tachyons-display": "^4.1.0", | ||
"tachyons-flexbox": "^1.0.0", | ||
"tachyons-floats": "^2.0.4", | ||
"tachyons-font-family": "^4.2.0", | ||
"tachyons-font-style": "^3.0.2", | ||
"tachyons-font-weight": "^4.0.4", | ||
"tachyons-forms": "^3.0.1", | ||
"tachyons-heights": "^5.0.0", | ||
"tachyons-hovers": "^2.3.1", | ||
"tachyons-images": "^1.0.4", | ||
"tachyons-letter-spacing": "^2.1.3", | ||
"tachyons-line-height": "^2.0.5", | ||
"tachyons-links": "^3.0.2", | ||
"tachyons-lists": "^2.0.5", | ||
"tachyons-max-widths": "^3.1.1", | ||
"tachyons-opacity": "^1.1.0", | ||
"tachyons-outlines": "^1.0.0", | ||
"tachyons-overflow": "^3.0.1", | ||
"tachyons-position": "^5.0.1", | ||
"tachyons-skins": "^3.2.1", | ||
"tachyons-spacing": "^5.0.10", | ||
"tachyons-tables": "^1.0.0", | ||
"tachyons-text-align": "^2.0.5", | ||
"tachyons-text-decoration": "^3.1.2", | ||
"tachyons-text-transform": "^3.0.6", | ||
"tachyons-type-scale": "^5.0.4", | ||
"tachyons-typography": "^2.3.1", | ||
"tachyons-utilities": "^1.2.2", | ||
"tachyons-vertical-align": "^3.0.0", | ||
"tachyons-visibility": "^1.0.4", | ||
"tachyons-white-space": "^3.0.2", | ||
"tachyons-widths": "^4.0.2", | ||
"tachyons-word-break": "2.0.0" | ||
} | ||
} |
132
readme.md
# TACHYONS | ||
CSS for designing faster than the speed of light. | ||
Functional CSS for humans. | ||
For the full set of documentation, please see [tachyons.io](http://tachyons.io). | ||
Quickly build and design new UI without writing CSS. | ||
## About | ||
Tachyons is a work in progress and still heavily in flux. | ||
The important parts of tachyons are the separation of concerns and the mobile-first | ||
and modular architecture. | ||
More documentation and examples will be coming. For now - reading the source files | ||
in the src directory are a great way to get up to speed. I promise they are not complicated. | ||
There is now a [Tachyons slack channel](http://tachyons-slack-invite.herokuapp.com). Submit your email to be automatically invited. | ||
## TLDR; | ||
Build responsive, performant, and easy to maintain interfaces faster than the speed of light. | ||
## Principles | ||
@@ -35,41 +20,79 @@ | ||
* Mobile-first css | ||
* Single-purpose class architecture | ||
* Single-purpose class structure | ||
* Optimized for maximum gzip compression | ||
* Less than 20kB when minified and gzipped | ||
* 7.2kB when minified and gzipped | ||
* Usable across projects | ||
* Infinitely nestable responsive grid system | ||
* Several color palettes | ||
* Currently built on rework | ||
* Built with Postcss | ||
## Getting started | ||
The easiest way to use tachyons is to include the minified file in the head. | ||
If you want to reduce the size of the library greatly on production I suggest | ||
using [uncss](https://github.com/giakki/uncss) to remove styles you aren't referencing. | ||
Docs can be found at http://tachyons.io/docs | ||
The modules are generally pretty small and thus easy to read and grock if you're familiar with css at all. | ||
### Modify the source | ||
Set up the project by cloning the repo, navigating into it, and installing the necessary dependencies by running the following commands: | ||
### Use the CDN | ||
The quickest and easiest way to start using tachyons is to include a reference | ||
to the minified file in the head of your html file. | ||
Currently the latest version is 4.0.0-beta.35 | ||
```html | ||
<link rel="stylesheet" href="https://npmcdn.com/tachyons@4.0.0-beta.35/css/tachyons.min.css"> | ||
``` | ||
git clone git@github.com:mrmrs/tachyons.git yourProject | ||
cd yourProject | ||
rm -rf .git | ||
git init | ||
git add remote git@github.com/yourUserName/yourProject.git | ||
npm install . && npm start | ||
``` | ||
You can alternatively fork the repo and clone your own version of it. | ||
### Local Setup | ||
### To compile compressed and uncompressed css from src | ||
Clone the repo from github and install dependencies through npm. | ||
``` | ||
npm start | ||
git clone https://github.com/tachyons-css/tachyons.git | ||
cd tachyons | ||
npm install | ||
``` | ||
This will watch the src directory and do the following on file change: | ||
* Compile rework css files | ||
* Run autoprefixer (this allows you to keep vendor prefixes out of your source files) | ||
* Run an instance of browser-sync - this causes any browsers or devices pointing to your local server to reload on file change. It will also keep all browsers in sync with eachother i.e. they will all scroll simultaneously. If you fill out a form on one device all devices will be updated with that content. It can be a huge help if you are testing multiple browsers or devices. | ||
## Some websites that use tachyons modules | ||
#### Build | ||
##### First time | ||
Tachyons is available as a series of small self contained css modules. They aren't dependent on eachother but | ||
are designed to play well together. But tachyons is also just css. And you should feel free to edit css | ||
that is in your project. The first time you build tachyons all of the css gets installed via npm, but the modules | ||
then get copied over to your local src directory and then the [`tachyons-cli`](https://github.com/tachyons-css/tachyons-cli) | ||
uses a series of postcss plugins to compile the source down to vanilla css. | ||
##### Updating | ||
If you want to update a tachyons partial, install the desired module version via npm and run the build command again. Note | ||
this will copy over all source files, so if you've modified src/ your changes might will be overwritten but you can use version control (like git!) to undo these changes. | ||
```npm run build``` | ||
#### Dev | ||
If you want to just use src as a jumping off point and edit all the code yourself, you can compile all of your wonderful changes by running | ||
```npm start``` | ||
This will output both minified and unminified versions of the css to the css directory. | ||
If you want to recompile everything from src everytime you save a change - you can run the following command, which will compile and minify the css | ||
```npm run build:watch``` | ||
If you want to check that a class hasn't been redefined or 'mutated' there is a linter to check that all of the classes have only been defined once. This can be useful if you are using another library or have written some of your own css and want to make sure there are no naming collisions. To do this run the command | ||
```npm run mutations``` | ||
## Contributing | ||
If you want to make a PR to change part of the css source for tachyons, make sure you make the PR on the corresponding module | ||
that can be found in the [tachyons org](http://github.com/tachyons-css/). Those modules get copied into the main repo so | ||
any changes you make to the css in this repo would get overridden. | ||
Also please read our [code of conduct](https://github.com/tachyons-css/tachyons/blob/master/code-of-conduct.md) for contributors. | ||
## Some websites that use modules from the tachyons project | ||
(if you have a project that uses tachyons feel free to make a PR to add it to this list) | ||
* http://spenhar.com | ||
* http://www.csspurge.com | ||
* http://bluebottlecoffee.com | ||
@@ -84,3 +107,2 @@ * http://aboutlife.com | ||
* http://mn-ml.cc | ||
* http://gfffs.com | ||
* http://pesticide.io | ||
@@ -94,2 +116,7 @@ * http://mrmrs.io/btns/ | ||
* http://fade.pics | ||
* http://gfffs.com | ||
* https://wordpress.org/themes/vanilla-milkshake/ | ||
* http://comics.hongkonggong.com/ | ||
* http://jon.gold/txt | ||
* http://rene.jon.gold | ||
@@ -99,25 +126,8 @@ And of course... | ||
## A Note on Class Names | ||
## Help | ||
As tachyons started out as an experiment in css performance - many of the names | ||
were programmatically generated using vim macros based on the content of the properties and values | ||
they represent. As I have begun to work on tachyons more and use it in the wild, | ||
I've begun to codify common classes to things that my brain naturally leans towards remembering. | ||
I like unix a lot and subscribe to naming conventions like cp over copy for common classes that I use frequently. | ||
If you have a question feel free to open an issue here or jump into the [Tachyons slack channel](http://tachyons-slack-invite.herokuapp.com). | ||
That being said I think the naming in Tachyons needs work and I am open to hearing peoples | ||
feedback on things they like and also the things they don't like. Once Tachyons is a little more finished I | ||
will be generating different 'flavors' of the framework that use different naming patterns. | ||
One version being a more verbose class naming system that seems to be aligned with what many people prefer. | ||
## License | ||
MIT | ||
## Contributing | ||
1. Fork it | ||
2. Create your feature branch (`git checkout -b my-new-feature`) | ||
3. Commit your changes (`git commit -am 'Add some feature'`) | ||
4. Push to the branch (`git push origin my-new-feature`) | ||
5. Create new Pull Request |
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
No v1
QualityPackage is not semver >=1. This means it is not stable and does not support ^ ranges.
Found 1 instance in 1 package
256407
7
58
6103
1
130
45
+ Addedtachyons-border-style@^3.0.2
+ Addedtachyons-borders@^2.2.1
+ Addedtachyons-box-shadow@^1.1.0
+ Addedtachyons-box-sizing@^3.1.2
+ Addedtachyons-clears@^2.2.0
+ Addedtachyons-colors@^5.1.2
+ Addedtachyons-coordinates@^3.0.1
+ Addedtachyons-debug@^1.1.2
+ Addedtachyons-display@^4.1.0
+ Addedtachyons-flexbox@^1.0.0
+ Addedtachyons-floats@^2.0.4
+ Addedtachyons-font-family@^4.2.0
+ Addedtachyons-font-style@^3.0.2
+ Addedtachyons-font-weight@^4.0.4
+ Addedtachyons-forms@^3.0.1
+ Addedtachyons-heights@^5.0.0
+ Addedtachyons-hovers@^2.3.1
+ Addedtachyons-images@^1.0.4
+ Addedtachyons-line-height@^2.0.5
+ Addedtachyons-links@^3.0.2
+ Addedtachyons-lists@^2.0.5
+ Addedtachyons-max-widths@^3.1.1
+ Addedtachyons-opacity@^1.1.0
+ Addedtachyons-outlines@^1.0.0
+ Addedtachyons-overflow@^3.0.1
+ Addedtachyons-position@^5.0.1
+ Addedtachyons-skins@^3.2.1
+ Addedtachyons-spacing@^5.0.10
+ Addedtachyons-tables@^1.0.0
+ Addedtachyons-text-align@^2.0.5
+ Addedtachyons-type-scale@^5.0.4
+ Addedtachyons-typography@^2.3.1
+ Addedtachyons-utilities@^1.2.2
+ Addedtachyons-visibility@^1.0.4
+ Addedtachyons-white-space@^3.0.2
+ Addedtachyons-widths@^4.0.2
+ Addedtachyons-word-break@2.0.0
+ Addedtachyons-background-size@4.0.3(transitive)
+ Addedtachyons-border-colors@4.2.3(transitive)
+ Addedtachyons-border-radius@4.2.3(transitive)
+ Addedtachyons-border-style@3.1.3(transitive)
+ Addedtachyons-border-widths@2.1.3(transitive)
+ Addedtachyons-borders@2.2.4(transitive)
+ Addedtachyons-box-shadow@1.1.3(transitive)
+ Addedtachyons-box-sizing@3.2.2(transitive)
+ Addedtachyons-clears@2.2.4(transitive)
+ Addedtachyons-colors@5.3.3(transitive)
+ Addedtachyons-coordinates@3.0.4(transitive)
+ Addedtachyons-debug@1.1.11(transitive)
+ Addedtachyons-display@4.1.5(transitive)
+ Addedtachyons-flexbox@1.2.3(transitive)
+ Addedtachyons-floats@2.0.9(transitive)
+ Addedtachyons-font-family@4.3.4(transitive)
+ Addedtachyons-font-style@3.0.5(transitive)
+ Addedtachyons-font-weight@4.0.7(transitive)
+ Addedtachyons-forms@3.1.4(transitive)
+ Addedtachyons-heights@5.0.4(transitive)
+ Addedtachyons-hovers@2.5.2(transitive)
+ Addedtachyons-images@1.0.12(transitive)
+ Addedtachyons-letter-spacing@2.2.3(transitive)
+ Addedtachyons-line-height@2.0.8(transitive)
+ Addedtachyons-links@3.0.11(transitive)
+ Addedtachyons-lists@2.0.13(transitive)
+ Addedtachyons-max-widths@3.1.5(transitive)
+ Addedtachyons-opacity@1.1.11(transitive)
+ Addedtachyons-outlines@1.0.4(transitive)
+ Addedtachyons-overflow@3.0.4(transitive)
+ Addedtachyons-position@5.0.5(transitive)
+ Addedtachyons-skins@3.2.5(transitive)
+ Addedtachyons-spacing@5.0.14(transitive)
+ Addedtachyons-tables@1.0.8(transitive)
+ Addedtachyons-text-align@2.0.8(transitive)
+ Addedtachyons-text-decoration@3.1.5(transitive)
+ Addedtachyons-text-transform@3.0.9(transitive)
+ Addedtachyons-type-scale@5.0.7(transitive)
+ Addedtachyons-typography@2.3.4(transitive)
+ Addedtachyons-utilities@1.2.9(transitive)
+ Addedtachyons-vertical-align@3.0.3(transitive)
+ Addedtachyons-visibility@1.0.7(transitive)
+ Addedtachyons-white-space@3.0.5(transitive)
+ Addedtachyons-widths@4.0.6(transitive)
+ Addedtachyons-word-break@2.0.0(transitive)