diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b1a1a15
--- /dev/null
+++ b/README.md
@@ -0,0 +1,28 @@
+# dotfiles
+
+A repository for most things starting with a dot
+
+---
+
+Here are some details about my setup:
+- **WM:** [KWin](https://github.com/KDE/kwin)
+- **OS:** NixOS
+- **Shell:** [fish](https://fishshell.com/)
+- **Terminal:** [kitty](https://github.com/kovidgoyal/kitty/)
+- **Editor:** [Neovim](https://github.com/neovim/neovim/)
+- **File Manager:** [Dolphin](https://github.com/KDE/dolphin)
+
+---
+
+## Main Applications
+
+- **Browser:** Microsoft Edge (sue me)
+- **Media:** VLC Media Player
+
+---
+
+# Notes
+If you have any questions or issues, open an issue under this repository. If you have any suggestions for improvement, head to the "Pull Requests" section and make your changes. If you think this repository is confusing, you are (mostly) right. Feel free to open an issue and ask why something is the way it is.
+
+## Credits
+- **[NotAShelf](https://github.com/NotAShelf)** - Introduced me to NixOS, pretty much the reason this repo exists
\ No newline at end of file