DevBox (Local Test Kit)

Run a full InfinityMetrics stack locally in seconds. The DevBox starts the server and a beautiful demo page so you can click around, send events, and see data flow — no real license required.

One‑liner

# Raw GitHub (main branch)
curl -fsSL https://raw.githubusercontent.com/karloscodes/infinity-metrics-devbox/refs/heads/main/setup.sh | bash

• Opens at: http://localhost:8080
• Dashboard: http://localhost:8080/admin
• Ports: uses only 8080 (HTTP)
• License: uses a test license automatically in test mode

Note: If your browser asks for geolocation, allowing it makes the background globe “pulse” from your region — purely visual.

Prerequisites

• Docker Desktop (or compatible Docker engine) running
• macOS, Linux, or Windows with Bash (PowerShell works if WSL/Docker Desktop is available)

What you get

• Reverse‑proxied InfinityMetrics at localhost:8080
• A demo page with interactive events (custom event, purchase, page view, link tracking)
• A 3D globe background (visual only) that pulses when you trigger events
• Test environment + placeholder license key with guardrails

Manual install (alternative)

# Clone the DevBox repo
git clone https://github.com/karloscodes/infinity-metrics-devbox.git
cd infinity-metrics-devbox

# Start
./setup.sh

# Or, if you just want docker compose
docker compose up -d

Open:

• Demo: http://localhost:8080
• Dashboard: http://localhost:8080/admin

How licensing works in DevBox

• The DevBox runs the app with INFINITY_METRICS_ENV=test and INFINITY_METRICS_DOMAIN=localhost.
• A test‑only key is used automatically and accepted only in this test + localhost configuration.
• In any non‑test or non‑localhost environment, test keys are rejected.

Troubleshooting

• Port in use: ensure nothing else listens on 8080.
• First run: images may need a minute to start; the script polls health and shows status.
• Browser cache: if styles or the globe look odd, hard refresh (Cmd/Ctrl+Shift+R).
• Windows: ensure Docker Desktop is running; use WSL for best results.