feat(docs): use parameterized OpenAPI server URL

Replace the static `https://sofa.example.com/api/v1` server entry with a variable-based URL (`{protocol}://{host}:{port}/api/v1`) so the spec works against any instance out of the box. Also move the output path from `docs/openapi.json` to `docs/public/openapi.json` so the file is served as a static asset by the docs site.

apps/server/src/orpc/openapi-spec.ts

@@ -1,4 +1,7 @@
-import { OpenAPIGenerator } from "@orpc/openapi";
+import {
+  OpenAPIGenerator,
+  type OpenAPIGeneratorGenerateOptions,
+} from "@orpc/openapi";
 import { ZodToJsonSchemaConverter } from "@orpc/zod/zod4";
 import {
   BackupSchema,
@@ -214,7 +217,7 @@ export function normalizeOpenApiSpec<T extends OpenApiSpec>(spec: T): T {
 export async function generateOpenApiSpec(options: {
   title: string;
   version: string;
-  servers: Array<{ url: string }>;
+  servers: OpenAPIGeneratorGenerateOptions["servers"];
   sessionCookieName: string;
   tags?: Array<{ name: string; description?: string }>;
 }): Promise<OpenApiSpec> {

docs/content/docs/api/account/account.removeAvatar.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Delete the current user's profile avatar, reverting to the default.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/account/avatar","method":"delete"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/account/avatar","method":"delete"}]} />

docs/content/docs/api/account/account.updateName.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Change the current user's display name.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/account/name","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/account/name","method":"put"}]} />

docs/content/docs/api/account/account.uploadAvatar.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Upload a new profile avatar image. Accepts JPEG, PNG, WebP, or GIF up to 2 MB.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/account/avatar","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/account/avatar","method":"post"}]} />

docs/content/docs/api/admin/admin.backups.create.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Create a new manual database backup. The backup is tagged as a manual backup.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups","method":"post"}]} />

docs/content/docs/api/admin/admin.backups.delete.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Permanently delete a database backup file by filename.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups/{filename}","method":"delete"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups/{filename}","method":"delete"}]} />

docs/content/docs/api/admin/admin.backups.list.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Fetch all database backups with their sizes and creation times.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups","method":"get"}]} />

docs/content/docs/api/admin/admin.backups.restore.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Upload a database backup file and restore it. A pre-restore backup is automatically created before overwriting the current database.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups/restore","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups/restore","method":"post"}]} />

docs/content/docs/api/admin/admin.backups.schedule.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Fetch the current automated backup schedule configuration.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups/schedule","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups/schedule","method":"get"}]} />

docs/content/docs/api/admin/admin.backups.updateSchedule.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Update the automated backup schedule. Only provided fields are changed; omitted fields keep their current values.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/backups/schedule","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/backups/schedule","method":"put"}]} />

docs/content/docs/api/admin/admin.purgeImageCache.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Delete all cached TMDB images from disk. Images will be re-downloaded on demand.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/cache/purge-images","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/cache/purge-images","method":"post"}]} />

docs/content/docs/api/admin/admin.purgeMetadataCache.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Delete un-enriched stub titles not in any user's library and clean up orphaned person records.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/cache/purge-metadata","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/cache/purge-metadata","method":"post"}]} />

docs/content/docs/api/admin/admin.registration.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Check whether new user registration is currently open or closed.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/registration","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/registration","method":"get"}]} />

docs/content/docs/api/admin/admin.telemetry.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch whether anonymous telemetry is enabled and when the last report was sent.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/telemetry","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/telemetry","method":"get"}]} />

docs/content/docs/api/admin/admin.toggleRegistration.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Open or close new user registration.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/registration","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/registration","method":"put"}]} />

docs/content/docs/api/admin/admin.toggleTelemetry.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Enable or disable anonymous telemetry reporting.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/telemetry","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/telemetry","method":"put"}]} />

docs/content/docs/api/admin/admin.toggleUpdateCheck.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Enable or disable automatic update checks against the public API.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/update-check","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/update-check","method":"put"}]} />

docs/content/docs/api/admin/admin.triggerJob.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Manually trigger a background cron job by name. The job runs asynchronously.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/jobs/trigger","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/jobs/trigger","method":"post"}]} />

docs/content/docs/api/admin/admin.updateCheck.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch whether automatic update checks are enabled, and the latest cached check result if available.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/admin/update-check","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/admin/update-check","method":"get"}]} />

docs/content/docs/api/dashboard/dashboard.continueWatching.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch TV shows the user is currently watching, with the next unwatched episode and progress for each.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/dashboard/continue-watching","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/dashboard/continue-watching","method":"get"}]} />

