Publish docs#

Generate & publish commands#

  • Publish docs (dry run)

    uv run --project python dotfiles publish --dry-run
    
  • Publish docs (real run)

    uv run --project python dotfiles publish --no-dry-run
    
  • Optional publish overrides

    uv run --project python dotfiles publish --dry-run --remote-name=public
    uv run --project python dotfiles publish --dry-run --dotfiles-repo=vvnraman/dotfiles
    uv run --project python dotfiles publish --dry-run --github-url=https://github.example.com
    

If flags are not provided, publish uses python/src/dotfiles/dotfiles-config.ini defaults, then *_OVERRIDE environment variables.

Publish from current branch#

uv run --project python dotfiles publish --no-dry-run --override-branch=<branch-name>

The publish workflow requires a clean worktree and enforces branch checks.