Merge pull request #44 from nativeapptemplate/env-var-refactor

Make dev server bind env-driven via HOST/PORT

Author: dadachi

.env.sample

@@ -0,0 +1,15 @@
+# Copy to .env and set HOST to your current Wi-Fi IP. `bin/dev`
+# sources this before launching Overmind.
+#
+# Rails, the iOS app, and the Android app must all agree on one
+# reachable address — your host's current Wi-Fi IP. On macOS:
+#
+#   ipconfig getifaddr en0
+#
+# Never use 127.0.0.1, localhost, or 0.0.0.0. When your Wi-Fi IP
+# changes, update HOST here and the matching values in the mobile
+# apps (Xcode scheme NATEMPLATE_API_DOMAIN and Android
+# ~/.gradle/gradle.properties NATEMPLATE_API_DOMAIN).
+
+HOST=192.168.1.21
+PORT=3000

.gitignore

@@ -10,6 +10,7 @@
 # Ignore all environment files (except templates).
 /.env*
 !/.env*.erb
+!/.env.sample
 
 # Ignore all logfiles and tempfiles.
 /log/*

CLAUDE.md

@@ -96,7 +96,7 @@ bin/rails dbconsole           # Database console
 - Run tests: `bin/rails test` (205 tests, 402 assertions)
 
 ### Development Server Configuration
-- Server binds to specific IP: `192.168.1.21:3000` (not localhost)
+- `HOST` (Wi-Fi IP) and `PORT` are required in `.env`; `Procfile.dev` uses `${HOST:?...}` so Rails fails loudly if unset, and `development.rb` uses `ENV.fetch("HOST")` for `action_mailer.default_url_options`. Must match `NATEMPLATE_API_DOMAIN` in the iOS scheme and Android `gradle.properties`. Never `127.0.0.1`, `localhost`, or `0.0.0.0`.
 - Mailbin for email testing at `/mailbin`
 - Admin interface at `/madmin`
 - Tailwind CSS compiled by tailwindcss-rails gem

Procfile.dev

@@ -1 +1 @@
-web: bin/rails server -p $PORT -b 192.168.1.21
+web: bin/rails server -p ${PORT:-3000} -b ${HOST:?HOST is required - set it in .env to your current Wi-Fi IP}

README.md

@@ -83,9 +83,9 @@ Run `bin/setup` to install Ruby and JavaScript dependencies and setup your datab
 bin/setup
 ```
 
-## Running NativeAppTemplate API on localhost
+## Running NativeAppTemplate API on your Wi-Fi
 
-Replace the IP address `192.168.1.21` with your localhost IP address in `Procfile.dev` and `config/environments/development.rb`.
+Copy `.env.sample` to `.env` and set `HOST` to your current Wi-Fi IP. On macOS: `ipconfig getifaddr en0`. `bin/dev` binds Rails to that address so the dev server is reachable from both the host browser and from any phone on the same network at `http://<wifi-ip>:3000`. When your Wi-Fi IP changes, update `HOST` here and the matching `NATEMPLATE_API_DOMAIN` in the mobile apps (Xcode scheme for iOS, `~/.gradle/gradle.properties` for Android) — Rails fails loudly if `HOST` is unset, which keeps the three sides honest. Never use `127.0.0.1`, `localhost`, or `0.0.0.0`.
 
 To run your application, you'll use the `bin/dev` command:
 

bin/dev

@@ -1,5 +1,13 @@
 #!/usr/bin/env sh
 
+# Load .env so HOST/PORT are inherited by Overmind and the spawned
+# processes. Overmind (unlike Foreman) does not auto-load .env.
+if [ -f .env ]; then
+  set -a
+  . ./.env
+  set +a
+fi
+
 # Default to port 3000 if not specified
 export PORT="${PORT:-3000}"
 

config/environments/development.rb

@@ -38,7 +38,11 @@
 
   config.action_mailer.perform_caching = false
 
-  config.action_mailer.default_url_options = {host: "192.168.1.21", port: ENV.fetch("PORT", 3000).to_i}
+  # .env is sourced by bin/dev for the dev server only; direct Rails
+  # invocations (console, test, setup, CI) don't see it, so default to
+  # localhost for the mailer so boot succeeds. Procfile.dev still refuses
+  # to start the dev server without an explicit HOST.
+  config.action_mailer.default_url_options = {host: ENV.fetch("HOST", "localhost"), port: ENV.fetch("PORT", 3000).to_i}
 
   # Print deprecation notices to the Rails logger.
   config.active_support.deprecation = :log