docs/content/docs/api/dashboard/dashboard.library.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Fetch all titles in the user's library with their tracking statuses.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/dashboard/library","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/dashboard/library","method":"get"}]} />

docs/content/docs/api/dashboard/dashboard.recommendations.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch personalized title recommendations based on the user's library and watch history.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/dashboard/recommendations","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/dashboard/recommendations","method":"get"}]} />

docs/content/docs/api/dashboard/dashboard.stats.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch summary counts for the current user: movies watched this month, episodes this week, library size, and completed titles.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/dashboard/stats","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/dashboard/stats","method":"get"}]} />

docs/content/docs/api/dashboard/dashboard.watchHistory.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch the user's watch counts grouped by time period. Useful for rendering activity charts.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/dashboard/watch-history","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/dashboard/watch-history","method":"get"}]} />

docs/content/docs/api/discover/discover.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Browse movies or TV shows filtered by genre, sorted by popularity. Returns user statuses and episode progress.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/discover","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/discover","method":"get"}]} />

docs/content/docs/api/episodes/episodes.batchWatch.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Record watch events for multiple episodes at once. Useful for marking a range of episodes as watched.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/episodes/batch-watch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/episodes/batch-watch","method":"post"}]} />

docs/content/docs/api/episodes/episodes.unwatch.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Remove the watch record for a single TV episode.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/episodes/{id}/unwatch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/episodes/{id}/unwatch","method":"post"}]} />

docs/content/docs/api/episodes/episodes.watch.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Record a watch event for a single TV episode.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/episodes/{id}/watch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/episodes/{id}/watch","method":"post"}]} />

docs/content/docs/api/explore/explore.genres.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch the list of TMDB genres for movies or TV shows. Used to populate genre filters for discovery.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/explore/genres","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/explore/genres","method":"get"}]} />

docs/content/docs/api/explore/explore.popular.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch currently popular movies or TV shows from TMDB with the user's tracking statuses.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/explore/popular","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/explore/popular","method":"get"}]} />

docs/content/docs/api/explore/explore.trending.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch today's trending movies and/or TV shows from TMDB, including a featured hero title and the user's statuses.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/explore/trending","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/explore/trending","method":"get"}]} />

docs/content/docs/api/integrations/integrations.create.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Create a new media server integration or update an existing one. Generates a unique webhook token for the provider.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/integrations","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/integrations","method":"post"}]} />

docs/content/docs/api/integrations/integrations.delete.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Remove a media server integration and all its event history.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/integrations/{provider}","method":"delete"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/integrations/{provider}","method":"delete"}]} />

docs/content/docs/api/integrations/integrations.list.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch all configured media server integrations for the current user, including recent webhook/sync events for each.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/integrations","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/integrations","method":"get"}]} />

docs/content/docs/api/integrations/integrations.regenerateToken.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Generate a new webhook token for an integration. The old token is immediately invalidated.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/integrations/{provider}/regenerate-token","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/integrations/{provider}/regenerate-token","method":"post"}]} />

docs/content/docs/api/people/people.detail.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch a person's profile and filmography. Imports from TMDB on first access if not yet cached locally.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/people/{id}","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/people/{id}","method":"get"}]} />

docs/content/docs/api/people/people.resolve.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Look up or import a person by their TMDB ID. Returns the internal ID for use with other endpoints.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/people/resolve","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/people/resolve","method":"post"}]} />

docs/content/docs/api/search/search.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Full-text search across movies, TV shows, and people via TMDB. Optionally filter by media type.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/search","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/search","method":"get"}]} />

docs/content/docs/api/seasons/seasons.unwatch.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Remove all watch records for episodes in a season in a single operation.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/seasons/{id}/unwatch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/seasons/{id}/unwatch","method":"post"}]} />

docs/content/docs/api/seasons/seasons.watch.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Mark all episodes in a season as watched in a single operation.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/seasons/{id}/watch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/seasons/{id}/watch","method":"post"}]} />

docs/content/docs/api/system/system.authConfig.mdx

@@ -17,4 +17,4 @@ _openapi:
 
 Fetch the authentication configuration including OIDC availability, password login status, and registration state. Does not require authentication.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/system/auth-config","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/system/auth-config","method":"get"}]} />

docs/content/docs/api/system/system.health.mdx

@@ -17,4 +17,4 @@ _openapi:
 
 Comprehensive health check covering database, TMDB connectivity, cron jobs, image cache, backups, and environment. Does not require authentication.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/system/health","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/system/health","method":"get"}]} />

docs/content/docs/api/system/system.publicInfo.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch public information about this Sofa instance. Does not require authentication. Used by the login screen to display instance details.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/system/public-info","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/system/public-info","method":"get"}]} />

