diff --git a/.zshrc.example b/.zshrc.example
new file mode 100644
index 0000000..ee20167
--- /dev/null
+++ b/.zshrc.example
@@ -0,0 +1,88 @@
+# ----------------------------------------------------
+# VANITY ZSH CONFIG – macOS + Oh My Zsh + Oh My Posh
+# ----------------------------------------------------
+
+# Homebrew PATH (Apple Silicon)
+/opt/homebrew/bin:/opt/homebrew/sbin:$PATH
+
+# Oh My Zsh installation directory
+export ZSH="$HOME/.oh-my-zsh"
+
+ZSH_THEME="robbyrussell"
+
+plugins=(
+  git
+  macos
+  zsh-autosuggestions
+  zsh-syntax-highlighting
+)
+
+source $ZSH/oh-my-zsh.sh
+
+# Idioma
+export LANG="en_US.UTF-8"
+export LC_ALL="en_US.UTF-8"
+
+# Editor
+export EDITOR="nvim"
+
+# Prompt con Oh My Posh (Catppuccin)
+eval "$(oh-my-posh init zsh --config ~/catppuccin.omp.json)"
+
+# Compinit
+autoload -Uz compinit
+compinit
+
+# Opciones del shell
+setopt auto_cd
+setopt interactive_comments
+setopt correct
+setopt extended_history
+
+# Historial
+export HISTFILE=~/.zsh_history
+export HISTSIZE=50000
+export SAVEHIST=50000
+
+# Colores ls
+export CLICOLOR=1
+export LSCOLORS=ExFxCxDxBxegedabagacad
+
+# Paths adicionales
+fpath+=/opt/homebrew/share/zsh/site-functions
+
+export PATH="$HOME/.local/bin:$PATH"
+export PATH="$HOME/Library/Python/3.11/bin:$PATH"
+export PATH="$HOME/.npm-global/bin:$PATH"
+
+# -------------------------------------------
+# ALIASES
+# -------------------------------------------
+
+alias cls="clear"
+alias ll="ls -lah"
+alias brewfix="brew update && brew upgrade && brew cleanup"
+
+# Descarga de YouTube
+alias ytv='yt-dlp -o "~/Downloads/youtube/video/%(title)s.%(ext)s"'
+alias ytm='yt-dlp -x --audio-format mp3 -o "~/Downloads/youtube/audio/%(title)s.%(ext)s"'
+
+# -------------------------------------------
+# HELP: listado de comandos Vanity
+# -------------------------------------------
+alias help='echo "
+VANITY TERMINAL COMMANDS
+
+General:
+  cls         — limpiar pantalla
+  ll          — listar archivos con detalles
+  brewfix     — actualizar y limpiar Homebrew
+
+YouTube Downloads:
+  ytv <URL>   — descargar VIDEO en ~/Downloads/youtube/video
+  ytm <URL>   — descargar AUDIO (MP3) en ~/Downloads/youtube/audio
+
+Shell & Prompt:
+  oh-my-posh  — gestor de prompt
+  oh-my-zsh   — framework de Zsh
+"'