.dotfiles

These are my personal dotfiles.

Screenshots

Some notable tools I use are:

• Nvim (.config/nvim)
• Tmux (.config/tmux, utils/tx)
• WezTerm (.config/wezterm/wezterm.lua)

Requirements

1. Node.js (PNPM will be installed)
2. jq

Nvim Plugins

I have many many plugins and configurations going on.

Started from kickstart.nvim and heavily modified.

Plugins are installed and configured in .config/nvim/lua/casraf/plugins.

Some (but not all) of the plugins/modifications are listed here:

File	Description	Related plugins
autoformat.lua	Code auto formatting	neovim/nvim-lspconfig
barbar.lua	Tabs	romgrk/barbar.nvim
ccc.lua	Color picker and highlighter	uga-rosa/ccc.nvim
cmp.lua	Autocompletion with LSP, snippets, and LLM integration	hrsh7th/nvim-cmp, L3MON4D3/LuaSnip
colorscheme.lua	Color scheme switcher
debug.lua	Debugger-related code, most of these are not maintained/tested	mfussenegger/nvim-dap
doc_search.lua	Search documentation for different languages (MDN, React, NPM, Dart, etc.)
floating-input.lua	Floating input	liangxianzhe/floating-input.nvim
format.lua	Code formatting with Prettier	MunifTanjim/prettier.nvim
fugitive.lua	Git manager - I use LazyGit now, but this remain mostly for git blame functionality	tpope/vim-fugitive
git_open.lua	Open git repositories, branches, commits, and files in browser
go.lua	Go language support and tooling	ray-x/go.nvim
lazygit.lua	LazyGit inside nvim	kdheepak/lazygit.nvim
license.lua	SPDX license header snippets
llm.lua	LLM - Copilot, ChatGPT (requires OPENAI_API_KEY env), Codeium	zbirenbaum/copilot.lua, Exafunction/codeium.nvim, jackMort/ChatGPT.nvim
lsp.lua	LSP related configs	williamboman/mason-lspconfig.nvim, akinsho/flutter-tools.nvim
matchup.lua	Enables moving between function start/end as you would between brackets using %	andymass/vim-matchup
noice.lua	Notifications & UI improvements	folke/noice.nvim
notes.lua	Notes management with Telescope integration
nvim-test.lua	Run tests for any project type inside nvim	klen/nvim-test
oil.lua	Better than netrw. Fight me. (Lets you move between and edit directories as you would a normal file)	stevearc/oil.nvim
popup-menu.lua	Custom right-click popup menu with LSP actions
project_runner.lua	Run prepared terminal commands per filetype - e.g. package.json scripts from ts/js files (Not a plugin)
quicklist.lua	Delete/add to vim quicklist
quotes.lua	Allows you to toggle between \``, "and'` quotes around the cursor
remap.lua	General vim remaps not related to specific plugins
schemastore.lua	Auto-loads JSON $schema depending on filetype and name	b0o/schemastore.nvim
separators.lua	Insert comment separator lines
session.lua	Session management with auto save/restore
statusline.lua	Status line UI updates	nvim-lualine/lualine.nvim
surround.lua	Surround any text with anything like brackets, quotes, HTML tags or custom strings	kylechui/nvim-surround
telescope.lua	Fuzzy finder, preview and picker for files/commands/custom	nvim-telescope/telescope.nvim
text-transform.lua	Transform between PascalCase, snake_case, camelCase, CONST_CASE and more	chenasraf/text-transform.nvim
theme.lua	Theme configuration (OneDark)	navarasu/onedark.nvim
todo_comments.lua	Highlight & find TODO/HACK/FIXME/etc in comments across the project	folke/todo-comments.nvim
treesitter.lua	Syntax highlighting on steroids	nvim-treesitter/nvim-treesitter
trouble.lua	View list of diagnostics, quick fixes, TODOs, etc	folke/trouble.nvim
undotree.lua	Undo each file as you would a git branch!	mbbill/undotree
uuid_gen.lua	UUID generation snippet	L3MON4D3/LuaSnip
visual-multi.lua	Multiple cursor support for nvim	mg979/vim-visual-multi

How to install

1. Install zsh and GNU Stow

   brew install stow

2. Clone this repository into ~/.dotfiles:

   git clone git@github.com:chenasraf/dotfiles.git --depth 1 ~/.dotfiles

3. Symlink configs into your home directory using stow:

   cd ~/.dotfiles
   stow -t ~ .

   This creates symlinks for .zshrc, .editorconfig, .config/*, .local/share/zsh/plugins/local/*, etc. Files listed in .stow-local-ignore (scripts, utilities, repo metadata) are excluded.

   To restow after pulling changes:

   cd ~/.dotfiles
   stow -R -t ~ .

4. Install tools via sofmani:

   sofmani

   This handles brew packages, git plugins, language runtimes, and other dependencies.

Structure

~/.dotfiles/
├── .config/          # App configs (aerospace, alacritty, ghostty, lazygit, nvim, tmux, wezterm, ...)
├── .local/           # Zsh plugins (stowed to ~/.local/share/zsh/plugins/local/)
├── .editorconfig     # Global editorconfig (stowed to ~/.editorconfig)
├── .zshrc            # Shell config (stowed to ~/.zshrc)
├── exports.zsh       # Environment variables (sourced by .zshrc)
├── aliases.zsh       # Shell aliases (sourced by .zshrc)
├── completions/      # Zsh completions (added to fpath by .zshrc)
├── _plugins/         # Plugin loader and MOTD scripts (sourced from $DOTFILES)
├── utils/            # Build utilities
└── .stow-local-ignore

Stow symlinks everything in the repo root into ~, except items in .stow-local-ignore (scripts, utilities, and repo metadata that are sourced directly from $DOTFILES).

My Other Stuff

See some of my other projects at my website.

Or some of my packages:

NPM

• Simple Scaffold - Generate any file structure - from single components to entire app boilerplates, with a single command.
• Massarg - Flexible, powerful, and simple command/argument parser for CLI applications

Dart/Flutter

Apps

• Dungeon Paper - A Dungeon World character sheet app written with Flutter
• Mudblock - An MUD client for mobile & desktop

Packages

• Script Runner - Run all your project-related scripts in a portable, simple config.
• Unaconfig - Load your user's config files for your package easily, from multiple sources & formats. Like cosmiconfig, but for Dart!
• CTelnet - A simple Telnet client for Dart/Flutter, parse incoming and outgoing data easily and quickly.
• btool - Generic build helper tools for Flutter/Dart such as manipulating version, package name or application ID
• Wheel Spinner - A simple Flutter widget for updating a number using a pitch bender-like spinner

Neovim

• text-transform.nvim - Common text transformers for nvim - switch between camelCase, PascalCase, snake_case, and more!

Rust

• tblf - Turns any CLI output lines into tables.

Go

• GI Gen - Gitignore generator for any type of projectackages/unaconfig)