A full-stack web app with a Rails 7.2 backend and React + Vite frontend.

Install these before starting:

• rbenv — Ruby version manager
• Node.js (v18+) and npm
• Redis — brew install redis
• PostgreSQL — brew install postgresql@16

git clone <repo-url>
cd bath-hack-2026

cd backend

Install Ruby 3.4.4 via rbenv:

rbenv install 3.4.4
rbenv local 3.4.4
ruby -v  # should show 3.4.4

Install gems:

gem install bundler
bundle install

Set up Tailwind CSS:

bin/rails tailwindcss:install

Set up the database:

bin/rails db:prepare

Configure credentials — ask a teammate for the master.key and place it at backend/config/master.key (it is git-ignored).

cd ../frontend
npm install

From the backend directory, run all services together:

bin/dev

This starts:

Wrong Ruby version — if you see Your Ruby version is X.X.X, but your Gemfile specified 3.4.4:

cd backend
rbenv local 3.4.4
ruby -v

Tailwind input file missing — if you see Specified input file ./app/assets/tailwind/application.css does not exist:

bin/rails tailwindcss:install

Rails version mismatch — if you see Unknown version "7.2", ensure the Gemfile specifies gem "rails", "~> 7.2.0" and run bundle install.