Skip to content
nittsujPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

dotfiles

Personal configuration for Arch Linux, managed with GNU Stow. Each application lives in its own top-level directory, and the directory tree inside it mirrors the path under $HOME.

Layout

.
├── claude/      .claude/ (settings.json, skills/pr-description)
├── fastfetch/   .config/fastfetch/config.jsonc
├── git/         .gitconfig
├── gnome/       gnome-settings.ini (dconf export, not stowed)
├── kitty/       .config/kitty/ (kitty.conf, theme, light-theme.auto.conf)
├── nvim/        .config/nvim/ (init.lua, lua/config, lua/plugins, lazy-lock.json)
├── packages/    pkglist.txt, aur-pkglist.txt, vscode-extensions.txt (not stowed)
├── scripts/     install.sh (not stowed)
├── ssh/         .ssh/config
├── vscode/      .config/Code/User/settings.json
├── xdg/         .config/ (mimeapps.list, user-dirs.dirs)
└── zsh/         .zshrc, .p10k.zsh, .config/zsh/aliases.zsh

What's in here

Same order as the layout above.

claude

Claude Code's settings.json and the pr-description skill. Credentials, history and session data stay out.

fastfetch

config.jsonc shows the Arch logo with the hasecilu template.

git

The global .gitconfig: name, email, Neovim as editor, Git LFS, main as default branch, rebase on pull, auto upstream on push, prune on fetch, rerere, and aliases (st, co, sw, lg, amend, undo).

gnome

Not a Stow package. gnome-settings.ini is a dconf dump of /org/gnome/ (keybindings, theme, fonts, extensions, dock favorites), and install.sh loads it back with dconf load.

kitty

Fira Code at 14pt, semi-transparent windows, a background image, and the Atelier Cave Dark theme. light-theme.auto.conf switches the palette based on the system color scheme.

nvim

init.lua loads lua/config/ (options, keymaps, lazy.nvim bootstrap) and every spec in lua/plugins/. Leader is space. Tabs are 4 spaces, relative line numbers on.

  • Plugins: catppuccin, telescope, nvim-treesitter (main branch, needs tree-sitter-cli), mason + nvim-lspconfig (lua_ls, pyright, vtsls, tinymist), blink.cmp, conform.nvim (format on save, falls back to the LSP), gitsigns.
  • Keys: <leader>f* telescope, gd / <leader>rn / <leader>ca LSP, <leader>cf format, ]h / [h / <leader>h* git hunks.

packages

Software a fresh install should end up with: pkglist.txt for pacman, aur-pkglist.txt for the AUR, vscode-extensions.txt for VS Code.

scripts

install.sh sets up a new machine. See Install.

ssh

Only ~/.ssh/config, the host shortcuts. Keys are never tracked; generate or copy them separately on each machine.

vscode

Only User/settings.json. Extensions are listed in packages/vscode-extensions.txt.

xdg

mimeapps.list (default apps) and user-dirs.dirs (adds ~/Projects). Some apps rewrite these files and replace the link with a plain file; if ls -l shows no arrow, copy the change into the repo and re-run stow xdg.

zsh

Oh My Zsh with Powerlevel10k, zsh-autosuggestions and zsh-syntax-highlighting. The theme and plugins are not tracked; install.sh clones them into ~/.oh-my-zsh/custom.

  • Aliases: ~/.config/zsh/aliases.zsh.
  • Tools: zoxide, fzf, eza and bat hook in only when installed.
  • Local: per-machine settings and secrets go in ~/.zshrc.local, sourced last and never tracked.

Install

git clone https://github.com/nittsuj/dotfiles ~/dotfiles
cd ~/dotfiles
./scripts/install.sh

The script installs the pacman package list, bootstraps yay from the AUR if it is missing, installs the AUR package list, installs the VS Code extensions, stows the config directories, enables Git LFS, clones Oh My Zsh, Powerlevel10k and the two zsh plugins, runs nvim --headless "+Lazy! sync" to install the Neovim plugins, restores the GNOME settings, and sets zsh as the login shell. It stops on the first failure.

Before stowing, any real file that would block a link (say, a default ~/.zshrc) is moved to ~/.dotfiles-backup/<timestamp>/. Run ./scripts/install.sh --dry-run to print every command without running it.

If you only want the symlinks:

mkdir -p ~/.ssh ~/.claude/skills ~/.config/Code/User && chmod 700 ~/.ssh
stow zsh kitty nvim fastfetch git ssh vscode claude xdg

Run that from the repo root. It creates ~/.zshrc, ~/.p10k.zsh, ~/.gitconfig, ~/.ssh/config, and the .config entries, and does not touch anything else. ~/.ssh is created first so Stow links only the config file instead of the whole directory.

Notes

  • packages/vscode-extensions.txt is installed by install.sh with code --install-extension. Append an extension ID to that file to add another.
  • The kitty background image (desktop-lain.jpg) lives next to kitty.conf and is tracked. Swap in your own with the same name, or remove the background_image lines from kitty.conf.
  • .p10k.zsh was generated by p10k configure. Run it again to change the prompt.
  • After changing GNOME settings, refresh the export with dconf dump /org/gnome/ > gnome/gnome-settings.ini and review the diff before committing. The restore step only runs inside a graphical session; otherwise install.sh prints the command to run later.
  • Stow will refuse to link over existing files. On a fresh machine, move or delete the default ~/.gitconfig, ~/.zshrc or ~/.ssh/config first.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages