Contractor payments as easy as 1-2-3.

You'll need:

• Docker
• Node.js (see .node-version)
• Ruby

The easiest way to set up the development environment is to use the bin/setup script, but feel free to run the commands in it yourself:

• Set up Ruby (ideally using rbenv/rvm) and PostgreSQL
• Navigate to backend code and install dependencies: cd backend && bundle i && gem install foreman

• Navigate to frontend app and install dependencies cd frontend && pnpm i

Finally, set up your environment: cp .env.example .env. If you're an Antiwork team member, you can use vercel env pull .env.

You can start the local app using the bin/dev script - or feel free to run the commands contained in it yourself.

Once the local services are up and running, the application will be available at https://flexile.dev

Development shortcuts:

• If ENABLE_DEFAULT_OTP=true is set in your .env, you can use 000000 as the OTP for logging in or signing up.
• Use these pre-seeded accounts (password: password for all):
  • Admin: [email protected] (Primary Administrator)
  • Contractor: [email protected] (Software Engineer)
  • Investor: [email protected] (Investor)
  • More accounts: See the seed data for additional test users (emails are always [email protected])

Issue: When running bin/dev (after bin/setup) encountered FATAL: role "username" does not exist

Resolution: Manually create the Postgres user with:

psql postgres -c "CREATE USER username WITH LOGIN CREATEDB SUPERUSER PASSWORD 'password';"

Likely caused by the bin/setup script failing silently due to lack of Postgres superuser permissions (common with Homebrew installations).

Issue: First attempt to run bin/dev failed with Redis::CannotConnectError on port 6389.

Resolution: Re-running bin/dev resolved it but data wasn't seeded properly, so had to run db:reset

Likely caused by rails attempting to connect before Redis had fully started.

Issue: Tests that involve Stripe operations may fail due to invalid or missing customer IDs.

Resolution:

1. Generate real customer id, simplest way to do it:

stripe customers create \
  --name "Customer Name" \
  --email "[email protected]" \
  --api-key "sk_test_mock"

2. Update company factories (on frontend and backend) with that customer id

# Run Rails specs
bundle exec rspec --tag '~skip' --tag '~type:system'

# Run a single spec
bundle exec rspec spec/system/roles/show_spec.rb:7

# Run Playwright end-to-end tests
pnpm playwright test

Note: Keep credentials secure and never commit to version control.

Flexile is licensed under the MIT License.