stow-patterns

Deploy dotfiles with GNU Stow via Makefile dry-run checks and backups.

Updated Oct 3, 2024
One-click install
npx skills add https://github.com/RuanBuitendag42/.dotfiles --skill stow-patterns
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stow-patterns
Source: https://github.com/RuanBuitendag42/.dotfiles/tree/main/home/.copilot/skills/stow-patterns
Command: npx skills add https://github.com/RuanBuitendag42/.dotfiles --skill stow-patterns

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

GNU Stow-based deployment patterns unify dotfiles management by creating deterministic symlinks for home and config directories, while safely handling existing files.

Core Features & Use Cases

  • Declarative directory conventions map config and home files to their targets.
  • Makefile-driven deployment with dry-run checks, automatic backups, and restow workflow.
  • Step-by-step guidance for adding new configurations and maintaining reproducible setups.

Quick Start

Run make install from the repository root to deploy all dotfiles configurations.

Frequently Asked Questions about stow-patterns

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage dotfiles with GNU Stow safely?

To manage dotfiles with GNU Stow safely, use a Makefile-driven workflow with dry-run conflict checks and automatic backups to ~/.dotfiles_backup before deploying symlinks.

What is the best way to deploy dotfiles using symlinks and a Makefile?

The best way to deploy dotfiles via symlinks is running make install, which uses restow deployment with -R and --no-folding to map config and home files deterministically.

How does Stow handle existing config files during dotfiles deployment?

During dotfiles deployment, existing config files are handled by performing dry-run conflict checks first, then automatically backing up conflicts to ~/.dotfiles_backup before creating symlinks.

Do I need a Makefile to use Stow for dotfiles management?

A Makefile is required for this dotfiles management workflow to automate initial setup and ongoing maintenance tasks like conflict detection, backups, and restowing.

Why does GNU Stow use --no-folding for restowing dotfiles?

GNU Stow uses --no-folding for restowing dotfiles to create deterministic symlinks for individual home and config files rather than symlinking entire directories.