diff --git a/README.md b/README.md
new file mode 100644
index 0000000..bbf6a9e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,23 @@
+# Make your NeoVim looks like VSCode 
+This is a public repo, that contains some settings and plugins that allows you to use NeoVim like Visual Studio Code. 
+#### You can clone the repository into your nvim folder, or enter the repository files, and copy only the settings you need
+#### After that, you just have to open your ```init.vim```, probably located at ```/home/your_user/.config/nvim```, press ```ESC```, and then type ```:PlugInstall``` to auto-detect the plugins and install them
+#### To display the icons correctly, make sure your terminal is using a Nerd Font, here is the link to check the fonts: https://github.com/ryanoasis/nerd-fonts#patched-fonts 
+<h1 align='center'>
+  <img src='https://res.cloudinary.com/practicaldev/image/fetch/s--Od4gK0Wl--/c_imagga_scale,f_auto,fl_progressive,h_900,q_auto,w_1600/https://dev-to-uploads.s3.amazonaws.com/i/xl7ejjiohf36b31frr8a.png' alt='Neovim logo' />
+</h1>
+<br />
+<h3> Why should you use NeoVim instead of VSCode? 🤔 </h3>
+<ul>
+  <li>If you haven't a lot of RAM and CPU available, NeoVim is a good alternative</li>
+  <li>NeoVim is an improved version of the traditional and famous editor Vim</li>
+  <li>NeoVim is an open-source text-editor, and also is a highly extensible editor</li>
+  <li>You can customize it by using plugins, or VimScript</li>
+  <li>NeoVim is very light, does not lock, its startup is fast and consumes very little resources on your machine</li>
+</ul>
+<br />
+<h3>By using this settings, how will my NeoVim looks like?</h3>
+<br />
+<h1 align='center'>
+  <img src='https://i.ibb.co/p20BnHd/Screenshot-20201228-152256.png' alt='NeoVim VSCode'/>
+</h1>