Skip to content
chenasrafPublic

About

My dotfiles! Use at your own risk. Some pre-requisites (see readme)

Resources

Stars

2 stars

Watchers

0 watching

Forks

Latest commit

 

History

1,518 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

.dotfiles

These are my personal dotfiles.

image
Screenshots image image image

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 Toggle format-on-save with :AutoFormat
barbar.lua Tabs romgrk/barbar.nvim
ccc.lua Color picker and highlighter uga-rosa/ccc.nvim
cmp.lua Autocompletion with LSP and snippets 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
debug_log.lua Insert a per-language debug print for the variable under the cursor, and clean the inserted lines up
doc_search.lua Search documentation for different languages (MDN, React, NPM, Dart, etc.)
find-replace.lua Find/replace across the current file or the whole project, driven by a form chenasraf/input-form.nvim
floating-input.lua Floating input liangxianzhe/floating-input.nvim
format.lua Formatters per filetype, run on save stevearc/conform.nvim
fugitive.lua Git manager — kept mostly for git blame, since LazyGit covers the rest tpope/vim-fugitive
fzf-lua.lua Fuzzy finder, preview and picker for files/grep/diagnostics/custom lists, plus an icon & emoji picker ibhagwan/fzf-lua, ziontee113/icon-picker.nvim
git_open.lua Open git repositories, branches, commits, and files in browser
go.lua Go language support and tooling ray-x/go.nvim
input-form.lua Multi-input forms with validation, used by other modules to collect input chenasraf/input-form.nvim
lazygit.lua Opens LazyGit in a tmux popup
license.lua SPDX license header snippets
lsp.lua LSP related configs williamboman/mason-lspconfig.nvim, akinsho/flutter-tools.nvim
mason.lua The list of LSP servers, formatters, linters and debug adapters Mason installs on startup WhoIsSethDaniel/mason-tool-installer.nvim, williamboman/mason.nvim
matchup.lua Enables moving between function start/end as you would between brackets using % andymass/vim-matchup
md_anchor.lua Follow Markdown heading anchors in links with gx
noice.lua Notifications & UI improvements folke/noice.nvim
notes.lua Notes management — find and create notes in the notes vault
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 <F5> picker for package.json scripts, pyproject.toml tasks, Makefile targets, Cargo and Go commands found above the current file, plus per-filetype commands (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
scrollbar.lua Scrollbar with diagnostic, search and git hunk markers petertriho/nvim-scrollbar
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
text-transform.lua Transform between PascalCase, snake_case, camelCase, CONST_CASE and more chenasraf/text-transform.nvim
theme.lua Theme configuration (Catppuccin Mocha, transparent background) catppuccin/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
vim-tmux-navigator.lua Move between nvim splits and tmux panes with the same <C-h/j/k/l> christoomey/vim-tmux-navigator
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)

About

My dotfiles! Use at your own risk. Some pre-requisites (see readme)

Resources

Stars

2 stars

Watchers

0 watching

Forks

Used by

Contributors

Languages