diff --git a/README.md b/README.md
index 2e7cc58..e7bb80e 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,42 @@
-# dotfiles
+<h1 align="center">Halia DE environment</h1>
 A set of dotfiles and configuration utilities for Linux distros
 
+## Table of Contents
+
+- [About](#about)
+- [Gallery](#gallery)
+- [Installation](#install)
+- [Keybinds](#keybinds)
+- [FAQ](#faq)
+
+<a id="about"></a>
+## About
+
+Hi, welcome to my dotfiles repository.
+
+Here are the development environment configuration I use on a daily basis, going from server configurations for remotes and window manager settings.
+
+Curiousity brought you here, maybe you want to [install](#install) this configuration to try it by yourself, otherwise feel free to look around :)
+
+Still have a doubt about what you want from here ? You might want to take a look at the [gallery](#gallery).
+
+|         Application         |         Package(s)         |
+|-----------------------------|----------------------------|
+| Window Manager              | i3-gaps                    |
+| Browser                     | Firefox                    |
+| Application launcher        | Rofi                       |
+| Bar                         | Polybar                    |
+| Color scheme                | Ayu                        |
+| Terminals                   | Alacritty & xterm          |
+| Shell                       | Zsh                        |
+
+<a id="faq"></a>
+# Frequently asked questions
+
+#### What is the point of using multiple terminal emulators ?
+Some machines, lacking discrete or recent GPU, will not be able to start Alacritty. This is the main reason to have xterm as a backup terminal.
+
+# Misc
 ### Slack theming
 Updated as of [this commit](https://github.com/TanguyHerbron/dotfiles/commit/9adabddf70494ba534bcc5dd94260a92e1c996c3)