feat: update base path from /api/cp to /ctrlplane across the application

Author: juicycleff

cmd/controlplane/main.go

@@ -43,7 +43,7 @@ func run() error {
 	cpExt := extension.New(
 		extension.WithStore(memory.New()),
 		extension.WithProvider("docker", dockerProv),
-		extension.WithBasePath("/api/cp"),
+		extension.WithBasePath("/ctrlplane"),
 	)
 
 	// Use the extension with Forge

docs/content/docs/concepts/configuration.mdx

@@ -86,7 +86,7 @@ extensions:
   ctrlplane:
     database_url: "postgres://localhost:5432/ctrlplane"
     default_provider: "k8s"
-    base_path: "/api/cp"
+    base_path: "/ctrlplane"
     health_interval: "30s"
     telemetry_flush_interval: "10s"
     max_instances_per_tenant: 100
@@ -101,7 +101,7 @@ In addition to the global config fields, the extension config adds:
 
 | Field | Type | Description | Default |
 |-------|------|-------------|---------|
-| `base_path` | `string` | URL prefix for all ctrlplane routes | `/api/cp` |
+| `base_path` | `string` | URL prefix for all ctrlplane routes | `/ctrlplane` |
 | `disable_routes` | `bool` | Disable automatic route registration | `false` |
 | `disable_migrate` | `bool` | Disable automatic database migration | `false` |
 

docs/content/docs/guides/forge-extension.mdx

@@ -43,7 +43,7 @@ extensions:
   ctrlplane:
     database_url: "postgres://localhost:5432/ctrlplane"
     default_provider: "k8s"
-    base_path: "/api/cp"
+    base_path: "/ctrlplane"
     health_interval: "30s"
     telemetry_flush_interval: "10s"
     max_instances_per_tenant: 100
@@ -83,7 +83,7 @@ When `RequireConfig` is `true` and no config is found under either key, `Registe
 |--------|---------|
 | `WithAuthProvider(p)` | Set the auth provider |
 | `WithProvider(name, p)` | Register a cloud provider |
-| `WithBasePath(path)` | Set the URL prefix (default: `/api/cp`) |
+| `WithBasePath(path)` | Set the URL prefix (default: `/ctrlplane`) |
 | `WithConfig(cfg)` | Set extension configuration directly |
 | `WithStore(opt)` | Pass a store option to the underlying Ctrl Plane |
 | `WithExtension(x)` | Register a plugin extension (lifecycle hooks) |

docs/content/docs/guides/full-example.mdx

@@ -104,7 +104,7 @@ cpExt := extension.New(
         Host:    dockerHost,
         Network: dockerNetwork,
     })),
-    extension.WithBasePath("/api/cp"),
+    extension.WithBasePath("/ctrlplane"),
     extension.WithAuthProvider(&auth.NoopProvider{
         DefaultTenantID: "default",
         DefaultClaims:   &auth.Claims{
@@ -118,7 +118,7 @@ cpExt := extension.New(
 forgeApp.RegisterExtension(cpExt)
 ```
 
-The extension mounts all 50+ Ctrl Plane API routes under `/api/cp` and starts background workers for reconciliation, health checks, and telemetry collection.
+The extension mounts all 50+ Ctrl Plane API routes under `/ctrlplane` and starts background workers for reconciliation, health checks, and telemetry collection.
 
 ## Step 4: Event subscriptions
 
@@ -229,15 +229,15 @@ Once the server is running, try these commands:
 curl -s http://localhost:8080/api/platform/status | jq
 
 # List seeded tenants
-curl -s http://localhost:8080/api/cp/v1/admin/tenants | jq
+curl -s http://localhost:8080/ctrlplane/v1/admin/tenants | jq
 
 # Create an instance
-curl -s -X POST http://localhost:8080/api/cp/v1/instances \
+curl -s -X POST http://localhost:8080/ctrlplane/v1/instances \
   -H "Content-Type: application/json" \
   -d '{"name":"my-app","provider":"docker","config":{"image":"nginx:alpine"}}' | jq
 
 # List instances
-curl -s http://localhost:8080/api/cp/v1/instances | jq
+curl -s http://localhost:8080/ctrlplane/v1/instances | jq
 
 # Health check
 curl -s http://localhost:8080/api/platform/health | jq

examples/saas-platform/.env.example

@@ -43,7 +43,7 @@ CP_STORE=memory
 # ---------------------------------------------------------------------------
 # Ctrl Plane API base path
 # ---------------------------------------------------------------------------
-CP_BASE_PATH=/api/cp
+CP_BASE_PATH=/ctrlplane
 
 # ---------------------------------------------------------------------------
 # Docker provider

examples/saas-platform/README.md

@@ -23,7 +23,7 @@ Open the interactive API docs at [http://localhost:8080/docs](http://localhost:8
 | Variable | Default | Description |
 |----------|---------|-------------|
 | `CP_STORE` | `memory` | Store backend: `memory`, `bun`, `badger`, `mongo` |
-| `CP_BASE_PATH` | `/api/cp` | URL prefix for all Ctrl Plane routes |
+| `CP_BASE_PATH` | `/ctrlplane` | URL prefix for all Ctrl Plane routes |
 | `CP_SEED` | `true` | Create demo tenants on startup |
 | `CP_DOCKER_HOST` | *(auto)* | Docker daemon address |
 | `CP_DOCKER_NETWORK` | `bridge` | Docker network for containers |
@@ -80,7 +80,7 @@ go run ./examples/saas-platform
 
 ## Custom Platform Endpoints
 
-In addition to the full Ctrl Plane API (under `/api/cp`), this example adds:
+In addition to the full Ctrl Plane API (under `/ctrlplane`), this example adds:
 
 | Method | Path | Description |
 |--------|------|-------------|
@@ -101,13 +101,13 @@ curl -s http://localhost:8080/api/platform/status | jq
 ### List tenants (seeded)
 
 ```bash
-curl -s http://localhost:8080/api/cp/v1/admin/tenants | jq
+curl -s http://localhost:8080/ctrlplane/v1/admin/tenants | jq
 ```
 
 ### Create an instance
 
 ```bash
-curl -s -X POST http://localhost:8080/api/cp/v1/instances \
+curl -s -X POST http://localhost:8080/ctrlplane/v1/instances \
   -H "Content-Type: application/json" \
   -d '{
     "name": "my-app",
@@ -123,7 +123,7 @@ curl -s -X POST http://localhost:8080/api/cp/v1/instances \
 ### List instances
 
 ```bash
-curl -s http://localhost:8080/api/cp/v1/instances | jq
+curl -s http://localhost:8080/ctrlplane/v1/instances | jq
 ```
 
 ### Check platform health

examples/saas-platform/main.go

@@ -377,7 +377,7 @@ func run() error {
 	// 1. Read configuration from environment
 	// -----------------------------------------------------------------------
 	storeType := envOrDefault("CP_STORE", "memory")
-	basePath := envOrDefault("CP_BASE_PATH", "/api/cp")
+	basePath := envOrDefault("CP_BASE_PATH", "/ctrlplane")
 	seed := envBool("CP_SEED", true)
 	dockerHost := envOrDefault("CP_DOCKER_HOST", "")
 	dockerNetwork := envOrDefault("CP_DOCKER_NETWORK", "bridge")

extension/config.go

@@ -44,7 +44,7 @@ type Config struct {
 func DefaultConfig() Config {
 	return Config{
 		Config:   ctrlplane.DefaultCtrlPlaneConfig(),
-		BasePath: "/api/cp",
+		BasePath: "/ctrlplane",
 	}
 }
 

extension/extension.go

@@ -152,7 +152,11 @@ func (e *Extension) Init(fapp forge.App) error {
 	e.api = api.New(e.cp, fapp.Router())
 
 	if !e.config.DisableRoutes {
-		e.api.RegisterRoutes(fapp.Router())
+		basePath := e.config.BasePath
+		if basePath == "" {
+			basePath = "/ctrlplane"
+		}
+		e.api.RegisterRoutes(fapp.Router().Group(basePath))
 	}
 
 	return nil

go.mod

@@ -5,13 +5,13 @@ go 1.25.7
 require (
 	github.com/a-h/templ v0.3.1001
 	github.com/dgraph-io/badger/v4 v4.9.1
-	github.com/xraph/forge v1.3.1
-	github.com/xraph/forgeui v1.3.0
-	github.com/xraph/go-utils v1.0.0
-	github.com/xraph/grove v1.3.0
-	github.com/xraph/grove/drivers/mongodriver v1.3.0
-	github.com/xraph/grove/drivers/pgdriver v1.3.0
-	github.com/xraph/grove/drivers/sqlitedriver v1.3.0
+	github.com/xraph/forge v1.4.0
+	github.com/xraph/forgeui v1.4.0
+	github.com/xraph/go-utils v1.1.0
+	github.com/xraph/grove v1.4.0
+	github.com/xraph/grove/drivers/mongodriver v1.4.0
+	github.com/xraph/grove/drivers/pgdriver v1.4.0
+	github.com/xraph/grove/drivers/sqlitedriver v1.4.0
 	github.com/xraph/vessel v1.0.0
 	go.jetify.com/typeid/v2 v2.0.0-alpha.3
 	go.mongodb.org/mongo-driver/v2 v2.5.0
@@ -114,7 +114,7 @@ require (
 	golang.org/x/sync v0.19.0 // indirect
 	golang.org/x/sys v0.41.0 // indirect
 	golang.org/x/term v0.39.0 // indirect
-	golang.org/x/text v0.33.0 // indirect
+	golang.org/x/text v0.34.0 // indirect
 	golang.org/x/time v0.12.0 // indirect
 	google.golang.org/genproto/googleapis/api v0.0.0-20260128011058-8636f8732409 // indirect
 	google.golang.org/genproto/googleapis/rpc v0.0.0-20260128011058-8636f8732409 // indirect