Skip to content

docs(api-development): add CORS configuration guide and examples - #110

Merged
PAMulligan merged 1 commit into
mainfrom
55-add-cors-configuration-guide-and-examples
Jun 10, 2026
Merged

docs(api-development): add CORS configuration guide and examples#110
PAMulligan merged 1 commit into
mainfrom
55-add-cors-configuration-guide-and-examples

Conversation

@PAMulligan

Copy link
Copy Markdown
Contributor

Summary

  • Add docs/api-development/cors-configuration.md, a dedicated CORS guide covering:
    • What CORS is and why it exists
    • How Hono's cors() middleware works (options reference, middleware ordering, Nerva pipeline defaults from .claude/pipeline.config.json)
    • Development configuration (wildcard *)
    • Production configuration (explicit env-driven origin allowlist)
    • Credentials mode (Access-Control-Allow-Credentials)
    • Preflight caching (maxAge, browser caps)
    • Common CORS errors with causes, fixes, and a curl-based debugging workflow
    • Cloudflare Workers considerations (per-request env bindings, wrangler.toml per-environment origins, uncaught exceptions masquerading as CORS errors, Pages preview deployments, edge caching, Cloudflare Access)
  • Link the guide from the CORS section of docs/api-development/README.md

Closes #55

🤖 Generated with Claude Code

Add a dedicated guide covering what CORS is, how Hono's cors()
middleware works, development (wildcard) and production (allowlist)
configurations, credentials mode, preflight caching, common CORS
errors with debugging steps, and Cloudflare Workers considerations.
Link the guide from the API development standards README.

Closes #55

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@PAMulligan PAMulligan linked an issue Jun 10, 2026 that may be closed by this pull request
5 tasks
@PAMulligan
PAMulligan merged commit cb0f219 into main Jun 10, 2026
5 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add CORS configuration guide and examples

1 participant