Create README.md

1 files changed, 63 insertions, 0 deletions

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..dd76639
--- /dev/null
+++ b/README.md
@@ -0,0 +1,63 @@
+# apps.apple.com
+
+Apple App Store frontend source code archive
+
+## About
+
+This repository contains the frontend source code extracted from [https://apps.apple.com/](https://apps.apple.com/).
+
+Saved using the Chrome extension [Save All Resources](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb).
+
+### How is this possible?
+
+Because Apple forgot to disable sourcemaps in production on the App Store website 🙃
+
+<img width="795" height="548" alt="image" src="https://github.com/user-attachments/assets/59211dfb-5a56-456b-85b8-d292c1cfbfa2" />
+
+As an interesting discovery, I've archived them here on GitHub for educational purposes.
+
+## Directory Structure
+
+```
+.
+├── api/          # API related code
+├── assets/       # Static assets
+├── node_modules/ # Dependencies
+├── shared/       # Shared modules
+├── src/          # Source code
+│   ├── components/
+│   ├── config/
+│   ├── constants/
+│   ├── context/
+│   ├── stores/
+│   └── utils/
+└── us/           # US region specific
+```
+
+## What's Inside
+
+- Complete React/TypeScript source code
+- State management logic
+- UI components
+- API integration code
+- Routing configuration
+- And more...
+
+## Disclaimer
+
+This repository is for educational and research purposes only. All code is copyrighted by Apple Inc.
+
+The source code was obtained from publicly accessible resources through browser developer tools.
+
+## License
+
+The content in this repository belongs to Apple Inc. If there are any copyright concerns, please contact for removal.
+
+---
+
+*Remember: Always disable sourcemaps in production! 😉*
+
+## Related
+
+- [Apple App Store](https://apps.apple.com/)
+- [Save All Resources Extension](https://chromewebstore.google.com/detail/save-all-resources/abpdnfjocnmdomablahdcfnoggeeiedb)