v1.0.0 · MIT · zero runtime deps

goodto
go.

Zero-config dev environment readiness checker. Scans your project and verifies services, ports, env vars, and runtime versions — before you hit cryptic errors.

$ npx goodtogo
// output
~/projects/myapp
$ npx goodtogo
goodtogo
✓ node runtime     — v20.11.0 satisfies >=18
✓ port 5432       — port is occupied, service is up
✗ port 6379       — nothing is listening on this port
→ Run: docker compose up -d redis
✓ DATABASE_URL    — set
✗ JWT_SECRET     — not set in .env or environment
→ Add JWT_SECRET=... to your .env file
⚠ REDIS_URL      — set but empty
→ Set a value for REDIS_URL in your .env file
   3 passed · 2 failed · 1 warning
$

stop wasting time
on broken environments.

You clone a repo. You run npm run dev. It crashes with some obscure error. You spend 20 minutes figuring out Redis isn't running, a .env key is missing, and your Node version is wrong. goodtogo catches all of that in one shot, before you even start.

what gets checked.

.env.example

Environment variables

Reads required keys from .env.example. Checks your .env and process.env. Reports missing or empty vars with a fix hint.

docker-compose.yml

Port availability

Extracts host port mappings and probes each one. A free port means a service isn't running. You'll know immediately which one.

package.json

Node / npm version

Reads the engines field and compares against your installed runtime. Catches version mismatches before they cause weird bugs.

Dockerfile

Runtime versions

Parses FROM statements to detect required runtimes — Node, Go, Python, Java. Shells out to verify what's actually installed.

flags.

--ci Exit 1 on any failure. Drop into Makefile, pre-commit, or GitHub Actions.
--json, -j Machine-readable JSON output. Pipe into other tools.
--verbose, -v Show detail on passing checks too, not just failures.
--version, -V Print the installed version.
--help, -h Show help.

coming in v1.5.0.

v1.5.0 Service check — verify containers are running via docker ps
v1.5.0 Makefile target detection
v2.0.0 --fix flag — attempt to auto-fix common issues
v2.0.0 Watch mode — re-run checks on file change