Beautifully designed components that you can copy and paste into your apps. Accessible. Customizable. Open Source.
This repository is a monorepo with two sibling projects:
ruby_ui/
├── gem/ # the ruby_ui gem (lib/, generators, tests, gemspec)
└── docs/ # the Rails app that powers https://rubyui.com
- Use the gem in your app: see
gem/README.md. - Documentation site: https://rubyui.com/docs/introduction
- Contributing guide:
CONTRIBUTING.md
| Path | What lives here |
|---|---|
gem/ |
The ruby_ui gem (gem build, gem release from this folder). |
docs/ |
Rails 8 app for the documentation site. Consumes the local gem via path: "../gem". |
.github/workflows/ci.yml |
Unified CI: gem tests on Ruby 3.3 + 3.4, Rails docs app tests, and a docker-build job that publishes the docs devcontainer to ghcr.io. |
The two projects are independent for everyday work — pick the one you need:
# Gem work
cd gem
bundle install
bundle exec rake # tests + standardrb
# Docs work (consumes the local gem via path: "../gem")
cd docs
bundle install
pnpm install
bin/dev # http://localhost:3000Editing files under gem/lib/ruby_ui/ is reflected immediately when running the docs app — no bundle update, no rebuild, no PR coordination across two repos.
Released under the MIT License.