diff --git a/README.md b/README.md
new file mode 100644
index 0000000..cbdbd4f
--- /dev/null
+++ b/README.md
@@ -0,0 +1,41 @@
+# 💻 My Dotfiles
+
+Este repositório contém as minhas configurações pessoais para o meu ambiente de trabalho em **Fedora Linux**. A gestão dos ficheiros (*symlinks*) é feita através do **GNU Stow**.
+
+## 🛠️ Ferramentas Base
+
+* **OS:** Fedora Linux
+* **Shell:** Zsh
+* **Terminal:** Alacritty
+* **Editor:** Emacs
+* **Compositor:** Niri
+
+---
+
+## 🚀 Como instalar num sistema novo
+
+### 1. Instalar as dependências do sistema
+Numa instalação fresca do Fedora, o primeiro passo é instalar as aplicações e o `stow`:
+
+```bash
+sudo dnf update -y
+sudo dnf install -y git stow zsh util-linux-user alacritty emacs
+```
+
+### 2. Clonar este repositório
+Como ainda não tens as chaves SSH configuradas na máquina nova, terás de clonar usando HTTPS (ou gerar a chave antes):
+
+```bash
+git clone https://<teu-dominio-forgejo>/<teu-user>/dotfiles.git ~/dotfiles
+cd ~/dotfiles
+```
+
+### 3. Aplicar as configurações
+
+Usa o Stow para criar as ligações simbólicas de cada ferramenta.
+
+    Aviso: Se o sistema já tiver criado ficheiros padrão (como o ~/.zshrc), o Stow vai dar um erro de conflito. Se isso acontecer, apaga ou faz backup do ficheiro existente (mv ~/.zshrc ~/.zshrc.bak) e volta a correr o Stow.
+
+```bash
+stow zsh alacritty emacs niri
+```