{"id":"697cd738477750fae1691126","title":"2026 01 30","path":"how-to/committee/release-notes/2026-01-30","contentMarkdown":"# 30-Jan-2026 — Environment-setup: automated environment creation and CLI enhancements [#146](https://github.com/nbarrett/ngx-ramblers/issues/146)\n\n## [build 452](https://github.com/nbarrett/ngx-ramblers/actions/runs/21521865466) — [commit b330b7b](https://github.com/nbarrett/ngx-ramblers/commit/b330b7b87430bf4a1151a8ea97cf058ead93065b)\n\n _____\n\n**New Features for Users:**\n\n**Environment Setup (Web UI)**\n\nThe new Environment Setup page (Admin > Environment Setup) allows administrators to create complete NGX-Ramblers environments for new Ramblers walking groups through a guided wizard:\n\n1. Enter your Ramblers API key and select your walking group\n2. Configure external services (MongoDB, AWS, Brevo email, maps)\n3. Set up an admin user account\n4. Deploy to fly.io with one click\n\nThe wizard handles all infrastructure provisioning automatically including:\n- Cloud database setup and configuration\n- File storage (AWS S3) with secure credentials\n- Application deployment to fly.io\n- Sample content and admin menu setup\n- Optional standard assets (logos, icons, backgrounds) copied to S3\n\n### Command Line Interface (CLI)\n\nA new CLI tool is available for power users and automation. See the full reference guide at: Admin > How-To > Technical Documents > \"NGX Ramblers CLI Reference Guide\"\n\n**Quick start:**\n\n ```bash\n npm run cli -- # Run from project root\n npm link && ngx-cli # Or install globally (optional)\n\n Common commands:\n\n ngx-cli l dev my-group # Start local development\n ngx-cli l list # List available environments\n ngx-cli db seed my-group --fresh # Fresh database seed with migrations\n ngx-cli db seed my-group --sync # Seed and sync walks from Ramblers API\n ngx-cli f deploy my-group # Deploy to fly.io\n ngx-cli des my-group # Destroy environment completely\n ngx-cli bak create my-group # Backup an environment\n ngx-cli bak restore my-group # Restore from backup\n\n Interactive mode: Run commands without arguments to get a selection menu. Use arrow keys to navigate, ESC to go back, q to quit.\n```\n---\n#### Technical Changes:\n\nCLI Implementation:\n- Add command aliases (env, db, val, des, l, f, a, bak)\n- Add positional arguments instead of --name options\n- Add interactive navigation with inquirer.js\n- Add port availability checking for local dev\n- Run migrations automatically after database seeding\n- Add backup/restore commands (bak create, bak restore, bak list)\n\n#### Database & Migrations:\n- Add Duplicate Page Content and Venue Settings to admin menu\n- Add showPlaceholderImage to walks action buttons\n- Include all 23 production admin menu items in migrations\n\n#### Environment Setup Service:\n- Integrate with Ramblers API for group validation\n- Automate AWS S3/IAM resource creation\n- Automate fly.io deployment with secrets\n- Create database config templates for new groups\n- Add WebSocket progress feedback for real-time step updates\n- Add copyStandardAssets option to seed S3 with logos/icons/backgrounds\n- Add OS Maps and reCAPTCHA defaults from environment variables\n- Add detailed MongoDB connection error messages with suggestions\n- Add ENVIRONMENT_SETUP_ENABLED env var to control UI access","contentHtml":"

30-Jan-2026 — Environment-setup: automated environment creation and CLI enhancements #146

\n

build 452 — commit b330b7b

\n
\n

New Features for Users:

\n

Environment Setup (Web UI)

\n

The new Environment Setup page (Admin > Environment Setup) allows administrators to create complete NGX-Ramblers environments for new Ramblers walking groups through a guided wizard:

\n
    \n
  1. Enter your Ramblers API key and select your walking group
    2. \n
  2. Configure external services (MongoDB, AWS, Brevo email, maps)
    3. \n
  3. Set up an admin user account
    4. \n
  4. Deploy to fly.io with one click
    5. \n
\n

The wizard handles all infrastructure provisioning automatically including:

\n\n

Command Line Interface (CLI)

\n

A new CLI tool is available for power users and automation. See the full reference guide at: Admin > How-To > Technical Documents > "NGX Ramblers CLI Reference Guide"

\n

Quick start:

\n
npm run cli -- <command>           # Run from project root\nnpm link && ngx-cli <command>      # Or install globally (optional)\n\nCommon commands:\n\nngx-cli l dev my-group             # Start local development\nngx-cli l list                     # List available environments\nngx-cli db seed my-group --fresh   # Fresh database seed with migrations\nngx-cli db seed my-group --sync    # Seed and sync walks from Ramblers API\nngx-cli f deploy my-group          # Deploy to fly.io\nngx-cli des my-group               # Destroy environment completely\nngx-cli bak create my-group        # Backup an environment\nngx-cli bak restore my-group       # Restore from backup\n\nInteractive mode: Run commands without arguments to get a selection menu. Use arrow keys to navigate, ESC to go back, q to quit.\n
\n
\n

Technical Changes:

\n

CLI Implementation:

\n\n

Database & Migrations:

\n\n

Environment Setup Service:

\n\n"}