# 💻 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
```

### Nota:
Para atualizar as configurações no futuro, basta alterar os ficheiros normalmente (ou diretamente dentro da pasta ~/dotfiles), fazer um git commit e git push.

Depois de guardares o ficheiro `README.md` na tua pasta `~/dotfiles`, executa:

```bash
cd ~/dotfiles
git add README.md
git commit -m "docs: adicionar README com instruções de instalação"
git push
```