kc's dotfiles

Personal dotfiles configuration for kamontat.

• Terminology
  • Target directory
    • Target
    • Target state
  • Source directory
    • Source state
  • Local repository
  • Remote repository
  • Lite setup
  • Full setup
• Features
  • Zinit
    • To upgrade zinit
    • To upgrade plugins
• Usage
  • Prerequisite
  • Quick start
• Actions
  • To update target directory
  • To uninstall dotfiles
  • To upgrade tools
    • Homebrew
• Docker
• Contributing

Terminology

Please refer additional terminology on chezmoi

Target directory

The destination directory being managed (typically ~).

Target

Individual files, directories, or symlinks within the target directory.

Target state

The computed desired state for your target directory (derived from source state, config, and current destination state).

Source directory

Where chezmoi stores the source state (~/.local/share/chezmoi by default).

Source state

The desired state definition (includes templates and machine-specific data).

Local repository

The git repository on your local machine (usually will be your source directory), which contains the source state and configuration.

Remote repository

An external git repository (e.g. GitHub) that you push your local changes to and pull updates from. This allows you to sync your dotfiles across multiple machines.

Lite setup

This is default set up mode when install from Dockerfile. Lite set up will ignore all encrypted files and only install sharable configuration.

Full setup

This only apply to Lite setup. When use machine with lite setup, you will have option to convert to full setup via kdf-* script.

Features

• Zsh configuration: here
  • Zinit - Zsh plugin manager
• Git configuration: here
• Application and packages (via Homebrew)
  • View installed applications here
• Commandline tools (via mise)
  • View install tools here
• Working directory layout: here
  • Personal directory for personal projects
  • Works directory for work projects, organized by workplace
• Encrypted files via gpg
• Password manager via 1Password

Zinit

Installation method: chezmoi/external

To upgrade zinit

zinit self-update

To upgrade plugins

zinit update --all

Usage

Prerequisite

1. Install chezmoi
2. [Optional] Install [gpg][gpg-url] for decrypt files (required on full setup)

Quick start

Actions

https://www.chezmoi.io/user-guide/daily-operations/ https://www.chezmoi.io/user-guide/command-overview/

Below are a list of actions you might perform when use this repository.

To update target directory

To uninstall dotfiles

To upgrade tools

Since we have several tools, each have it own ways to upgrade. You might prefer do one-by-one instead of using script to upgrade all of them.

Homebrew

Add --greedy will install version :latest and auto_updates true as well.

brew upgrade --greedy

Docker

Contributing

Please refer to CONTRIBUTING guide.