diff --git a/README.md b/README.md
new file mode 100644
index 0000000..72751f1
--- /dev/null
+++ b/README.md
@@ -0,0 +1,42 @@
+With nysh I am aiming to replace the current bar in my [TWM].
+
+Nysh is written in QML using [Quickshell].
+
+## Todo
+
+- [ ] Control Panel
+- [ ] Notification Center & Popups
+- [ ] Wifi, Ethernet & VPN indicator
+- [ ] Battery indicator
+- [ ] Brightness indicator
+- [ ] DnD indicator
+- [ ] Mpris media manager
+- [ ] Microphone, Screen Sharing & Audio Indicator
+
+## Work in Progress Showcase
+
+![Main Bar](./assets/2024-08-28-main-bar.png)
+
+![Audio Manager](./assets/2024-08-28-audio-manager.png)
+
+## Launching the shell
+
+This project is not necessarily meant to be used by others, but if you'd like to do so you can run:
+
+```console
+nix run github:nydragon/nysh
+```
+
+or directly via quickshell from the repository root:
+
+```console
+quickshell -p src/shell.qml
+```
+
+## Thanks to:
+
+- [outfoxxed], the creator of Quickshell
+
+[Quickshell]: https://quickshell.outfoxxed.me/
+[TWM]: https://en.wikipedia.org/wiki/Tiling_window_manager
+[outfoxxed]: https://git.outfoxxed.me/outfoxxed/
diff --git a/assets/2024-08-28-audio-manager.png b/assets/2024-08-28-audio-manager.png
new file mode 100644
index 0000000..78b2bab
Binary files /dev/null and b/assets/2024-08-28-audio-manager.png differ
diff --git a/assets/2024-08-28-main-bar.png b/assets/2024-08-28-main-bar.png
new file mode 100644
index 0000000..a3d4a89
Binary files /dev/null and b/assets/2024-08-28-main-bar.png differ