milesmcc / a17t

An atomic design toolkit for pragmatists
https://a17t.miles.land
MIT License
492 stars 17 forks source link
atomic-design components css css3 design framework postcss tailwindcss ui-components


An atomic design toolkit for pragmatists.
A Tailwind CSS plugin.
Discover a17t »

ConceptsCDNOffice Hours

Installation

a17t is available on NPM, and can be installed with npm install a17t and installed in Tailwind by adding require("a17t") to the plugins section of your tailwind.config.js file. For more information, check out the documentation site.

Overview

Build beautiful, unique interfaces without reinventing the wheel. Let a17t provide the core building blocks, then customize with ease.

<article class="card ~positive @high">
  <!-- ~positive is for tone; @high is for priority -->

  <b>Congratulations!</b>
  You're using a17t to build a beautiful interface.

  <button class="button">Let's go!</button>

</article>

View the full documentation →

Some CSS frameworks come prepackaged with all sorts of components that are convenient at first but quickly become limiting. Utility frameworks like Tailwind are awesome, but can be difficult start using on their own.

a17t tries to get the balance right. Instead of providing all-inclusive, opinionated components (like jumbotrons, navbars, and menus), a17t provides common single-class elements in a default (but easily customizable) style. And it's a Tailwind plugin, so it'll integrate into your project seamlessly.

Getting Started

Want to jump right in? Check out the documentation site to get started. Here are links to some popular elements:

Documentation

a17t loves documentation. There's nearly 100% documentation coverage! View it online or in the docs folder.


a17t was created by Miles McCain at the Recurse Center.