Cookiecutter dotfiles is a template powered by Cookiecutter to create a custom and modular dotfiles repository.
For a detailed explanation of the template, please refer to the documentation.
To use the template, you need to have Cookiecutter installed. For that, if you already have Python installed, you can run:
pip install cookiecutter
Once you have Cookiecutter installed, you can run the following command to
create a new dotfiles repository in your ~/Projects
directory:
cookiecutter -o ~/Projects gh:mariovagomarzal/cookiecutter-dotfiles
You will be prompted to enter some information about your new dotfiles repository. Here's an example of the output:
project_slug [dotfiles]:
author [Your Name]: John Doe
github_username [your_github_username]: johndoe
github_repo [dotfiles]: ↩
default_branch [main]: ↩
dotfiles_dir [$HOME/Projects/dotfiles]: ↩
Select license:
1 - MIT
2 - Apache-2.0
3 - The-Unlicense
Choose from 1, 2, 3 [1]: ↩
Select macos_support:
1 - yes
2 - no
Choose from 1, 2 [1]: ↩
Select linux_support:
1 - yes
2 - no
Choose from 1, 2 [1]: ↩
This will create a new directory called dotfiles
in your ~/Projects
directory with the following structure:
dotfiles/
├── LICENSE
├── README.md
├── linux_order.sh
├── macos_order.txt
├── common/
├── linux/
├── macos/
└── src
├── bootstrap.sh
├── install.sh
├── setup.sh
└── utils.sh
The README.md
file contains the documentation of your dotfiles
repository. Now you can start customizing your repository by adding new
files and directories with your dotfiles. See the
documentation
for more information on how to do that.
This project is licensed by Mario Vago Marzal under the terms of the MIT License.
Note: The LICENSE file in the
{{cookiecutter.project_slug}}
directory is part of the template and does
not affect the license of the project itself.