Skip to content

Commit 3854d98

Browse files
DavidLiedleclaude
andcommitted
Add README with book overview and acknowledgments
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent 040da34 commit 3854d98

1 file changed

Lines changed: 31 additions & 0 deletions

File tree

README.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# Understanding CORS
2+
3+
**Stop Copy-Pasting Headers and Start Understanding Cross-Origin Resource Sharing.**
4+
5+
Read the book online at [cloudstreet-dev.github.io/Understanding-CORS](https://cloudstreet-dev.github.io/Understanding-CORS/).
6+
7+
## About
8+
9+
This book covers CORS from first principles through production configuration and security. It's structured in five parts:
10+
11+
1. **The Problem CORS Solves** — The Same-Origin Policy, why browsers enforce it, and what an "origin" actually is.
12+
2. **How CORS Actually Works** — Simple requests, preflights, every header explained, credentials, and caching.
13+
3. **CORS in the Wild** — Fetch/XHR, WebSockets, fonts, SPAs, API gateways, and proxies.
14+
4. **Server-Side Configuration** — Express, Go, Rust, Python, Nginx, Apache, serverless, and edge functions.
15+
5. **Debugging and Security** — Reading error messages, common mistakes, security boundaries, and when `*` is fine.
16+
17+
## Building locally
18+
19+
Install [mdBook](https://rust-lang.github.io/mdBook/), then:
20+
21+
```sh
22+
mdbook serve --open
23+
```
24+
25+
## Acknowledgments
26+
27+
Thanks to Georgiy Treyvus, CloudStreet Product Manager, for the idea for this book.
28+
29+
## License
30+
31+
This work is dedicated to the public domain under [CC0 1.0 Universal](LICENSE).

0 commit comments

Comments
 (0)