diff --git a/README.md b/README.md
index c146aee..4f20db5 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,55 @@
-"# .github" 
+<div align="center">
+
+<img src="./assets/logo.png" alt="Minecraft Legacy Edition" width="560" />
+
+<br/>
+
+### Preserving Minecraft's history
+
+[![Website](https://img.shields.io/badge/minecraftlegacy.com-222?style=for-the-badge&logo=firefox&logoColor=88bb55)](https://minecraftlegacy.com)
+[![Discord](https://img.shields.io/badge/Join%20Discord-5865F2?style=for-the-badge&logo=discord&logoColor=fff)](https://discord.gg/MinecraftLegacy)
+[![Buy Me a Coffee](https://img.shields.io/badge/Buy%20Me%20a%20Coffee-ffdd00?style=for-the-badge&logo=buy-me-a-coffee&logoColor=000)](https://buymeacoffee.com/minecraftlegacy)
+
+---
+
+</div>
+
+## 🏗️ What is Minecraft Legacy?
+
+**Minecraft Legacy** is a community-driven initiative dedicated to **archiving, preserving, and indexing** legacy Minecraft source code, tools, launchers, and resources that might otherwise be lost to time.
+
+The source code for Minecraft Legacy Console Edition (October 2014 build) was recently leaked on 4chan. The community has been working to **preserve, fix, and build upon** that codebase - ensuring it isn't lost to history. Minecraft Legacy exists to support and index these preservation efforts alongside other legacy projects.
+
+We maintain a curated index of repositories spanning old editions, fan-made tools, archived source dumps, and community projects - all searchable and sorted by priority on our website.
+
+## 📦 Key Repositories
+
+| Repo | Description |
+|------|-------------|
+| [**json**](https://github.com/MinecraftConsole/json) | Project registry - the JSON data that powers the site's repo list |
+
+> More repos coming soon - the website source code will be open-sourced shortly.
+
+## 🔍 How It Works
+
+All listed projects live in a single [`projects.json`](https://github.com/MinecraftConsole/json/blob/main/projects.json) file. The website fetches this at runtime and renders a searchable, paginated index with priority rankings.
+
+**Want to add a project?** Open an issue or PR on the [json repo](https://github.com/MinecraftConsole/json) using our templates.
+
+## 🤝 Contributing
+
+We welcome contributions! Whether it's submitting a legacy project to the index, reporting a bug on the site, or improving documentation - every bit helps preserve Minecraft history.
+
+1. **Submit a project** → [Open an issue](https://github.com/MinecraftConsole/json/issues/new?template=project-request.yml) on the json repo
+2. **Report a bug** → [Open an issue](https://github.com/MinecraftConsole/json/issues/new?template=bug-report.yml)
+3. **Contribute code** → More repos will be open-sourced soon - stay tuned!
+
+<div align="center">
+
+---
+
+<sub>Not affiliated with Mojang AB or Microsoft. "Minecraft" is a trademark of Mojang Synergies AB.</sub>
+
+<img src="./assets/steveandalex.png" alt="Steve and Alex" width="120" />
+
+</div>
diff --git a/assets/logo.png b/assets/logo.png
new file mode 100644
index 0000000..416d9fa
Binary files /dev/null and b/assets/logo.png differ
diff --git a/assets/steveandalex.png b/assets/steveandalex.png
new file mode 100644
index 0000000..b898a91
Binary files /dev/null and b/assets/steveandalex.png differ