Skip to content

Make local development setup smoother - #5747

Open
awwaiid wants to merge 1 commit into
mainfrom
improve-local-dev-setup
Open

awwaiid wants to merge 1 commit into
mainfrom
improve-local-dev-setup

Conversation

@awwaiid

@awwaiid awwaiid commented Oct 24, 2026 •

Copy link
Copy Markdown
Collaborator

Fix a handful of snags hit while setting up a fresh local dev environment.

  • In bin/setup, use bundler version from Gemfile.lock instead of installing the latest version
  • In bin/setup bundle install wasn't getting called correctly
  • Remove the keypress pause when initially copying .env.example to .env (it didn't help anything)
  • Add a new bin/db wrapper for using the devcontainer docker compose postgres; updated docs to match
  • Made some things take PORT env and some other env fallbacks
  • Update CI and strong migrations to use postgres 16.13 (which is what prod uses)
  • Added benchmark gem to Gemfile to fix warning about it being removed from core

🤖 Generated with Claude Code, plus some hand-edits (especially this PR description)

- bin/setup: install the bundler version from Gemfile.lock instead of
  `bundle update --bundler` (which could install a prerelease and rewrite
  the lockfile); actually run `bundle install` when `bundle check` fails;
  don't block on a keypress after creating .env, and explain what to check
  if the database can't be set up.
- Add bin/db to run Postgres in Docker via the devcontainer compose
  service, and document it in README/CONTRIBUTING/.env.example.
- bin/start honors PORT (e.g. PORT=3001 bin/start); dev mailer links
  follow the web server's port.
- CI Postgres 12.3 -> 16.13 to match production RDS; update
  StrongMigrations.target_version to 16.13.
- Add benchmark gem to silence the Ruby 3.5 default-gem warning from
  delayed_job.
- Drop obsolete `version:` key from the devcontainer compose file.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01A1Q6b5q6YnqkjpKs7VcK19
@awwaiid
awwaiid requested a review from dorner October 24, 2026 15:31

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant