diff --git a/README.md b/README.md
new file mode 100755
index 0000000..5a6ae5c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,45 @@
+# dotfiles  
+
+Personal configuration files for Arch Linux.
+Managed with a bare git repository.
+
+---
+
+## Install
+
+Clone and set up the bare repo:
+
+```bash
+curl -fsSL https://code.sgbvmr.xyz/daesorin/dotfiles/raw/branch/main/.dotfiles-meta/install.sh | bash
+```
+
+Then restart your shell. If you are on Arch and want to install packages:
+
+```bash
+bash ~/.dotfiles-meta/bootstrap.sh
+```
+
+---
+
+## Notes
+
+- Arch Linux only. No guarantees on other distros.
+- ...
+
+---
+
+COPYRIGHT NOTICE
+copyright (c) 2026 @daesorin
+
+this program is free software: you can redistribute it and/or modify
+it under the terms of the gnu general public license as published by
+the free software foundation, either version 3 of the license, or
+(at your option) any later version.
+
+this program is distributed in the hope that it will be useful,
+but without any warranty; without even the implied warranty of
+merchantability or fitness for a particular purpose. see the
+gnu general public license for more details.
+
+you should have received a copy of the gnu general public license
+along with this program. if not, see <https://www.gnu.org/licenses/>.