Implementation: How to configure API URLs for a new Angular app or library i...

Documentation for Sessions

⚙️ Implementation: How to configure API URLs for a new Angular app or library i...

Date: 2026-01-28
Time: 16:53:54 UTC
Session: editor2-72.80
Agent: backend
Confidence: 100%
Status: ✅ Documented


📋 Decision Context

Question:

How to configure API URLs for a new Angular app or library in the GoGrab monorepo?

Task: Not specified


🎯 Decision Made

Chosen:

Use @libs-foundational/api-config tokens. This library provides: API_BASE_URL (backend-api, port 3000, api.gograb.space), AI_API_URL (backend-ai-api, port 3001, ai-api.gograb.space), DOCS_API_URL (backend-docs-api, port 3002, docs-api.gograb.space). For apps: use provideApiConfigWithMock() in app.config.ts. For services: inject tokens directly via inject(API_BASE_URL).

Options Considered:

  1. Hardcode API URLs directly in services
  2. Import from environment files directly
  3. Use @libs-foundational/api-config tokens

💭 Reasoning

The api-config library is the single source of truth for all API URLs. It provides: 1) Smart environment detection (localhost vs production), 2) Consistent tokens across all libraries, 3) No circular dependencies, 4) Easy mock API support. NEVER hardcode /api or localhost URLs in services - always use these tokens.


📁 Files Involved


🔗 Related


Auto-generated by MCP Smart Consolidation