Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/lazaronixon/css-zero

An opinionated CSS starter kit for your "nobuild" application
https://github.com/lazaronixon/css-zero

bootstrap css css-framework nobuild ruby-on-rails tailwindcss

Last synced: 4 days ago
JSON representation

An opinionated CSS starter kit for your "nobuild" application

Awesome Lists containing this project

README

        

# CSS Zero

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

## Installation

Add this gem to your project.

```
bundle add css-zero
```

Run the install command.

```
bin/rails generate css_zero:install
```

Add the additional components you need. (Optional)

```
bin/rails generate css_zero:add --help
```

## Usage

```html


Write most page content using utility classes.


Create components using CSS variables.


Optionally, copy pre-built components into your application.

```

```css
.custom-component {
background-color: var(--red-500);
border-radius: var(--rounded);
block-size: var(--size-4);
}
```

Check the [CSS files](app/assets/stylesheets) in the repository to see the available variables and utility classes.

## Components

[](https://csszero.lazaronixon.com)

## Icons

Some icons in the examples are not copied to the project. If you are looking for good ones, I recommend [Lucide](https://lucide.dev).

## Scaffold

This gem implements custom templates for scaffolds and authentication.

## 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](https://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](https://github.com/lazaronixon/css-zero/blob/master/CODE_OF_CONDUCT.md).

## License

The gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).

## 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](https://github.com/lazaronixon/css-zero/blob/master/CODE_OF_CONDUCT.md).