Rules Editor

Rails application for managing Gmail automation rules.

Features

• Rules stored in PostgreSQL using JSONB (conditions + actions).
• Priority-ordered list (1 is highest) with drag-and-drop reordering.
• index, show, edit, update views.
• Save and apply rule action that immediately runs one rule against inbox-labeled messages.
• Tailwind-powered UI with Inertia + React on the rules index page.

Environment

Use Ruby 3.4+.

Copy .env.example to .env and adjust values.

cp .env.example .env

Environment values are loaded automatically with bkeepers/dotenv.

Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET in .env using a Google OAuth Web application client configured for this app's browser callback flow. See docs/oauth_setup.md.

OAuth Setup

See docs/oauth_setup.md.

Database

bundle exec rails db:create
bundle exec rails db:migrate

Install JavaScript dependencies

npm install

Build JavaScript assets

npm run build

Run in development (Rails + JS watcher)

gem install foreman
bin/dev

Run only Rails app (requires a prior npm run build)

bundle exec rails server -p 3000

Import Apple Mail rules

bundle exec ruby import_from_mail_app.rb ../SyncedRules.plist