Skip to content

DX Overhaul: Automated Setup, Docker Infra, and Monorepo Orchestration#56

Open
apreezofficial wants to merge 1 commit intooutray-tunnel:mainfrom
apreezofficial:infra/monorepo-dx-overhaul
Open

DX Overhaul: Automated Setup, Docker Infra, and Monorepo Orchestration#56
apreezofficial wants to merge 1 commit intooutray-tunnel:mainfrom
apreezofficial:infra/monorepo-dx-overhaul

Conversation

@apreezofficial
Copy link
Copy Markdown

@apreezofficial apreezofficial commented Feb 24, 2026

Rationale

Onboarding to Outray currently involves several manual steps: installing multiple databases (Postgres, Redis, TimescaleDB), manually cloning .env files, and managing multiple terminal sessions. This PR eliminates that friction by automating the environment setup and orchestrating services from the root, reducing "Time to First Hello World" to under 2 minutes.

Changes

  • Infrastructure as Code: Added docker-compose.yml to spin up a complete local dev environment (Postgres, Redis, TimescaleDB) with one command.
  • Service Orchestration: Updated root package.json with a dev script using concurrently. A single npm run dev now manages the entire stack.
  • Env Automation: Created a scripts/setup-envs.js utility and root command npm run setup:envs to automatically clone all .env.example templates across the monorepo.
  • Monorepo Standardization: Standardized workspaces in package.json to include all apps/*, packages/*, and shared modules, ensuring correct symlinking.
  • Documentation Refresh: Revamped CONTRIBUTING.md and README.md to reflect the streamlined workflow and updated project structure.

Validation

  1. Run npm install at root -> links all internal packages correctly.
  2. Run npm run setup:envs -> All .env files generated instantly.
  3. Run docker compose up -d -> All required DB containers started.
  4. Run npm run dev -> Web Dashboard, Tunnel Server, and CLI started in parallel.

@vercel
Copy link
Copy Markdown

vercel bot commented Feb 24, 2026

@apreezofficial is attempting to deploy a commit to the OutRay Team on Vercel.

A member of the Team first needs to authorize it.

@apreezofficial apreezofficial changed the title chore: overhaul developer experience and monorepo structure DX Overhaul: Automated Setup, Docker Infra, and Monorepo Orchestration Feb 24, 2026
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