diff --git a/README.md b/README.md
new file mode 100644
index 0000000..00aacdf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,67 @@
+[github]:   https://github.com/Saltssaumure/pios-browser-theme
+[issues]:   https://github.com/Saltssaumure/pios-browser-theme/issues
+[license]:  https://github.com/Saltssaumure/pios-browser-theme/blob/main/LICENSE
+[discord]:  https://discord.gg/uy8nKQVatp
+
+[ko-fi]:                https://ko-fi.com/saltssaumure "Buy me a coffee!"
+[dl-chrome-theme]:      https://github.com/Saltssaumure/pios-browser-theme/releases/latest/download/piOS-chrome-theme.zip "Get latest release for Chrome"
+[dl-vivaldi-theme]:     https://github.com/Saltssaumure/pios-browser-theme/releases/latest/download/piOS-vivaldi-theme.zip "Get latest release for Vivaldi"
+[dl-vivaldi-custom]:    https://github.com/Saltssaumure/pios-browser-theme/releases/latest/download/piOS-vivaldi-custom.css "Get latest release for Vivaldi"
+
+[img-donate]:           https://img.shields.io/badge/Donate-ko--fi-orange?style=flat-square&logo=kofi&logoColor=orange
+[img-chrome-theme]:     https://img.shields.io/github/downloads/Saltssaumure/pios-browser-theme/piOS-chrome-theme.zip?color=purple&label=Downloads&style=flat-square
+[img-vivaldi-theme]:    https://img.shields.io/github/downloads/Saltssaumure/pios-browser-theme/piOS-vivaldi-theme.zip?color=purple&label=Downloads&style=flat-square
+[img-vivaldi-custom]:   https://img.shields.io/github/downloads/Saltssaumure/pios-browser-theme/piOS-vivaldi-custom.css?color=purple&label=Downloads&style=flat-square
+[img-repo-size]:        https://img.shields.io/github/repo-size/Saltssaumure/pios-browser-theme?label=Repository&style=flat-square
+
+# piOS Browser Themes
+[![Buy me a coffee on ko-fi][img-donate]][ko-fi]
+[![Chrome GitHub downloads][img-chrome-theme]][dl-chrome-theme]
+[![Vivaldi GitHub downloads][img-vivaldi-theme]][dl-vivaldi-theme]
+[![Vivaldi Custom CSS GitHub downloads][img-vivaldi-custom]][dl-vivaldi-custom]
+[![Total repository size][img-repo-size]][github]
+
+**_SUPERHOT piOS inspired themes for your browser._**
+
+Currently supported browsers:
+
+- [Vivaldi](https://vivaldi.com/download/)
+- [Google Chrome](https://www.google.com/chrome/)
+
+Looking for the piOS experience in Discord? Check out the theme [here](https://github.com/Saltssaumure/pios-discord-theme).
+
+
+## Installation
+### Chrome
+<details><summary>Click to expand</summary>
+
+1. Download `piOS-chrome-theme.zip` from the [latest release][dl-chrome-theme].
+2. Unzip the file.
+3. Open a new tab and go to `chrome://extensions`.
+4. At the top right, slide the switch that says `Developer mode` to turn on Developer Mode.
+5. At the top left, click the `Load unpacked` button. Find the newly unzipped folder that you downloaded and select it.
+</details>
+
+### Vivaldi
+<details><summary>Click to expand</summary>
+
+1. Download `piOS-vivaldi-theme.zip` from the [latest release][dl-vivaldi-theme].
+2. Go to `Settings > Themes` in Vivaldi.
+3. Click the `Open Theme...` button and select the downloaded file.
+
+#### Additional CSS
+1. Download `piOS-vivaldi-custom.css` from the [latest release][dl-vivaldi-theme] into its own folder.
+2. Enter `vivaldi://experiments` into the address bar in Vivaldi.
+3. Enable `Allow CSS modifications`.
+4. Go to `Settings > Appearance > Custom UI Modifications`.
+5. Select the folder containing the file you downloaded.
+</details>
+
+
+## License
+This project is licensed under the [MIT license][license].
+
+
+## Questions or suggestions?
+- Post [an issue][issues] on GitHub.
+- Post in `#theme-support` on [my support server][discord].
\ No newline at end of file
diff --git a/vivaldi.json b/vivaldi.json
new file mode 100644
index 0000000..087875a
--- /dev/null
+++ b/vivaldi.json
@@ -0,0 +1,4 @@
+{
+	"version": 0.2,
+	"download": "https://github.com/Saltssaumure/pios-browser-theme/releases/latest/download/piOS-vivaldi-theme.zip"
+}