https://github.com/lily-gh/dev-bootstrap
Easily set up your new dev machine with your favorite tools with Ansible. 👩🏼💻
https://github.com/lily-gh/dev-bootstrap
ansible automation dev-bootstrap developer-setup developer-tools
Last synced: 20 days ago
JSON representation
Easily set up your new dev machine with your favorite tools with Ansible. 👩🏼💻
- Host: GitHub
- URL: https://github.com/lily-gh/dev-bootstrap
- Owner: lily-gh
- Created: 2025-11-02T18:44:12.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2026-01-13T08:08:24.000Z (3 months ago)
- Last Synced: 2026-01-13T10:46:50.686Z (3 months ago)
- Topics: ansible, automation, dev-bootstrap, developer-setup, developer-tools
- Language: Shell
- Homepage: https://dev-bootstrap.sh
- Size: 43 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# Dev Bootstrap
Easily set up a new computer with developer tools in under 10 minutes.
These automations have been tested on: MacOS, Ubuntu and Arch Linux.
### How to use
#### On MacOS/Ubuntu
[Download this repository](https://github.com/lily-gh/dev-bootstrap/archive/refs/heads/main.zip), go to the root folder of the repository and run:
```sh
./bootstrap.sh
```
Enter the `sudo` password when prompted for the `BECOME` password and sit back while ansible does all the hard work.
#### On Arch
Arch usually doesn't come with `unzip` preinstalled, so the best option is to use `bsdtar`, which comes preinstalled, to unzip the downloaded contents.
Here's a _one-liner_ to download this repository as a `zip` file, unzip it using `bsdtar` and `cd` into the repository folder:
```bash
curl -L -o ~/Downloads/dev-bootstrap.zip https://github.com/lily-gh/dev-bootstrap/archive/refs/heads/main.zip && cd ~/Downloads && bsdtar -xf dev-bootstrap.zip && cd dev-bootstrap-main
```
Then run:
```sh
./bootstrap.sh
```
Enter the `sudo` password when prompted for the `BECOME` password and sit back while ansible does all the hard work.
### Packages
The playbook in this repository ensures that the following packages/apps are installed:
- bat
- ffmpeg
- fzf
- git
- gpg
- eza
- ansible
- asdf
- neovim
- zsh
- zsh-syntax-highlighting
- zsh-autosuggestions
- oh-my-zsh
- powerlevel10k
- vlc
- telegram
- 1password
### How it works
The main `bootstrap.sh` script will check if ansible is installed in the system, and install it if it's not already installed, then, it will use ansible to start the main playbook with the following command:
```sh
ansible-playbook main.yml --ask-become-pass
```
When **_I_** (Lily) run the script, I pass in an additional parameter `lily` when running `bootstrap.sh`, this causes the script to execute an additional ansible playbook and uses an additional argument:
```sh
ansible-playbook main.yml lily.yml --ask-become-pass --ask-vault-pass
```
The `lily.yml` playbook imports two other playbooks that are used to setup my ssh key and download one of my private repos:
```yml
- import_playbook: tasks/setup-ssh.yml
- import_playbook: tasks/clone-lilydevtools.yml
```
The parameter `--ask-vault-pass` prompts me for a password to decrypt the ssh key in this repository.
## Future Ideas
### Configuration Wizard
A web-based wizard to help users generate customized Ansible configuration files for their development environment. Similar to [Spring Initializr](https://start.spring.io/), this tool would:
- Provide an interactive interface to select desired tools, languages, and frameworks
- Allow users to configure version preferences and optional features
- Generate a tailored `playbook.yml` and variable files based on selections
- Offer a preview of what will be installed before downloading
- Enable quick bootstrapping without manually editing configuration files
This would lower the barrier for users unfamiliar with Ansible syntax while maintaining the flexibility of the underlying automation.
## Quality Certificate
