diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c1c94c2
--- /dev/null
+++ b/README.md
@@ -0,0 +1,68 @@
+<p align="center">
+  <img src="assets/screenshot.png" alt="screenshot">
+</p>
+
+<h1 align="center">NVIM</h1>
+
+<p align="center">
+
+  <a href="https://github.com/S4NKALP/nvim/blob/main/LICENSE">
+<img alt="License" src="https://img.shields.io/github/license/your-username/repos?style=flat&color=eee&label="> </a>
+
+<a href="https://github.com/S4NKALP/nvim/graphs/contributors">
+<img alt="People" src="https://img.shields.io/github/contributors/your-username/repos?style=flat&color=ffaaf2&label=People"> </a>
+
+<a href="https://github.com/S4NKALP/nvim/stargazers">
+<img alt="Stars" src="https://img.shields.io/github/stars/your-username/repos?style=flat&color=98c379&label=Stars"></a>
+
+<a href="https://github.com/S4NKALP/nvim/network/members">
+<img alt="Forks" src="https://img.shields.io/github/forks/your-username/repos?style=flat&color=66a8e0&label=Forks"> </a>
+
+<a href="https://github.com/S4NKALP/nvim/watchers">
+<img alt="Watches" src="https://img.shields.io/github/watchers/your-username/repos?style=flat&color=f5d08b&label=Watches"> </a>
+
+<a href="https://github.com/S4NKALP/nvim/pulse">
+<img alt="Last Updated" src="https://img.shields.io/github/last-commit/your-username/repos?style=flat&color=e06c75&label="> </a>
+</p>
+
+<p align="center">
+  <strong>Personalized Dev Env ❤️👨‍💻</strong>
+  <br>
+    Handcrafted Neovim setup for the ultimate CLI dev experience.
+  <br>
+  <br>
+  <a href="https://github.com/S4NKALP/nvim/wiki">Documentation</a>
+  ·
+  <a href="https://github.com/S4NKALP/nvim/issues">Report a Bug</a>
+  ·
+  <a href="https://github.com/S4NKALP/nvim/issues">Request a Feature</a>
+</p>
+
+<br>
+
+## Overview
+
+nvim has a easy to understand config structure that promotes personalization, so go ahead, bring your keybindings, functions and plugins over, and truly make nvim: Your Personalized Development Environment!
+
+## Installation
+
+To install `nvim` clone the repo and setup the symlink
+
+```bash
+git clone https://github.com/S4NKALP/nvim
+```
+
+On Linux and Mac
+
+```bash
+ln -sfnv $PWD/nvim $HOME/.config/nvim
+```
+
+### 🧰 Tools Used
+
+- [dots](https://github.com/S4NKALP/hyprland) — Dev Environment
+- [nvim](https://github.com/S4NKALP/nvim) — Personalized Editor
+
+<div align="center">
+    <strong>⭐ hit the star button if you found this useful ⭐</strong><br>
+</div>
diff --git a/assets/screenshot.png b/assets/screenshot.png
new file mode 100644
index 0000000..aeffa95
Binary files /dev/null and b/assets/screenshot.png differ