mirror of
https://github.com/chobbledotcom/chobble-forms.git
synced 2025-08-20 17:49:52 +00:00
An opinionated way of doing semantic HTML forms in Rails that forces you to use i18n strings and nicely match your database
| .github/workflows | ||
| app | ||
| bin | ||
| lib | ||
| sig | ||
| sorbet | ||
| spec | ||
| views/chobble_forms | ||
| .gitignore | ||
| chobble-forms.gemspec | ||
| flake.lock | ||
| flake.nix | ||
| Gemfile | ||
| Gemfile.lock | ||
| Rakefile | ||
| README.md | ||
| terragon-setup.sh | ||
Chobble Forms
Semantic Rails forms with strict i18n enforcement.
Installation
Add this line to your application's Gemfile:
gem 'chobble-forms'
And then execute:
bundle install
Type Safety with Sorbet
ChobbleForms is fully typed with Sorbet (typed: strict) providing compile-time type safety and runtime validation. All field parameters must be symbols for a clean, consistent API.
Type Checking
bundle exec srb tc
Development Setup
- Install dependencies:
bundle install - Generate RBI files:
bundle exec rake sorbet_rbi - Run type checking:
bundle exec rake typecheck
CSS Styles
ChobbleForms includes CSS for styling the form components. To use the included styles, add this to your application.css:
/*
*= require chobble_forms
*/
The CSS includes:
- Form Grids: Responsive grid layouts for various form field combinations
- Form Fields: Styling for inputs, textareas, and labels
- Radio Buttons: Custom radio button appearance with pass/fail color coding
- Flash Messages: Styled success, error, notice, and alert messages
CSS Variables
The CSS uses the following CSS variables that you can override in your application:
--color-primary: Primary color for hover states (default: #118bee)--color-pass: Pass/success color (default: #00a94f)--color-fail: Fail/error color (default: #d32f2f)--color-disabled: Disabled state color (default: #959495)