prayags007/deterministic-insights-frontend repository overview

⁠Deterministic Insights — Frontend

Customer Success Insights · Next.js image for Deterministic Insights⁠.

Web UI for secure login, business dashboard, customer and interaction management, and AI insight generation against the FastAPI backend.

Use this image for: the browser-facing Next.js app (:3000). Pair it with the backend API image and a reachable Postgres/Redis stack (or hosted API).
Backend image: https://hub.docker.com/r/prayags007/deterministic-insights-backend⁠
Login path: /login

Build note: NEXT_PUBLIC_* values are baked in at build time. Rebuild (or use a prebuilt image aimed at your API) if the API base URL changes — docker run -e will not override them.

⁠Quick start (docker run)

The API must be reachable from the browser (host network / public URL), not only via Docker DNS. Backend CORS_ORIGINS must include this UI origin.

docker pull prayags007/deterministic-insights-frontend:latest

docker run -d --name csip-frontend -p 3000:3000 \
  prayags007/deterministic-insights-frontend:latest

Open: http://localhost:3000⁠

If you need a different API URL, rebuild first:

docker build -t prayags007/deterministic-insights-frontend:latest \
  --build-arg NEXT_PUBLIC_API_BASE_URL=http://localhost:8000/api/v1 \
  --build-arg NEXT_PUBLIC_INSIGHT_GENERATE_TIMEOUT_MS=120000 \
  .

⁠Important environment variables

Runtime for this image is mostly fixed after build. Set these when building:

Never put JWT secrets, database passwords, or API keys in frontend env — only public API config.

⁠Minimal configuration example

Local API:

NEXT_PUBLIC_API_BASE_URL=http://localhost:8000/api/v1
NEXT_PUBLIC_INSIGHT_GENERATE_TIMEOUT_MS=120000

Production API:

NEXT_PUBLIC_API_BASE_URL=https://deterministicinsightsbackend-production.up.railway.app/api/v1
NEXT_PUBLIC_INSIGHT_GENERATE_TIMEOUT_MS=120000

Prefer Docker Compose for a full local stack (Postgres + Redis + backend + this image). Env templates live in the GitHub repo (.env.local.example).

Demo app logins (seeded by the backend): see the GitHub README.

⁠Full documentation

Setup, architecture diagrams, feature map, and troubleshooting:

https://github.com/Prayag-Sheth/deterministic_insights_frontend/blob/main/README.md⁠

Companion API (GitHub): https://github.com/Prayag-Sheth/deterministic_insights_backend⁠
Backend image: https://hub.docker.com/r/prayags007/deterministic-insights-backend⁠
Live app: https://deterministic-insights-frontend.vercel.app/⁠
API Swagger: https://deterministicinsightsbackend-production.up.railway.app/api/v1/docs⁠