diff --git a/README.md b/README.md
new file mode 100644
index 0000000..1b43cfa
--- /dev/null
+++ b/README.md
@@ -0,0 +1,24 @@
+# bashrc theme
+
+Custom bash prompt with 256-color theme.
+
+```
+[09:30 01.12.2026]
+[user@host /path:$]
+```
+
+- **prompt** — color 47 (cyan/green)
+- **username** — color 69 (blue) for regular user, 199 (pink) for root
+- user input/output — default terminal color
+
+## Install
+
+```bash
+# current user
+./install.sh user
+
+# system-wide (/etc/skel/)
+sudo ./install.sh system
+```
+
+Install also changes default shell to bash via `chsh` (interactive prompt).