diff --git a/.github/assets/screenshot.png b/.github/assets/screenshot.png
new file mode 100644
index 0000000..8029d54
Binary files /dev/null and b/.github/assets/screenshot.png differ
diff --git a/README.md b/README.md
index 3e83a22..9fef07a 100644
--- a/README.md
+++ b/README.md
@@ -1 +1,71 @@
-# Config test
\ No newline at end of file
+<h1 align="center">
+   <img src="https://camo.githubusercontent.com/8c73ac68e6db84a5c58eef328946ba571a92829b3baaa155b7ca5b3521388cc9/68747470733a2f2f692e696d6775722e636f6d2f367146436c41312e706e67" width="100px" /> 
+   <br>
+      Frost-Phoenix's Flakes 
+   <br>
+      <img src="https://raw.githubusercontent.com/catppuccin/catppuccin/main/assets/palette/macchiato.png" width="600px" /> <br>
+   <div align="center">
+
+   <div align="center">
+      <p></p>
+      <div align="center">
+         <a href="https://github.com/Frost-Phoenix/nixos-config/stargazers">
+            <img src="https://img.shields.io/github/stars/Frost-Phoenix/nixos-config?color=F5BDE6&labelColor=303446&style=for-the-badge&logo=starship&logoColor=F5BDE6">
+         </a>
+         <a href="https://github.com/Frost-Phoenix/nixos-config/">
+            <img src="https://img.shields.io/github/repo-size/Frost-Phoenix/nixos-config?color=C6A0F6&labelColor=303446&style=for-the-badge&logo=github&logoColor=C6A0F6">
+         </a>
+         <a = href="https://nixos.org">
+            <img src="https://img.shields.io/badge/NixOS-unstable-blue.svg?style=for-the-badge&labelColor=303446&logo=NixOS&logoColor=white&color=91D7E3">
+         </a>
+         <a href="https://github.com/Frost-Phoenix/nixos-config/blob/main/LICENSE">
+            <img src="https://img.shields.io/static/v1.svg?style=for-the-badge&label=License&message=MIT&colorA=313244&colorB=F5A97F&logo=unlicense&logoColor=F5A97F&"/>
+         </a>
+      </div>
+      <br>
+   </div>
+</h1>
+
+<br>
+</div>
+
+<p align="center">
+   <img src="./.github/assets/screenshot.png" width="700px" /> <br>
+</p>
+<p align="center">
+   Screeenshot last updated <b>2023-12-22</b>
+</p>
+
+# 📦 Overview
+
+-   [flake.nix](flake.nix) base of the configuration
+-   [hosts](hosts) 🌳 per-host configurations that contain machine specific configurations
+    - [nixos](hosts/nixos/) 🖥️ Default host
+-   [modules](modules) 🍱 modularized NixOS configurations
+    -   [core](modules/core/) ⚙️ Core NixOS configuration
+    -   [homes](modules/home/) 🏠 my [Home-Manager](https://github.com/nix-community/home-manager) config
+-   [pkgs](flake/pkgs) 💿 packages exported by my flake
+-   [wallpapers](wallpapers/) 🌄 wallpapers collection
+
+
+# 👥 Credits
+
+Other dotfiles that inspired me:
+
+- Nix Flakes
+  - [nomadics9/NixOS-Flake](https://github.com/nomadics9/NixOS-Flake2): This is where I start my hyprland journey.
+  - [samiulbasirfahim/Flakes](https://github.com/samiulbasirfahim/Flakes): General flake / files structure
+  - [justinlime/dotfiles](https://github.com/justinlime/dotfiles): Mainly waybar
+  - [fufexan/dotfiles](https://github.com/fufexan/dotfiles): gtk theme, xdg, git, media, anyrun, etc.
+
+- README
+  - [ryan4yin/nix-config](https://github.com/ryan4yin/nix-config)
+  - [NotAShelf/nyx](https://github.com/NotAShelf/nyx)
+  - [sioodmy/dotfiles](https://github.com/sioodmy/dotfiles)
+  - [Ruixi-rebirth/flakes](https://github.com/Ruixi-rebirth/flakes)
+
+---
+
+<div align="right">
+  <a href="#readme">Back to the Top</a>
+</div>
\ No newline at end of file