docs/content/docs/api/system/system.status.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Quick check of whether TMDB is configured. Does not require authentication.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/system/status","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/system/status","method":"get"}]} />

docs/content/docs/api/titles/titles.detail.mdx

@@ -17,4 +17,4 @@ _openapi:
 
 Fetch full title metadata including seasons, cast, and streaming availability. Imports from TMDB on first access if not yet cached locally.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}","method":"get"}]} />

docs/content/docs/api/titles/titles.hydrateSeasons.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch full season and episode data from TMDB for a TV show. Required before tracking individual episodes.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/hydrate-seasons","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/hydrate-seasons","method":"post"}]} />

docs/content/docs/api/titles/titles.quickAdd.mdx

@@ -17,4 +17,4 @@ _openapi:
 
 Import a title by TMDB ID and add it to the user's watchlist in one step. If the title already exists in the user's library, returns alreadyAdded: true.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/quick-add","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/quick-add","method":"post"}]} />

docs/content/docs/api/titles/titles.recommendations.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch similar titles based on locally cached recommendation data, along with the user's statuses for each.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/recommendations","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/recommendations","method":"get"}]} />

docs/content/docs/api/titles/titles.resolve.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Look up or import a title by its TMDB ID and media type. Returns the internal ID for use with other endpoints.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/resolve","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/resolve","method":"post"}]} />

docs/content/docs/api/titles/titles.updateRating.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Set a 0-5 star rating for a title. Use 0 to clear the rating.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/rating","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/rating","method":"put"}]} />

docs/content/docs/api/titles/titles.updateStatus.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Set the user's tracking status for a title. Use null to remove the title from the library entirely.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/status","method":"put"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/status","method":"put"}]} />

docs/content/docs/api/titles/titles.userInfo.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Fetch the current user's tracking status, rating, and watched episode IDs for a title.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/user-info","method":"get"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/user-info","method":"get"}]} />

docs/content/docs/api/titles/titles.watchAll.mdx

@@ -16,4 +16,4 @@ _openapi:
 
 Mark every episode of a TV show as watched. Requires seasons to be hydrated first.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/watch-all","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/watch-all","method":"post"}]} />

docs/content/docs/api/titles/titles.watchMovie.mdx

@@ -14,4 +14,4 @@ _openapi:
 
 Log a watch event for a movie. Automatically sets status to completed.
 
-<APIPage document={"./openapi.json"} operations={[{"path":"/titles/{id}/watch","method":"post"}]} />
+<APIPage document={"./public/openapi.json"} operations={[{"path":"/titles/{id}/watch","method":"post"}]} />

docs/content/docs/meta.json

@@ -10,6 +10,7 @@
     "mobile-app",
     "telemetry",
     "---API Reference---",
-    "...api"
+    "...api",
+    "external:[openapi.json](/openapi.json)"
   ]
 }

docs/public/openapi.json

@@ -5,7 +5,22 @@
   },
   "servers": [
     {
-      "url": "https://sofa.example.com/api/v1"
+      "url": "{protocol}://{host}:{port}/api/v1",
+      "variables": {
+        "protocol": {
+          "default": "http",
+          "enum": [
+            "http",
+            "https"
+          ]
+        },
+        "host": {
+          "default": "localhost"
+        },
+        "port": {
+          "default": "3000"
+        }
+      }
     }
   ],
   "tags": [

docs/src/lib/openapi.ts

@@ -1,5 +1,5 @@
 import { createOpenAPI } from "fumadocs-openapi/server";
 
 export const openapi = createOpenAPI({
-  input: ["./openapi.json"],
+  input: ["./public/openapi.json"],
 });

scripts/generate-openapi-spec.ts

@@ -7,7 +7,23 @@ import {
 const spec = await generateOpenApiSpec({
   title: "Sofa API",
   version: packageJson.version || "1.0.0",
-  servers: [{ url: "https://sofa.example.com/api/v1" }],
+  servers: [
+    {
+      url: "{protocol}://{host}:{port}/api/v1",
+      variables: {
+        protocol: {
+          default: "http",
+          enum: ["http", "https"],
+        },
+        host: {
+          default: "localhost",
+        },
+        port: {
+          default: "3000",
+        },
+      },
+    },
+  ],
   sessionCookieName: "better-auth.session_token",
   tags: [...openApiTags],
 });
@@ -55,5 +71,5 @@ for (const pathItem of Object.values(spec.paths ?? {})) {
   }
 }
 
-await Bun.write("docs/openapi.json", JSON.stringify(spec, null, 2));
+await Bun.write("docs/public/openapi.json", JSON.stringify(spec, null, 2));
 console.log("OpenAPI spec written to docs/openapi.json");