Yolk GitHub
Yolk

Templated Dotfile Management without Template Files

Yolk is a cross platform dotfile management tool with a unique spin on templating, sitting somewhere in between GNU Stow and chezmoi. 

curl --proto '=https' --tlsv1.2 -LsSf https://github.com/elkowar/yolk/releases/download/v1.3.0/yolk_dots-installer.sh | sh
View all installation options

The Concept

Yolk allows you to use simple templates in your configuration files without having to worry about keeping a separate template file and the generated config file in sync.

This is achieved through a design that allows all templates to be included inside comments in your actual configuration file.

Read the full documentation →
config.toml - Yolk Editor 
# Use a different font on one host
# {% if SYSTEM.hostname == "epic-desktop" %}
font="Fira Code"
# {% else %}
#<yolk> font="Iosevka"
# {% end %}

[colors]
# Load your colors from your yolk configuration
bg="#282828" # {< replace_color(data.colors.bg) >}
fg="#ebdbb2" # {< replace_color(data.colors.fg) >}

Inline Templates

Yolk is able to run the template modifications on the file itself, allowing you to set templated values while keeping the template directly in the same file.

Learn about templating →

User Configuration

Yolk template expressions and configuration are written in the Rhai scripting language. You can provide custom data to use in your templates via the yolk.rhai file in your yolk directory, which allows you to fetch data dynamically from your system, or reference different static data depending on your system.

Version Control

Given that the concrete files in use on your system may be different across machines, adding those to version control directly would result in frequent merge conflicts. Yolk solves this by only committing a canonical version of your templates, generated right before you commit. The version of your configuration seen in git is generated from a consistent, stable context.

Read the git workflow docs →

Cross Platform

Yolk can lay your eggs anywhere you'll need them.

Linux macOS Windows Android