Skip to content

Latest commit

 

History

History
56 lines (33 loc) · 4.43 KB

README.md

File metadata and controls

56 lines (33 loc) · 4.43 KB

Optimism

GitHub stars GitHub forks Twitter follow Discord

The missing drop-in solution for realtime remote form validation in Rails.

{% hint style="success" %} Optimism v0.4.1 now supports Ruby 3.0.0, thanks to Julian Rubisch and Rails 6.1, thanks to Josh LeBlanc. 🎉 {% endhint %}

Why have optimism?

Optimism is an MIT-licensed Ruby on Rails gem that makes it easy to give your users instant constructive feedback if they enter invalid data into your application. Instead of dumping a list of errors at the top of your interface, Optimism provides specific instructions directly beside or below individual input elements.

You can try a 👉 live demo 👈 right now.

Is optimism for you?

Are you trying to use remote forms but feeling frustrated by their inflexibility? You need to mainline a dose of Optimism, stat!

If you care about reducing churn and giving your users the best experience possible, Optimism is a great way to achieve your UX goals without having to waste time writing repetitive and brittle validation code. Properly constrained and highly opinionated, you'll be able to keep your validation logic on the server where it belongs without sacrificing the immediate response of a reactive Single Page App. Whether you're working on a complex multi-element form with a traditional Submit button or a dynamic search that delivers results as you type, Optimism chops, grinds, slices and dices your validation concerns away.

Optimism is safe and approved for all diets, religions and political appetites. Many developers find that Optimism is highly addictive and lowers stress when applied regularly.

How does optimism work?

Rails applications receive requests to update database records based on a list of proposed changes that come from a dog user submitting a form in their browser. If all proposed changes can be made without breaking any business rules, ActiveRecord can update the email address and age of the dog user. Optimism kicks in when user_params = {email: 7, age: "bark_ruffalo@gmail.com"}.

When a model validation error prevents an update from succeeding, Optimism builds a list of issues that must be resolved. This list is broadcast to the browser over a websocket connection, and the live document is changed to show the necessary validation hints. No page refreshes are required and the entire process happens faster than you can blink.

Key features and advantages

  • Easy to learn, quick to implement
  • Automatically handles multi-level nested forms
  • Plays well with existing tools such as StimulusReflex, Turbolinks and even jQuery
  • Contextual user feedback in a few milliseconds
  • Supports form-based and in-line edit scenarios equally well
  • Optional support for emitting DOM events
  • Highly configurable via an optional initializer file
  • CSS framework agnostic with Bootstrap and vanilla samples provided
  • Lightweight, coming in at ~100 LOC

Try it now

The project repository lives on Github at https://github.com/leastbad/optimism and this documentation is available at https://optimism.leastbad.com

There's a live demo that you can try right now at https://optimism-demo.herokuapp.com

Even better, the source code for the demo is available on Github. The project README lists every step required to build the demo application from scratch in about five minutes.

Excited? Great! Let's setup Optimism in your Rails application now. And if you're having any trouble at all, drop by our Discord server for help.