chore: move .env file to monorepo root

Author: jamesmurdza

.env.example

@@ -0,0 +1,27 @@
+# Connection string for a Postgres database
+DATABASE_URL=
+
+# API key for E2B, obtainable at https://e2b.dev/
+E2B_API_KEY=
+
+# API key and publishable key for Clerk, obtainable at https://clerk.com/
+CLERK_SECRET_KEY=
+NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
+
+# API key for OpenAI, obtainable at https://openai.com/api/
+OPENAI_API_KEY=
+
+# API key for Anthropic, obtainable at https://console.anthropic.com/api
+ANTHROPIC_API_KEY=
+
+# Optional: As an alternative to Anthropic, you can use AWS Bedrock
+AWS_ACCESS_KEY_ID=  
+AWS_SECRET_ACCESS_KEY=  
+AWS_REGION=  
+AWS_ARN=  
+
+# Optional: Dokku credentials for deployments
+DOKKU_HOST=
+DOKKU_USERNAME=
+DOKKU_KEY=
+

README.md

@@ -17,7 +17,7 @@ A quick overview of the tech before we start: The deployment uses a **NextJS** a
 - [Anthropic](https://anthropic.com/) or AWS Bedrock: API keys for code generation.
 - [OpenAI](https://openai.com/): API keys for applying AI-generated code diffs.
 
-### 1. Initial setup
+### 1. Clone the repository
 
 No surprise in the first step:
 
@@ -26,30 +26,21 @@ git clone https://github.com/jamesmurdza/sandbox
 cd sandbox
 ```
 
-Install dependencies:
+Copy .env files:
 
 ```bash
-npm install
-```
-
-### 2. Add Clerk
-
-Get the API keys from Clerk.
-
-Update `/web/.env`:
-
-```
-NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY='🔑'
-CLERK_SECRET_KEY='🔑'
+cp .env.example .env
+cp web/.env.example web/.env
+cp server/.env.example server/.env
 ```
 
-Then, update `server/.env`:
+Install dependencies:
 
-```
-CLERK_SECRET_KEY='🔑'
+```bash
+npm install
 ```
 
-### 3. Add the database
+### 2. Create a database
 
 Create a database:
 
@@ -58,52 +49,32 @@ psql postgres -c "CREATE DATABASE sandbox;"
 # psql postgres -U  postgres -c "CREATE DATABASE sandbox;"
 ```
 
-Update `web/.env` and `server/.env` with the database connection string.
+Delete the `/db/drizzle/meta` directory.
 
-```sh
-DATABASE_URL=postgresql://localhost:5432/sandbox
-# DATABASE_URL=postgresql://<username>:password@localhost:5432/sandbox
-```
-
-### 4. Apply the database schema
-
-Delete the `/web/drizzle/meta` directory.
-
-In the `/web/` directory run:
+In the `/db/` directory run:
 
 ```
 npm run generate
 npm run migrate
 ```
 
-### 5. Add E2B
+### 3. Configure environment variables
 
-Setup the E2B account.
+Get API keys for E2B, Clerk, OpenAI, and Anthropic.
 
-Update `/web/.env` and `/server/.env`:
+Add them to the `.env` file along with the database connection string.
 
 ```
+DATABASE_URL='🔑'
 E2B_API_KEY='🔑'
-```
-
-### 6. Configure the frontend
-
-Update `/web/.env`:
-
-```
-NEXT_PUBLIC_SERVER_URL='http://localhost:4000'
-```
-
-Then add Anthropic and OpenAI API keys:
-
-```
-ANTHROPIC_API_KEY='🔑'
+CLERK_SECRET_KEY='🔑'
 OPENAI_API_KEY='🔑'
+ANTHROPIC_API_KEY='🔑'
 ```
 
 As an alternative to the Anthropic API, you can use AWS Bedrock as described in [this section](#add-inference-on-aws-bedrock).
 
-### 7. Run the IDE
+### 4. Run the IDE
 
 Start the web app and server in development mode:
 
@@ -120,7 +91,7 @@ npm run dev
 
 Setup GitHub OAuth for authentication.
 
-Update `/web/.env`:
+Update `.env`:
 
 ```
 GITHUB_CLIENT_ID=your_github_client_id
@@ -231,7 +202,7 @@ sudo make install
 systemctl start dokku-daemon
 ```
 
-The Sandbox platform connects to the Dokku server via SSH, using SSH keys specifically generated for this connection. The SSH key is stored on the Sandbox server, and the following environment variables are set in /server/.env:
+The Sandbox platform connects to the Dokku server via SSH, using SSH keys specifically generated for this connection. The SSH key is stored on the Sandbox server, and the following environment variables are set in `.env`:
 
 ```bash
 DOKKU_HOST=

server/.env.example

@@ -1,30 +1 @@
-# The variables below are required.
-
-# PORT is the port used by NodeJS
-# SERVER_URL points to this server
-
-PORT=4000
-SERVER_URL=http://localhost:4000
-
-# The variables are required.
-# They should be the same as in frontend/.env.example
-
-DATABASE_URL=
-E2B_API_KEY=
-CLERK_SECRET_KEY=
-
-# The variables below are required to use deployments.
-
-# DOKKU_HOST and DOKKU_USERNAME are used to authenticate via SSH with the Dokku server
-# DOKKU_KEY is the path to an SSH (.pem) key on the local machine
-
-DOKKU_HOST=
-DOKKU_USERNAME=
-DOKKU_KEY=
-
-# These should be the same as in /backend/server/.env
-
-DATABASE_URL=
-
-# CLERK_SECRET_KEY needed for making authenticated requests
-CLERK_SECRET_KEY=
+PORT=4000

server/src/index.ts

@@ -1,5 +1,12 @@
-import cors from "cors"
 import dotenv from "dotenv"
+import path from "path"
+
+// Load parent .env first
+// Then load local .env to override
+dotenv.config({ path: path.resolve(__dirname, "../../.env") })
+dotenv.config({ path: path.resolve(__dirname, "../.env") })
+
+import cors from "cors"
 import express, { Express } from "express"
 import fs from "fs"
 import { createServer } from "http"
@@ -34,9 +41,6 @@ process.on("unhandledRejection", (reason, promise) => {
 // Initialize containers and managers
 const connections = new ConnectionManager()
 
-// Load environment variables
-dotenv.config()
-
 // Initialize Express app and create HTTP server
 const app: Express = express()
 const port = process.env.PORT || 4000

web/.env.example

@@ -1,37 +1,7 @@
-# The variables below are for NextJS.
-
 NEXT_PUBLIC_APP_URL=http://localhost:3000
 NEXT_PUBLIC_SERVER_URL=http://localhost:4000
 
 NEXT_PUBLIC_CLERK_SIGN_IN_URL=/sign-in
 NEXT_PUBLIC_CLERK_SIGN_UP_URL=/sign-up
 NEXT_PUBLIC_CLERK_AFTER_SIGN_IN_URL=/dashboard
-NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard
-
-# The variables below are required.
-
-# E2B_API_KEY can be obtained at https://e2b.dev/
-# DATABASE_URL is the connection string for the database
-# Clerk credentials can be obtained at https://clerk.com/
-
-E2B_API_KEY=
-DATABASE_URL=
-NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY=
-CLERK_SECRET_KEY=
-
-# The variables below are required to use the AI assistant.
-# You need:
-# 1. OPENAI_API_KEY (required for applying AI-generated code diffs)
-# 2. EITHER Anthropic direct API OR AWS Bedrock configuration (for code generation)
-
-# Option 1: Direct Anthropic API
-ANTHROPIC_API_KEY=
-
-# Option 2: AWS Bedrock Configuration (all four required if using this option)
-AWS_ACCESS_KEY_ID=  
-AWS_SECRET_ACCESS_KEY=  
-AWS_REGION=  
-AWS_ARN=  
-
-# Required for code diffs
-OPENAI_API_KEY=
+NEXT_PUBLIC_CLERK_AFTER_SIGN_UP_URL=/dashboard

web/next.config.mjs

@@ -1,3 +1,14 @@
+import dotenv from "dotenv"
+import path from "path"
+import { fileURLToPath } from "url"
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+// Load parent .env first
+// Then load local .env to override
+dotenv.config({ path: path.resolve(__dirname, "../.env") })
+dotenv.config({ path: path.resolve(__dirname, ".env") })
+
 /** @type {import('next').NextConfig} */
 const nextConfig = {
   async headers() {