https://github.com/nash403/dotfiles
My personal dotfiles
https://github.com/nash403/dotfiles
dotfiles personal personal-dotfiles setup setup-development-environment setup-macos
Last synced: 9 months ago
JSON representation
My personal dotfiles
- Host: GitHub
- URL: https://github.com/nash403/dotfiles
- Owner: nash403
- License: mit
- Created: 2020-01-18T13:43:02.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2025-03-24T20:18:31.000Z (12 months ago)
- Last Synced: 2025-06-01T08:45:43.597Z (9 months ago)
- Topics: dotfiles, personal, personal-dotfiles, setup, setup-development-environment, setup-macos
- Language: Shell
- Size: 77.1 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# .files
> These are my dotfiles. Take anything you want, but at your own risk.
It is intended to target macOS systems with zsh shell.
## Overview
- [Homebrew](https://brew.sh) (packages: [Brewfile](./Brewfile))
- [Node.js + npm LTS](https://nodejs.org/en/download/) (packages: [npmfile](./npmfile))
- Latest Ruby (packages: [Gemfile](./Gemfile))
- Latest Git, Python 3, wget, ...
- [Mackup](https://github.com/lra/mackup) (sync application settings)
- useful [aliases](./system/.alias))
## Before you start
If you had a previous macbook with Mackup installed, make sure to run `mackup backup` to save your app settings before installing your new machine.
## On fresh install
### Prerequisites
sudo softwareupdate -i -a
xcode-select --install
sudo softwareupdate --install-rosetta # for macOS with M1 chips
The Xcode Command Line Tools includes `git` and `make` (not available on stock macOS).
Then, install this repo with `curl` available:
curl -o- https://raw.githubusercontent.com/nash403/dotfiles/master/remote-install.sh | bash
This will clone (using `git`), or download (using `curl` or `wget`), this repo to `~/dev/dotfiles` and symlink it to `~/.dotfiles`. Alternatively, clone manually into the desired location:
git clone https://github.com/nash403/dotfiles.git ~/dev/dotfiles
ln -s /the/full/path/to/where/you/cloned/dotfiles ~/.dotfiles
### Init everything
Use the [Makefile](./Makefile) to install everything [listed above](#overview), and symlink [run](./run) and [config](./config) (using [stow](https://www.gnu.org/software/stow/)):
cd ~/.dotfiles
make
> Note :warning:: Since this command installs Mac App Store applications, you should be signed in into the Mac App Store before running this command.
### Specify the `$PATH`
If `~/.path` exists, it will be sourced along with the other files.
Here’s an example `~/.path` file that adds `/usr/local/bin` to the `$PATH`:
```bash
export PATH="/usr/local/bin:$PATH"
```
### Customize/extend
You can put your custom settings, such as Git credentials in the `system/.custom` file which will be sourced from `.zshrc` automatically. This file is in `.gitignore`.
## On Post-install
Check the paths in `config/git/config` and update them accordingly to yours. Typically replace the username and github user.
### Mackup
- Log in to Dropbox (and wait until synced)
- `ln -s ~/.config/mackup/.mackup.cfg ~` (until [#632](https://github.com/lra/mackup/pull/632) is fixed)
- `mackup restore`
### Sensible macOS defaults
When setting up a new Mac, you may want to set some sensible macOS defaults:
```bash
./.macos
```
Definitely go through and check each [setting](./run/.macos) before running, this can change some major things!
> Note: check the first setting to set your computer name.
## Additional resources & Credits
Where I mainly ~~stole ideas~~ got inspiration from:
- [webpro's dotfiles](https://github.com/webpro/dotfiles)
- [Dennis Muensterer's dotfiles](https://github.com/dnnsmnstrr/dotfiles)
- and of course [Mathias Bynens' dotfiles](https://github.com/mathiasbynens/dotfiles)
Other resources:
- [Homebrew](https://brew.sh)
- [Antigen](http://antigen.sharats.me/)
- [Mac App Store CLI](https://github.com/mas-cli/mas)
- [Spaceship prompt](https://github.com/denysdovhan/spaceship-prompt)
- [NVM](https://github.com/nvm-sh/nvm)
Many thanks to the [dotfiles community](https://dotfiles.github.io).
## License
[MIT](./LICENSE) - Copyright (c) 2020-present [Honoré Nintunze](https://twitter.com/nash_403)