sandbox-test-setup

name

sandbox-test-setup

description

Bike Index Ruby + RSpec environment setup, for the three environments this repo actually runs in: a local macOS Conductor workspace, the Conductor cloud sandbox, and Claude Code's Linux web sandbox. Identifies which one you're in by path and points at its reference; each covers getting `ruby`, `bundle`, `bin/lint`, a database and a browser working there. Read it whenever a session runs RSpec, `bundle` or `bin/lint`, needs a running dev server, or hits any of these: `env: 'ruby': No such file or directory`, `Could not find 'bundler' (4.0.0.beta2)`, `Bundler::RubyVersionMismatch`, `command not found: rspec`, `uninitialized constant Pathname` from a `bin/` script, `Sprockets::Rails::Helper::AssetNotFound`, `tailwind.css is not present`, `LoadError: Could not open library 'vips.so.42'`, or a Playwright browser-not-found or build-number mismatch. The fix is almost never a reinstall or a Gemfile edit — it's a PATH, an env var, or a service that isn't running.

Running Ruby + RSpec for Bike Index

Three environments, told apart by the path you're working in. Read the one that matches; the other two won't apply and are the bulk of the material.

Path	Environment	Read
/Users/…/conductor/workspaces/…	local macOS Conductor workspace	references/local-macos.md
/home/vercel-sandbox/workspace (Amazon Linux 2023)	Conductor cloud sandbox	references/conductor-cloud.md
/home/user/bike_index	Claude Code web sandbox	references/web-sandbox.md

What separates them is how much is missing, and that's worth knowing before you start debugging. On macOS the Ruby is installed and only the PATH is wrong. In the Conductor cloud sandbox nothing is preinstalled but egress is open, so mise builds the pinned Ruby in a couple of minutes. In the web sandbox egress is filtered too, so Ruby comes from a GitHub source build and several tools have to be pointed at what the image already ships.