https://github.com/carseven/.dotfiles
My personal development environment fully automated using ansible.
https://github.com/carseven/.dotfiles
ansible dotfiles macos ubuntu
Last synced: about 1 year ago
JSON representation
My personal development environment fully automated using ansible.
- Host: GitHub
- URL: https://github.com/carseven/.dotfiles
- Owner: carseven
- Created: 2021-08-26T15:53:37.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2025-02-28T15:19:14.000Z (over 1 year ago)
- Last Synced: 2025-04-23T22:03:47.178Z (about 1 year ago)
- Topics: ansible, dotfiles, macos, ubuntu
- Language: Shell
- Homepage:
- Size: 70.4 MB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
Awesome Lists containing this project
README
.dotfiles
## Dev
Install shellcheck
```sh
brew install shellcheck
```
Install shfmt
```sh
brew install shfmt
```
### Add new script
Add a new file to the `runs` directory.
Then make the file executable.
```sh
chmod u+x runs/vscode
```
## Install
### Macos setup
Install brew package manager. [Brew documentation](https://brew.sh)
```shell
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
```
Export path of brew to be able to use brew binary
```shell
export PATH="/opt/homebrew/bin:$PATH"
```
### Ubuntu setup
Update and install basic packages for using apt.
```shell
sudo apt update
sudo apt install software-properties-common
```
### Launch install scripts
The following commands requires to be run from .dotfiles root directory from the repository ~/.dotfiles
```shell
./run
```
Using the first argument you can launch only specific scripts. This is really useful to update changed configuration without running all the scripts, because we are not using symlinks to be idempotent. To update changes, we need to launch again the scripts.
```shell
./run vscode
```
## Documentation
Documentation for things that are not automated.
- [Windows dotfiles](./doc/windows/readme.md)
- [Nuphy Keyboard](./doc/keyboards/nuphy-air60v2/readme.md)
- [Planck Keyboard](./doc/keyboards/planck/readme.md)
### Roadmap
- Regression test from zero
- Capture control + c to exit the run script
- capture exit 1 from run script
- Setup docker to test clean installs (Linux and macos)
- Automate sudo, ask at the beginning of the script only.
- Prettify logs and error handling (Better show when script errors, maybe finish script execution?)
-
### Resources
- https://github.com/Gentleman-Programming/Gentleman.Dots
- https://github.com/ThePrimeagen/dev
- https://github.com/ThePrimeagen/.dotfiles
- https://github.com/typecraft-dev/dotfiles
- https://github.com/joshmedeski/dotfiles