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

&lt;%= stylesheet_link_tag :all, "data-turbo-track": "reload" %&gt;

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

Click here to see how

  *= 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

buttons

<div class="flex items-center gap">
  Primary button
  Outline button
  Plain button
  Disabled button


    &lt;%= image_tag "plus.svg", role: "presentation", class: "invert" %&gt;
    <span>Icon button</span>



    Colored button



    Button small

</div>

Inputs

Soon…

Dialog

Soon…

Customization

Root level

:root {
  --color-bg: white;
  --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

  Colored 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.

Modules

Classes