diff --git a/.github/images/apk.png b/.github/images/apk.png
new file mode 100644
index 0000000..d7850af
Binary files /dev/null and b/.github/images/apk.png differ
diff --git a/.github/images/izzy.png b/.github/images/izzy.png
new file mode 100644
index 0000000..af5bf5b
Binary files /dev/null and b/.github/images/izzy.png differ
diff --git a/README.md b/README.md
index e69de29..e08e265 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,67 @@
+<!--suppress ALL -->
+<div align="center">
+  <h1>Beans</h1>
+  <img width="100px" src="./metadata/en-US/images/icon.png" alt="Logo">
+  
+  <p>A virtual scratchmap of the world</p>
+  
+  <img src="https://forthebadge.com/images/badges/built-for-android.svg" alt="Built for Android">
+  <img src="https://forthebadge.com/images/badges/built-with-love.svg" alt="Built with love">
+  <br>
+    <a href="https://github.com/choelzl/beans/actions/workflows/build.yml">
+    <img src="https://github.com/choelzl/beans/actions/workflows/build.yml/badge.svg?branch=main" alt="Build Status">
+  </a>
+</div>
+
+## 🌄 Screenshots
+
+<div align="center">
+  <table>
+    <tr>
+      <td style="width: 33%; height: 100px;"><img src="./metadata/en-US/images/phoneScreenshots/launcher.jpg" alt="Launcher" style="width: 100%; height: 100%;"></td>
+      <td style="width: 33%; height: 100px;"><img src="./metadata/en-US/images/phoneScreenshots/view.jpg" alt="View" style="width: 100%; height: 100%;"></td>
+      <td style="width: 33%; height: 100px;"><img src="./metadata/en-US/images/phoneScreenshots/edit.jpg" alt="Edit" style="width: 100%; height: 100%;"></td>
+    </tr>
+  </table>
+</div>
+
+## ⭐ Features
+
+- Color a map of places based on custom labels
+- Country/State based coloring
+- Single/Multi color modes
+- Small & Fast
+- Statistics (WIP)
+
+## 📳 Installation
+
+<div style="display: flex; justify-content: center; align-items: center; flex-direction: row;">
+    <a href="https://github.com/choelzl/beans/releases/latest">
+        <img width="200" height="84" alt="APK Download" src=".github/images/apk.png">
+    </a>
+</div>
+
+## ⚙️ Permissions
+
+None
+
+## 📝 Contribute
+
+Beans is a user-driven project. We welcome any contribution, big or small.
+
+- **🖥️ Development:** Fix bugs, implement features, or research issues. Open a PR for review.
+- **🍥 Design:** Improve interfaces, including accessibility and usability.
+- **📂 Issue Reporting:** Report bugs and edge cases with relevant info.
+- **🌍 Localization:** Translate if it doesn't support your language.
+
+## ✏️ Acknowledgements
+
+Thanks to all contributors, the developers of our dependencies, and our users.
+
+## 📝 License
+
+```
+Copyright (C) 2024 Helcel
+
+Licensed under ???
+```
\ No newline at end of file
diff --git a/metadata/en-US/full_description.txt b/metadata/en-US/full_description.txt
new file mode 100644
index 0000000..2c1f1c2
--- /dev/null
+++ b/metadata/en-US/full_description.txt
@@ -0,0 +1 @@
+<p><i>Beans</i> is a scratchmap of the world for android. You can color in a single or many custom colors. You can color on a country or state basis.</p>
\ No newline at end of file
diff --git a/metadata/en-US/short_description.txt b/metadata/en-US/short_description.txt
new file mode 100644
index 0000000..7f0f9ec
--- /dev/null
+++ b/metadata/en-US/short_description.txt
@@ -0,0 +1 @@
+A virtual scratchmap of the world
\ No newline at end of file