Skip to content

gridaco/cors.sh

Repository files navigation

cors.sh

cors.sh

The only cors proxy service all you'll ever need.

| Website | Proxy (proxy.cors.sh) | Playground | Docs |

Usage

Quick testing Use cors.sh/playground for testing out your cors blocked request.

JS

Add proxy.cors.sh to your request. For example,

fetch("https://proxy.cors.sh/https://example.com/");

A built-in, in-browser CORS tester: paste any URL and watch the direct request get blocked by CORS, then watch the same request through proxy.cors.sh succeed — status, headers, and body, side by side. No API key required.

It defaults to mock.cors.sh — our own CORS-reject test API (/no-cors, /wrong-origin, /needs-preflight, /allow-all), handy whenever you need an endpoint that reliably fails CORS.

Projects using CORS.SH

Contributing

Monorepo on pnpm + turbo, hosted on Cloudflare Workers (own accounts + billing). Requires Node ≥ 22.

git clone https://github.com/gridaco/cors.sh
cd cors.sh && nvm use && pnpm install
pnpm stack:up      # run the full stack locally (web + proxy + mock)
pnpm test:e2e      # run the test suite

See DEVELOPMENT.md for the full local setup, SPEC.md for how the service behaves (source of truth), and AGENTS.md if you're working with an AI coding agent.

Disclaimer

  1. This project's intend is to serve developers a reliable cors proxy service with fast response for their development. Using a cors proxy service to connect to your own server is not a best practice. We'll consistently optimize our service infra to keep the paid version affordable as possible.

  2. cors.sh draws its lineage from Rob W's cors-anywhere (the proxy) and previously shipped a Hoppscotch fork as its playground — both MIT. The current service is a ground-up rebuild on Cloudflare Workers with its own built-in playground, also MIT-licensed.

TODOs

  • Cost optimization - make it more cheap & provide free version to all.
  • Management console - Enable usesrs to create projects as much as they want.
  • OSS Application pipeline - Make OSS developers to get their api key right-on and get verified later.

Misc

Design file

Figma

About

Sick of CORS Errors?

Topics

Resources

License

Stars

232 stars

Watchers

2 watching

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors