diff --git a/README.md b/README.md
index 53d8e5441..d8e52eb40 100644
--- a/README.md
+++ b/README.md
@@ -1,9 +1,32 @@
-# neodotfiles - sway
+<div align="center">
+    <picture>
+        <source srcset="./assets/logo-dark.png" media="(prefers-color-scheme: dark)">
+        <source srcset="./assets/logo-light.png" media="(prefers-color-scheme: light)">
+        <img src="assets/logo-dark.png" alt="neodotfiles" width="415">
+    </picture>
+    <h4>My custom suckless based desktop focused on absolute productivity and workflow control.</h4>
+</div>
 
-This is a rice made specifically for Arch Linux and it uses the sway wayland
-compositor.
+![screenshot](./assets/screenshot.png)
 
-### Dependencies
-``` sh
-paru -S sway swaybg swayidle swaylock foot mako fuzzel waybar wl-clipboard cliphist playerctl xdg-desktop-portal-wlr xdg-desktop-portal-gtk wdisplays grim slurp gsettings-desktop-schemas kanshi starship bat eza fish fd ripgrep yazi mpv zathura zathura-pdf-poppler zathura-cb ueberzugpp gnome-keyring polkit-gnome wf-recorder pulsemixer ani-cli-git ytfzf-git musikcube newsboat btop wdisplays
-```
+## Program list
+
+### core programs
+- sway
+- swaybg
+- swaylock
+- swayidle
+- waybar
+- kanshi
+- wob
+- fuzzel
+- fnott
+- foot
+
+### personal preference
+- btop
+- yazi
+- newsboat
+- cmus
+- imv
+- zathura
diff --git a/assets/logo-dark.png b/assets/logo-dark.png
new file mode 100644
index 000000000..fffabddd4
Binary files /dev/null and b/assets/logo-dark.png differ
diff --git a/assets/logo-dark.svg b/assets/logo-dark.svg
new file mode 100644
index 000000000..35c76773c
--- /dev/null
+++ b/assets/logo-dark.svg
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="415"
+   height="40"
+   viewBox="0 0 415 40"
+   version="1.1"
+   id="svg1"
+   inkscape:export-filename="logo.png"
+   inkscape:export-xdpi="96"
+   inkscape:export-ydpi="96"
+   inkscape:version="1.3.2 (091e20ef0f, 2023-11-25)"
+   sodipodi:docname="drawing.svg"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="px"
+     inkscape:zoom="2.728764"
+     inkscape:cx="202.65585"
+     inkscape:cy="65.96393"
+     inkscape:window-width="1918"
+     inkscape:window-height="1057"
+     inkscape:window-x="0"
+     inkscape:window-y="21"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="layer1" />
+  <defs
+     id="defs1" />
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <text
+       xml:space="preserve"
+       style="font-size:33.0501px;font-family:'sucklessfont_v1.1';-inkscape-font-specification:'sucklessfont_v1.1, Normal';fill:#ffffff;stroke:#000000;stroke-width:0.1;stroke-dasharray:none;stroke-opacity:1"
+       x="2.1633663"
+       y="31.79669"
+       id="text1"><tspan
+         sodipodi:role="line"
+         id="tspan1"
+         x="2.1633663"
+         y="31.79669"
+         style="stroke:#000000;stroke-width:0.1;stroke-dasharray:none;stroke-opacity:1">NEODOTFILES</tspan></text>
+  </g>
+</svg>
diff --git a/assets/logo-light.png b/assets/logo-light.png
new file mode 100644
index 000000000..771e332fb
Binary files /dev/null and b/assets/logo-light.png differ
diff --git a/assets/logo-light.svg b/assets/logo-light.svg
new file mode 100644
index 000000000..e8ef0771f
--- /dev/null
+++ b/assets/logo-light.svg
@@ -0,0 +1,56 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   width="415"
+   height="40"
+   viewBox="0 0 415 40"
+   version="1.1"
+   id="svg1"
+   inkscape:export-filename="logo.png"
+   inkscape:export-xdpi="96"
+   inkscape:export-ydpi="96"
+   inkscape:version="1.3.2 (091e20ef0f, 2023-11-25)"
+   sodipodi:docname="logo-light.svg"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:svg="http://www.w3.org/2000/svg">
+  <sodipodi:namedview
+     id="namedview1"
+     pagecolor="#ffffff"
+     bordercolor="#000000"
+     borderopacity="0.25"
+     inkscape:showpageshadow="2"
+     inkscape:pageopacity="0.0"
+     inkscape:pagecheckerboard="0"
+     inkscape:deskcolor="#d1d1d1"
+     inkscape:document-units="px"
+     inkscape:zoom="2.728764"
+     inkscape:cx="202.65585"
+     inkscape:cy="65.963931"
+     inkscape:window-width="1918"
+     inkscape:window-height="1057"
+     inkscape:window-x="0"
+     inkscape:window-y="21"
+     inkscape:window-maximized="1"
+     inkscape:current-layer="layer1" />
+  <defs
+     id="defs1" />
+  <g
+     inkscape:label="Layer 1"
+     inkscape:groupmode="layer"
+     id="layer1">
+    <text
+       xml:space="preserve"
+       style="font-size:33.0501px;font-family:'sucklessfont_v1.1';-inkscape-font-specification:'sucklessfont_v1.1, Normal';fill:#1a1a1a;stroke:#000000;stroke-width:0.1;stroke-dasharray:none;stroke-opacity:1"
+       x="2.1633663"
+       y="31.79669"
+       id="text1"><tspan
+         sodipodi:role="line"
+         id="tspan1"
+         x="2.1633663"
+         y="31.79669"
+         style="stroke:#000000;stroke-width:0.1;stroke-dasharray:none;stroke-opacity:1;fill:#1a1a1a">NEODOTFILES</tspan></text>
+  </g>
+</svg>
diff --git a/assets/screenshot.png b/assets/screenshot.png
new file mode 100644
index 000000000..d83633112
Binary files /dev/null and b/assets/screenshot.png differ