Starter Template

The dotts-starter repository provides an opinionated starting point for your dotfiles. It includes pre-configured setups for shell, editor, terminal, and desktop environments.

What's Included

Configurations

Shell

• Fish shell with useful aliases and functions
• Starship prompt configuration
• Zoxide for smart directory jumping

Editor

• Neovim with LazyVim-based configuration
• LSP support, fuzzy finding, and more
• Catppuccin theme

Terminal

• Kitty terminal emulator
• Foot as a lightweight alternative
• Wezterm configuration

Tools

• lazygit for git workflows
• btop for system monitoring
• fastfetch for system info
• lsd for pretty directory listings

Desktop (Linux only)

• Hyprland Wayland compositor
• Waybar status bar
• Dunst notifications
• Fuzzel application launcher

Using the Starter

When you run dotts init, you can select the starter template:

dotts init

Select "Use dotts-starter (recommended)" when prompted for a config source.

Forking the Starter

If you want to customize the starter and track your own changes:

1. Fork the dotts-starter repository
2. During dotts init, select "Use your own repository"
3. Enter your fork's URL

Templates

The starter uses template placeholders for personal information:

[user]
  name = <<dotts:user.name>>
  email = <<dotts:user.email>>

These are replaced with your actual values during the setup process. See Templates for more information.

Customizing

After cloning the starter, you can customize any configuration:

1. Add new configs - Create a folder in configs/ with your dotfiles
2. Add packages - Edit the YAML files in packages/
3. Create profiles - Define new profiles in profiles/
4. Machine configs - Add machine-specific settings in machines/

See the Configuration guide for detailed documentation.