Tailwind and Ruby-on-Rails starter kit

Demo

Motivation

Ruby-on-Rails is fantastic to deliver features - for free
Flowbite is fanastic to deliver extensible Tailwind UI design - with a generous free tier.

Instead of having Rails with fantastic features (but without UI design),

and Flowbite with fantastic UI design (but without anything that actually works behind the scene),

What if we marry both?

We have a working authentication flow that is beautiful by default
We have transactional emails that already works
We have beautiful flash messages by default
We have already designed, accessible form validation
We have secured, verified users
We have a full test suite by default
We have beautiful landing pages by default
We have beautiful static pages (pricing, privacy, etc) by default
We have tons of CSS components, blocks and pages ready to be integrated with our own custom feature

Then we have a Rails, but UI design centric starter kit.

Isn't Flowbite a 3rd-party dependency?

Actually Flowbite is just plain old Tailwind, so you're not really "locked" into an external dependency.

You can use just the free parts. Of course if you buy their full package, you have access to more components, which sounds fair!

I have no affiliation with them (so far), moreover, Flowbite decided to offer paying components that ends up in this starter kit - currently only a few of them. But I won't abuse of their generosity here, so this repo will rely on free components as much as possible.

So a big thanks to their team !

Prerequisites

Tested under Linux-based system.

ruby --version
3.3.0

git --version
2.34.1

node --version
v20.9.0

psql --version
14.10

Build

./create.sh
# Wait for a minute... then :
cd myapp
bin/dev

Play

Then open your browser at localhost:3000

There is already a verified user in the database :

email: simple@user.com
password: Secret1*3*5*

Or you can sign up a new user, then open localhost:3000/letter_opener to confirm your email.

Test

You can run the full test suite by running :

bin/rails test:all

Drop all and restart from fresh state

./create.sh

Quick hacks (so far - nothing to do on your side)

Forced Rails version to 7.1.3 (in order to be sure what we're working on)
Forced turbo-rails to 7.3.0 (or it will use a beta version of Turbo 8 that is not yet stable)
Forced to answer "Y" to file overwritting, see rails/cssbundling-rails#146
Need to run "bundle update" to ensure bcrypt is installed

omkz / tailstart