Finally pushed my gentoo dotfiles :3

README.md

@@ -0,0 +1,58 @@
+# dotfiles
+
+My `~/.config` files.
+
+This repo holds the **portable, plain-text** configuration I want to keep in
+version control. Application state, caches, machine-specific data and — most
+importantly — credentials are excluded via `.gitignore`.
+
+## What's in here
+
+Committed configs (roughly):
+
+- `alacritty/` — terminal emulator
+- `btop/`, `htop/` — system monitors
+- `kitty/` — terminal emulator
+- `sway/` — window manager
+- `waybar/` — status bar
+- `rofi/` — launcher
+- `polybar/` — status bar
+- `flameshot/` — screenshot tool
+- `starship.toml` — shell prompt
+- `mimeapps.list` — default applications
+- `pavucontrol.ini`, `QtProject.conf` — misc GUI settings
+
+## What's deliberately NOT in here
+
+Ignored and never committed:
+
+- **Credentials / tokens** — GitHub OAuth tokens, Discord tokens, Epic Games
+  tokens, service API keys, TLS private keys, license keys.
+- **Browser / Electron app state** — cookies, localStorage, sessionStorage,
+  `Trust Tokens`, `Crashpad`, GPU caches.
+- **Machine-specific / generated state** — `dconf/`, `gtk-*`, `pulse/`,
+  `go/`, `obs-studio/`, `vlc/`, logs, and `fastfetch/logos/`.
+
+See `.gitignore` for the full list.
+
+## Usage
+
+To apply these dotfiles on a fresh machine:
+
+```bash
+git clone https://git.dvorakmortonxd.dev/dvorakmortonxd/dotfiles.git ~/.config
+```
+
+> Back up any existing files first — cloning into a populated `~/.config`
+> will refuse or conflict.
+
+## Warning
+
+If you fork or reuse this repo, note that `.gitignore` only prevents *new*
+sensitive files from being added. It does not retroactively remove anything
+already committed. Before adding new files, run:
+
+```bash
+git status
+git diff --cached | grep -nE 'gho_|ghp_|mfa\.|client_secret|BEGIN .*PRIVATE KEY|access_token|"password"'
+```