From 52a0858378fbd8a8ea454f5806f42acd2726ac6b Mon Sep 17 00:00:00 2001
From: Jose Jimenez <jjsalinas@pm.me>
Date: Sun, 25 Jan 2026 10:48:29 +0100
Subject: [PATCH] README updated

---
 README.md | 38 ++++++++++++++++++++++++++++++++++++++
 1 file changed, 38 insertions(+)

diff --git a/README.md b/README.md
index e69de29..791f9a6 100644
--- a/README.md
+++ b/README.md
@@ -0,0 +1,38 @@
+# dotfiles
+
+Personal dotfiles for a clean, reproducible Zsh environment.
+
+This setup is focused on:
+- Oh My Zsh
+- Syntax highlighting (green/red command validation)
+- fzf-powered history search
+- Ergonomic word movement & deletion keybindings
+- Minimal, modular configuration
+
+## Requirements
+
+- Zsh
+- Oh My Zsh already installed
+- Git
+- Ubuntu or Fedora based distro
+
+## Install
+
+Clone the repository and run the installer:
+
+```bash
+git clone https://github.com/jjsalinas/dotfiles.git
+cd dotfiles
+./install.sh
+```
+
+### Options
+
+Run `./install.sh --help` to see all available options and details.
+
+```bash
+./install.sh --help           # Show all options
+./install.sh --dry-run        # Show actions without making changes
+./install.sh --theme <name>   # Set Oh My Zsh theme (default: clean)
+./install.sh --add-nvm        # Enable Node Version Manager config
+```