diff --git a/readme.md b/readme.md
index 15ab631..04ed686 100644
--- a/readme.md
+++ b/readme.md
@@ -1,4 +1,89 @@
-# My personal dot-files
-This is my linux(mainly arch) configuration files.
+<div align="center">
 
-This is not a complete .config folder, but one to copy from. This is a hyprland centric rice.
\ No newline at end of file
+```
+ ˚ ༘ ⋆｡˚  samantha's dotfiles  ˚｡⋆ ༘ ˚
+```
+
+*a cozy hyprland rice for arch linux* 🌸
+
+</div>
+
+---
+
+<div align="center">
+
+```
+  🌙 night                           ☀️ day
+  wallpaper shifts at 7am & 8pm — automatically ✨
+```
+
+</div>
+
+---
+
+## 🌷 what's inside
+
+| folder | what it does |
+|--------|-------------|
+| `hypr/` | hyprland config — the heart of the rice |
+| `waybar/` | status bar with day/night wallpaper cycling |
+| `kitty/` | terminal emulator config |
+| `nvim/` | neovim setup |
+| `wofi/` | app launcher styling |
+| `mpd/` | music player daemon |
+| `fastfetch/` | pretty system info display |
+
+---
+
+## 🍵 setup
+
+> this isn't a full `.config` drop-in — it's a **pick-and-mix**. copy what you like!
+
+```bash
+# clone it
+git clone https://git.samantha42.xyz/samantha/dotfiles.git
+
+# copy whatever you want into ~/.config/
+cp -r dotfiles/hypr ~/.config/
+cp -r dotfiles/waybar ~/.config/
+# ... and so on
+```
+
+---
+
+## ✨ highlights
+
+- **hyprland** centric — smooth, wayland-native tiling wm
+- **day/night wallpaper cycle** — switches automatically at 7am and 8pm 🌅
+- **autostart** — apps launch silently to their assigned workspaces
+- mostly **lua, css & shell** under the hood
+
+---
+
+## ⚠️ heads up
+
+> **monitors are hardcoded!**
+> the wallpaper cycle script and `hyprland.conf` reference my specific monitor names/configs.
+> before using, check and update these to match your own setup:
+> ```bash
+> # find hardcoded monitor names in:
+> hypr/hyprland.conf
+> hypr/wallpaper-cycle.sh   # or whatever the script is called
+> ```
+> run `hyprctl monitors` to see your monitor identifiers.
+
+---
+
+## 💌 notes
+
+- built for **arch linux** (but should work on any distro running hyprland)
+- configs are kept minimal and readable — feel free to adapt freely
+- if something breaks, it's probably a font or a missing dependency 🙃
+
+---
+
+<div align="center">
+
+*made with love and too many late nights* 🫶
+
+</div>
\ No newline at end of file