Skip to content

fix(cli): link dev banner to interactive API docs instead of root#1512

Merged
xuyushun441-sys merged 1 commit into
mainfrom
fix/banner-api-docs
Jun 2, 2026
Merged

fix(cli): link dev banner to interactive API docs instead of root#1512
xuyushun441-sys merged 1 commit into
mainfrom
fix/banner-api-docs

Conversation

@xuyushun441-sys

Copy link
Copy Markdown
Contributor

What

The dev startup banner's API: line pointed at / — the server root, not the API. This replaces it with an API Docs link to the interactive Scalar/OpenAPI explorer:

  ➜  API Docs:  http://localhost:3999/api/v1/docs
  ➜  Console:   http://localhost:3999/_console/

Why

Probing the running showcase:

Path Result
/api/v1/docs 200 HTML — interactive Scalar API explorer
/api/v1 200 JSON — machine-facing route index
/api/v1/ 404 (trailing slash)
/ (old API: target) 302 redirect — not the API

The interactive docs is the useful human entry point; the bare /api/v1 index is machine-facing and not worth a banner line, and the old / target was misleading. Adds an optional apiBasePath (default /api/v1).

Verified: banner renders the two lines; GET /api/v1/docs → 200 HTML, GET /api/v1/openapi.json → 200. cli tests 144 ✓.

🤖 Generated with Claude Code

The ready banner's `API:` line pointed at `/` — the server root, not the
API. Replace it with an `API Docs:` link to `<apiBase>/docs`, the
interactive Scalar/OpenAPI explorer, which is the actual human entry point
into the running API. The bare `/api/v1` index is a machine-facing route
list and isn't worth a banner line. Adds an optional `apiBasePath`
(default `/api/v1`).

  ➜  API Docs:  http://localhost:3999/api/v1/docs
  ➜  Console:   http://localhost:3999/_console/

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@vercel

vercel Bot commented Jun 2, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
spec Building Building Preview, Comment Jun 2, 2026 3:36am

Request Review

@github-actions github-actions Bot added size/s documentation Improvements or additions to documentation tooling labels Jun 2, 2026
@xuyushun441-sys xuyushun441-sys merged commit d321b9f into main Jun 2, 2026
10 of 11 checks passed
@xuyushun441-sys xuyushun441-sys deleted the fix/banner-api-docs branch June 2, 2026 03:38
xuyushun441-sys pushed a commit that referenced this pull request Jun 2, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation size/s tooling

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants