first commit

README.md

@@ -0,0 +1,54 @@
+# dotfiles
+
+Curated public-friendly dotfiles extracted from `~/.config`.
+
+## Layout
+
+- `config/`: files that belong under `~/.config`
+- `home/`: files that belong under `$HOME`
+- `restore.sh`: creates backups, then installs symlinks
+- `install-pkg.sh`: installs official and AUR packages from list files
+- `packages-official.txt`: explicitly installed repository packages
+- `packages-aur.txt`: explicitly installed AUR packages
+
+## Restore
+
+```bash
+./restore.sh
+./install-pkg.sh
+```
+
+By default the script:
+
+- creates timestamped backups for existing non-symlink targets
+- creates symlinks from this repository into `~/.config`
+- skips targets that already point to this repo
+
+## Package Install
+
+```bash
+./install-pkg.sh
+./install-pkg.sh --official-only
+./install-pkg.sh --aur-only
+```
+
+The installer uses:
+
+- `pacman` for `packages-official.txt`
+- `yay` or `paru` for `packages-aur.txt`
+
+## Excluded on purpose
+
+These were intentionally not pulled in because they usually contain secrets, device-specific state, caches, databases, logs, or personal browsing/session data:
+
+- `gh/`
+- `mozilla/`
+- `pulse/`
+- `go/telemetry/`
+- `obs-studio/`
+- `Throne/`
+- `dconf/user`
+- `session/`
+- `fish/fish_variables`
+
+Review everything once more before publishing.