Overhaul env management to rely on .env

Goal is to make it straightforward to manage local dev environment
variables whether using devbox, devbox with direnv, devcontainer, or
none of the above.

Author: prestoncabe

.devcontainer/Dockerfile

@@ -9,7 +9,6 @@ COPY --chown=${DEVBOX_USER}:${DEVBOX_USER} devbox.json devbox.json
 COPY --chown=${DEVBOX_USER}:${DEVBOX_USER} devbox.lock devbox.lock
 
 
-
 RUN devbox run -- echo "Installed Packages." && nix-store --gc && nix-store --optimise
 
 RUN devbox shellenv --init-hook >> ~/.profile

.devcontainer/devcontainer.json

@@ -4,6 +4,7 @@
     "dockerfile": "./Dockerfile",
     "context": ".."
   },
+  "postCreateCommand": "devbox run setup",
   "customizations": {
     "vscode": {
       "settings": {},
@@ -13,4 +14,4 @@
     }
   },
   "remoteUser": "devbox"
-}
+}

.env.example

@@ -0,0 +1,6 @@
+QUARKUS_GOOGLE_CLOUD_PROJECT_ID="demo-bdt-dev"
+QUARKUS_GOOGLE_CLOUD_FIREBASE_AUTH_EMULATOR_HOST="localhost:9099"
+QUARKUS_GOOGLE_CLOUD_STORAGE_HOST_OVERRIDE="http://127.0.0.1:9199"
+GCS_BUCKET_NAME="demo-bdt-dev.appspot.com"
+FIRESTORE_EMULATOR_HOST="127.0.0.1:8080"
+

.envrc

@@ -65,6 +65,8 @@ node_modules/
 # dotenv environment variables file
 .env
 
+.envrc
+
 # dataconnect generated files
 .dataconnect
 # IntelliJ
@@ -74,3 +76,5 @@ node_modules/
 *.iws
 
 .quarkus/
+
+bin/devbox-init-hook

.gitignore

@@ -10,5 +10,5 @@ set -e
 # IMPORTANT: don't use this script for environment variables; use .env instead.
 
 # e.g. disable mise in devbox shell
-command -v mise >/dev/null && mise --quiet deactivate || true
+# command -v mise >/dev/null && mise deactivate || true
 

bin/devbox-init-hook bin/devbox-init-hook.examplebin/devbox-init-hook renamed to bin/devbox-init-hook.example

@@ -0,0 +1,18 @@
+#!/usr/bin/env bash
+
+set -e
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+
+source "$SCRIPT_DIR/functions"
+
+print_status "🔍 Checking for existing root .env..."
+if [ -f ".env.example" ] && [ ! -f ".env" ]; then
+  cp ".env.example" ".env"
+  print_success "✓ Created root .env from .env.example"
+elif [ -f ".env" ]; then
+  print_status "○ Using existing root .env"
+else
+  print_error "⚠ Error: Root .env.example not found"
+  exit 1
+fi

bin/ensure-root-env-file

@@ -28,6 +28,20 @@ else
   print_status "devbox already installed."
 fi
 
+bin/ensure-root-env-file
+
+print_status "🔍 Checking for existing bin/devbox-init-hook..."
+if [ -f "bin/devbox-init-hook.example" ] && [ ! -f "bin/devbox-init-hook" ]; then
+  cp "bin/devbox-init-hook.example" "bin/devbox-init-hook"
+  chmod +x "bin/devbox-init-hook"
+  print_success "✓ Created bin/devbox-init-hook from example"
+elif [ -f "bin/devbox-init-hook" ]; then
+  print_status "○ bin/devbox-init-hook already exists"
+else
+  print_error "⚠ Error: bin/devbox-init-hook.example not found."
+  exit 1
+fi
+
 print_status "📦 Setting up devbox environment..."
 if [ -f "devbox.json" ]; then
   devbox install

bin/install-devbox

@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+
+set -e
+
+set -a
+[ -f .env ] && source .env
+set +a

bin/load-root-env

@@ -11,6 +11,8 @@ source "$SCRIPT_DIR/functions"
 
 print_status "🚀 Starting Benefit Decision Toolkit Developer Setup..."
 
+echo ""
+
 if [[ "$DEVBOX_SHELL_ENABLED" != "1" ]]; then
   if ask_user "This project is configured to use devbox (https://www.jetify.com/devbox) to manage system dependencies. Do you want to use devbox? (default=yes)" "y"; then
     echo ""
@@ -88,10 +90,33 @@ cd ..
 
 print_status "Finished installing backend dependencies."
 
+echo ""
+
+print_status "Setting up environment files..."
+
+bin/ensure-root-env-file
+
+SERVICES=("builder-frontend" "screener-frontend" "builder-api" "screener-api" "library-api")
+for service in "${SERVICES[@]}"; do
+  if [ -f "$service/.env.example" ] && [ ! -f "$service/.env" ]; then
+    cp "$service/.env.example" "$service/.env"
+    print_success "✓ Created $service/.env from .env.example"
+  elif [ -f "$service/.env" ]; then
+    print_status "○ $service/.env already exists"
+  else
+    print_error "⚠ Error: $service/.env.example not found"
+    exit 1
+  fi
+done
+
+echo ""
+
 print_success "🎉 Developer setup completed successfully!"
 echo ""
 echo "📋 Next Steps:"
-echo "1. Ask a teammate to help you setup .env files in builder-frontend and screener-frontend."
+echo "1. Environment Configuration:"
+echo "  a. If you plan to use devbox and develop against local emulators, then you are good to go!"
+echo "  b. If not using devbox and/or plan to develop against real Firebase services, then you might need help from a teammate to finish setting up your environment."
 echo "2. If using devbox, then:"
 echo "  a. Run 'devbox shell' within the project root directory to load dependencies. (https://www.jetify.com/docs/devbox/cli_reference/devbox_shell/)"
 echo "  b. Consider using the direnv integration to load dependencies automatically. (https://www.jetify.com/docs/devbox/ide_configuration/direnv/)"