Update Railway configuration to modern schema

Co-authored-by: blackboxprogramming <118287761+blackboxprogramming@users.noreply.github.com>

README.md

@@ -18,7 +18,7 @@ Visit http://localhost:3000.
 npm run build
 npm start
 ```
-The start command serves the production build on port 8080.
+The start command serves the production build. By default, it uses port 3000, but you can set the `PORT` environment variable to use a different port (e.g., `PORT=8080 npm start`).
 
 ## Key routes
 - `/` – docs homepage
@@ -29,11 +29,16 @@ The start command serves the production build on port 8080.
 - `/api/info` – service metadata
 
 ## Railway deployment
-- Port: 8080
+
-- Healthcheck path: `/api/health`
+This project is configured for Railway deployment using `railway.json`. The configuration includes:
-- Build command: `npm install && npm run build`
+
-- Start command: `npm start`
+- **Port**: Railway will automatically set the `PORT` environment variable (typically 8080)
-- Required env vars: see `.env.example`
+- **Healthcheck path**: `/api/health`
+- **Build command**: `npm install && npm run build`
+- **Start command**: `npm start`
+- **Required env vars**: see `.env.example`
+
+The configuration uses Railway's modern schema with automatic restart on failure and health monitoring.
 
 ## Environment variables
 Copy `.env.example` and adjust values as needed for your environment. Service URLs default to the production `blackroad.systems` domains.

railway.json

@@ -1,10 +1,14 @@
 {
-  "build": "npm install && npm run build",
+  "$schema": "https://railway.com/railway.schema.json",
-  "start": "npm start",
+  "build": {
-  "service": {
+    "builder": "NIXPACKS",
-    "port": 8080,
+    "buildCommand": "npm install && npm run build"
-    "healthcheck": {
+  },
-      "path": "/api/health"
+  "deploy": {
-    }
+    "startCommand": "npm start",
+    "healthcheckPath": "/api/health",
+    "healthcheckTimeout": 100,
+    "restartPolicyType": "ON_FAILURE",
+    "restartPolicyMaxRetries": 3
   }
 }