https://github.com/nguyenvulong/devenv-macos
my personal dotfiles, optimized for MacOS 75% keyboards
https://github.com/nguyenvulong/devenv-macos
cli neovim productivity shell terminal vim wezterm zsh
Last synced: 3 days ago
JSON representation
my personal dotfiles, optimized for MacOS 75% keyboards
- Host: GitHub
- URL: https://github.com/nguyenvulong/devenv-macos
- Owner: nguyenvulong
- Created: 2025-01-14T06:09:21.000Z (9 months ago)
- Default Branch: main
- Last Pushed: 2025-08-26T03:00:19.000Z (about 1 month ago)
- Last Synced: 2025-08-26T05:19:24.440Z (about 1 month ago)
- Topics: cli, neovim, productivity, shell, terminal, vim, wezterm, zsh
- Language: Lua
- Homepage:
- Size: 36.2 MB
- Stars: 27
- Watchers: 1
- Forks: 8
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Development environment for macOS users
## Introduction
My personal dotfiles for setting up a development environment on macOS
- Terminal
- [Ghostty](http://ghostty.org), the elegant Zig-based terminal, or
- [Warp](https://app.warp.dev/referral/REQYP5), for built-in AI features, or
- [WezTerm](https://wezterm.org), for multiplexing enthusiasts
- Shell
- Zsh shell with Oh My Zsh
- Neovim (with LazyVim) and vim
- Sketchybar
| Sketchybar | WezTerm, Warp | Neovim, LazyGit | Tmux |
| ------------------------------------------------------------ | ------------------------------------------------------------ | ----------------------------------------------------------------- | ------------------------------------------------------------- |
| 
| 
| 
| 
|
| 
| 
| 
| 
|
## Prerequisites
Before installing these dotfiles, ensure you have the following installed:
### Required Tools
- Git
- Homebrew
- Zsh (default shell for macOS) or Fish
- Oh-my-zsh or Starship
### Package Dependencies
All required packages are managed through Homebrew Bundle. To install all dependencies:
```bash
# Install Homebrew if you haven't already
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# Install all dependencies from Brewfile
brew bundle install
```
To update the Brewfile with your current packages:
```bash
brew bundle dump --force
```
## Components
### Shell (Fish) - recommended
If you are new, you can skip all the hassles with Zsh below.
After `brew bundle install`, just execute `fish` and confirm the settings for the first time.
Make sure to check the configuration in `~/.config/fish/config.fish` and `~/.config/starship.toml`,
then you're good to go.
### Shell (Zsh) - if you prefer using Zsh over Fish
The Zsh configuration includes:
- Oh My Zsh as the framework
- Powerlevel10k theme
- Plugins:
- kubectl
- git
- fzf-tab
- zsh-syntax-highlighting
- zsh-autosuggestions
1. Install Oh My Zsh:
```bash
sh -c "$(curl -fsSL https://raw.githubusercontent.com/ohmyzsh/ohmyzsh/master/tools/install.sh)"
```
2. Install Powerlevel10k theme:
```bash
git clone --depth=1 https://github.com/romkatv/powerlevel10k.git ${ZSH_CUSTOM:-$HOME/.oh-my-zsh/custom}/themes/powerlevel10k
```
3. Install additional plugins:
```bash
git clone https://github.com/zsh-users/zsh-syntax-highlighting.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-syntax-highlighting
git clone https://github.com/zsh-users/zsh-autosuggestions ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/zsh-autosuggestions
git clone https://github.com/Aloxaf/fzf-tab ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/fzf-tab
```
### Neovim
The Neovim configuration uses LazyVim as the base with additional customizations:
- Package manager: lazy.nvim
- Theme: tokyonight-moon
- LSP support for multiple languages
- Various coding and UI enhancements
Follow the instruction from [LazyVim for Ambitious Developers](https://lazyvim-ambitious-devs.phillips.codes).
### Sketchybar
Customize your MacOS's menu bar.
```bash
mkdir -p ~/.config/sketchybar/plugins
cp $(brew --prefix)/share/sketchybar/examples/sketchybarrc ~/.config/sketchybar/sketchybarrc
cp -r $(brew --prefix)/share/sketchybar/examples/plugins/ ~/.config/sketchybar/plugins/
```
## Credits
The configurations builds upon these amazing projects:
- [Neovim](https://github.com/neovim/neovim) - Hyperextensible Vim-based text editor
- [LazyVim](https://github.com/LazyVim/LazyVim) - Neovim config for the lazy
- [WezTerm](https://github.com/wez/wezterm) and [Ghostty](https://ghostty.org) - GPU-accelerated cross-platform terminal emulators
- [Sketchybar](https://github.com/FelixKratz/SketchyBar) - A highly customizable macOS status bar replacement
- [Oh My Zsh](https://github.com/ohmyzsh/ohmyzsh) - A delightful community-driven framework for Zsh
- [Powerlevel10k](https://github.com/romkatv/powerlevel10k) - A fast and feature-rich Zsh theme
- [Starship](http://starship.rs) - A minimal, blazing-fast, and infinitely customizable prompt for any shell
Special thanks to these individuals for sharing the config files and writing.
- KevinSilvester: [wezterm-config](https://github.com/KevinSilvester/wezterm-config)
- Michael Bao: [tcmmichaelb139/.dotfiles](https://github.com/tcmmichaelb139/.dotfiles)
- Dusty Phillips: [LazyVim for Ambitious Developers](https://lazyvim-ambitious-devs.phillips.codes)
## License
This project is licensed under the MIT.