CSS Zero

An opinionated CSS starter kit for your application. You can think of it like a "no build" Tailwind CSS.

Installation

bundle add css-zero

If you are using Propshaft (recommended) make sure to load all the CSS files in your layout.html.erb.

Click here to see how

```html+erb <%= stylesheet_link_tag :all, "data-turbo-track": "reload" %> ```

If you are using Sprockets make sure to load all the CSS files in your application.css.

Click here to see how

```css *= require _reset *= require animations *= require borders *= require buttons *= require colors *= require effects *= require filters *= require grid *= require sizes *= require transform *= require transition *= require typography *= require_tree . *= require_self *= require zutilities ```

Usage

<h1 class="text-xl font-bold mb-4">
  Write most page content using utility classes.
</h1>

<div class="component">
  Write custom CSS using predefined variables for components.
</div>

.component {
  background-color: var(--red-500);
  border-radius: var(--rounded);
  height: var(--size-4);
}

Check the CSS files in the repository for reference.

Buttons

<div class="flex items-center gap">
  <button class="btn btn--primary">Primary button</button>
  <button class="btn">Outline button</button>
  <button class="btn btn--plain">Plain button</button>
  <button class="btn" disabled>Disabled button</button>

  <button class="btn btn--primary">
    <%= image_tag "plus.svg", class: "invert" %> <span>Icon Button</span>
  </button>

  <button class="btn btn--primary" style="--btn-background: #67e8f9; --btn-color: #083344;">
    Colored button
  </button>

  <button class="btn btn--small">
    Button small
  </button>
</div>

Inputs

Soon...

Dialog

Soon...

Customization

Root level

:root {
  --color-bg: white;
  --color-bg-surface: var(--zinc-100);
  --color-text: var(--zinc-950);
  --color-text-reversed: white;
  --color-text-subtle: var(--zinc-500);
  --color-border: var(--zinc-200);
}

Class level

.btn--colored {
  --btn-background: var(--cyan-500);
  --btn-color: var(--cyan-950);
}

Style level

<button class="btn btn--primary" style="--btn-background: #67e8f9; --btn-color: #083344;">
  Colored button
</button>

Development

To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/lazaronixon/css-zero. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the code of conduct.

License

The gem is available as open source under the terms of the MIT License.

Code of Conduct

Everyone interacting in the CSS Zero project's codebases, issue trackers, chat rooms and mailing lists is expected to follow the code of conduct.