Functional css for humans
Find a file
John Otander 7c7ace6c3f
Merge pull request #594 from crhallberg/fix-586
Fix Issue #586 (missing gray-9 and gray-10)
2018-10-02 13:34:16 -06:00
build Spike out colors page 2018-07-13 15:46:14 -06:00
css Revert builds. 2018-10-02 15:15:33 -04:00
docs Spike out colors page 2018-07-13 15:46:14 -06:00
packages Spike out colors page 2018-07-13 15:46:14 -06:00
site Spike out colors page 2018-07-13 15:46:14 -06:00
src Align whitespace. 2018-10-02 15:11:57 -04:00
.gitignore Begin implementing with next 2018-03-07 10:22:57 -07:00
.npmrc Nuke package-lock 2017-10-26 16:10:07 -06:00
bower.json Renaming the main file not to be minified 2017-04-18 10:05:31 +01:00
code-of-conduct.md Add code of conduct. 2016-04-27 17:32:20 +01:00
index.html Add blank html file that references tachyons css 2016-03-22 20:16:17 +00:00
lerna.json v7.0.1-1 2018-07-13 12:35:47 -06:00
license Nuke docs code, use tachyons-cli 2015-10-23 16:03:52 -06:00
package.json Spike out colors page 2018-07-13 15:46:14 -06:00
readme.md Bump deps for docs, remove yarn.lock 2018-07-13 13:35:18 -06:00
todo.md Update white-space with new ws- prefix 2018-07-13 12:35:47 -06:00

TACHYONS

Functional css for humans. Quickly build and design new UI without writing css.

Built for designing

Create fast loading, highly readable, and 100% responsive interfaces with as little css as possible.

Download Latest Version

Principles

  • Everything should be 100% responsive
  • Everything should be readable on any device
  • Everything should be as fast as possible
  • Designing in the browser should be easy
  • It should be easy to change any interface or part of an interface without breaking any existing interfaces
  • Doing one thing extremely well promotes reusability and reduces repetition
  • Documentation helps promote reusability and shared knowledge
  • Css shouldn't impede accessibility or the default functionality of Html
  • You should send the smallest possible amount of code to the user

Features

  • Mobile-first css architecture
  • 490 accessible color combinations
  • 8px baseline grid
  • Multiple debugging utilities to reduce layout struggles
  • Single-purpose class structure
  • Optimized for maximum gzip compression
  • Lightweight (~14kB)
  • Usable across projects
  • Growing open source component library
  • Works well with plain html, react, ember, angular, rails, and more
  • Infinitely nestable responsive grid system
  • Built with Postcss

Getting started

Docs can be found at http://tachyons.io/docs The modules are generally pretty small and thus quick and easy to read.

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.

<link rel="stylesheet" href="https://unpkg.com/tachyons@7/css/tachyons.min.css">

Local Setup

Clone the repo from github and install dependencies through npm.

git clone https://github.com/tachyons-css/tachyons.git
cd tachyons
npm install

Dev

If you want to just use everything in tachyons/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 and watch the src directory for changes. It's aliased to the command:

npm run build:watch

If you'd like to just build the css once without watching the src directory run

npm run build

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

Docs

The tachyons docs located at http://tachyons.io are all open source and located at /docs.

You can clone the docs and use them as a template for documenting your own design system / patterns / components. While not everything is automated, the component library generation makes it extremely easy to generate and organize the documentation for components as demonstrated at https://tachyons.io/components

Community Resources

Contributing

Please read our code of conduct for contributors.

Tachyons in Production

A longer list of sites that use tachyons in production can be found in sites.md We love letting the community see what people are building so please add your link to sites.md in a PR or by opening an issue if you're willing to share to your site or project.

And of course...

Sponsors

Development of Tachyons is supported by

Help

If you have a question or need help feel free to open an issue here or jump into the Tachyons slack channel.

License

MIT