---

name: add-app-config description: Use when adding configuration for a new application to the dotfiles, setting up a new tool's config, or when user says "add config for X"

Add App Configuration

Add a new application's configuration to Juliet dotfiles with proper stow symlinks.

Process

1. Create config directory

   Copymkdir -p ~/.config/Juliet/symlinked/config/<app-name>/
   

2. Add configuration files

   • Create config files inside symlinked/config/<app-name>/
   • Use the app's expected filenames (e.g., config, config.toml, settings.json)

3. Run stow to create symlinks

   Copystow --target=$HOME/.config --dir=$HOME/.config/Juliet/symlinked config
   

4. Apply Bamboo theme (if applicable)

   • Check if app supports Bamboo theme
   • Apply consistent colors: dark green-tinted background, soft white foreground
   • Document theme setting in .claude/rules/theming.md

Pre-flight Check

Before creating, verify the target doesn't already exist:

Copyls -la ~/.config/<app-name>

If it exists and is NOT a symlink, back it up first:

Copymv ~/.config/<app-name> ~/.config/<app-name>.backup

Example: Adding Fuzzel Config

Copy# Create directory
mkdir -p ~/.config/Juliet/symlinked/config/fuzzel/

# Create config file
# (write fuzzel.ini content)

# Stow it
stow --target=$HOME/.config --dir=$HOME/.config/Juliet/symlinked config

# Verify
ls -la ~/.config/fuzzel  # Should show symlink to Juliet

Common Mistakes

• Creating files directly in ~/.config/ instead of symlinked/config/
• Forgetting to run stow after adding files
• Not checking if target folder already exists (could overwrite user data)