wiki/docs/dotfiles.md

---
  icon: simple/gnubash
---

# dotfiles

<div class="grid cards" markdown>

- :simple-git:{ .git } [tylernguyen/dotfiles](https://github.com/tylernguyen/dotfiles)
    ![GitHub Stars](https://img.shields.io/github/stars/tylernguyen/dotfiles?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
    ![GitHub Forks](https://img.shields.io/github/forks/tylernguyen/dotfiles?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
    ![GitHub Stars](https://img.shields.io/github/stars/tylernguyen/dotfiles?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }
    ![GitHub Forks](https://img.shields.io/github/forks/tylernguyen/dotfiles?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }

</div>

<div class="grid cards" markdown>

- ![chezmoi](https://assets.tylernguyen.wiki/logos/chezmoi.svg){ .twemoji } [chezmoi](https://github.com/twpayne/chezmoi/)
[:octicons-markdown-16:](https://www.chezmoi.io/){ .card-link title=Documentation}
[:fontawesome-regular-file-code:](https://github.com/twpayne/chezmoi){ .card-link title="Source Code" }
[:octicons-law-16:](https://github.com/twpayne/chezmoi/blob/master/LICENSE){ .card-link title=License }

    ``` bash

    chezmoi init --ssh tylernguyen #(1)

    ```

    1. Initialize `chezmoi` source direcotry with the dotfiles repository of :simple-github:{ .foreground } GitHub user `tylernguyen`. Use SSH origin instead of the default HTTPS.

</div>

<div class="grid cards" markdown>

- :simple-1password:{ .onepassword } [1Password](https://1password.com/)
[:fontawesome-solid-money-bill:](https://1password.com/sign-up/){ .card-link title=Pricing }
[:fontawesome-regular-eye:](https://support.onepassword.com/1password-privacy/){ .card-link title="Privacy Policy" }
[:octicons-markdown-16:](https://developer.onepassword.com/){ .card-link title="Developer Documentation" }

- :simple-wezterm:{ .wezterm } [wezterm](https://wezfurlong.org/wezterm/index.html)
[:octicons-markdown-16:](https://wezfurlong.org/wezterm/){ .card-link title=Documentation}
[:fontawesome-regular-file-code:](https://github.com/wez/wezterm){ .card-link title="Source Code" }
[:octicons-law-16:](https://github.com/wez/wezterm/blob/main/LICENSE.md){ .card-link title=License }

</div>

<div class="grid cards" markdown>

- :simple-zsh:{ .foreground } [zsh](https://zsh.sourceforge.io/)
[:octicons-markdown-16:](https://zsh.sourceforge.io/Doc/){ .card-link title=Documentation}

    :simple-git:{ .git } [zimfw/zimfw](<https://github.com/zimfw/zimfw>)
        ![GitHub Stars](https://img.shields.io/github/stars/zimfw/zimfw?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/zimfw/zimfw?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Stars](https://img.shields.io/github/stars/zimfw/zimfw?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/zimfw/zimfw?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }

    :simple-git:{ .git } [romkatv/powerlevel10k](<https://github.com/romkatv/powerlevel10k>)
        ![GitHub Stars](https://img.shields.io/github/stars/romkatv/powerlevel10k?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/romkatv/powerlevel10k?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Stars](https://img.shields.io/github/stars/romkatv/powerlevel10k?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/romkatv/powerlevel10k?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }

    :simple-git:{ .git } [atuinsh/atuin](<https://github.com/atuinsh/atuin>)
        ![GitHub Stars](https://img.shields.io/github/stars/atuinsh/atuin?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/atuinsh/atuin?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Stars](https://img.shields.io/github/stars/atuinsh/atuin?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/atuinsh/atuin?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }

    :simple-git:{ .git } [Aloxaf/fzf-tab](https://github.com/Aloxaf/fzf-tab)
        ![GitHub Stars](https://img.shields.io/github/stars/Aloxaf/fzf-tab?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/Aloxaf/fzf-tab?style=flat&logo=GitHub&logoColor=073642&labelColor=eee8d5&color=859900#only-light){ .twemoji }
        ![GitHub Stars](https://img.shields.io/github/stars/Aloxaf/fzf-tab?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }
        ![GitHub Forks](https://img.shields.io/github/forks/Aloxaf/fzf-tab?style=flat&logo=GitHub&logoColor=839496&labelColor=073642&color=2aa198#only-dark){ .twemoji }

</div>

/// abstract
dotfiles is designed with maximum cross-platform compatibility, minimal components, and universal behaviors in mind.
///

## Git :simple-git:{ .git }

`.gitconfig` uses `code` (Visual Studio Code) as the editor, diff and merge tool.

1Password handles SSH authentication and signing.

Projects live under `src/` and are associated with their respective SSH signing key, i.e. `src/tylernguyen@GitHub`, `src/tylernguyen@GitLab`, `tylernguyen.codes`

I prefer to rebase by default, unless there is very specific reason to merge.

## Package Managers

<div class="grid cards" markdown>

- :simple-gnubash:{ .gnubash } [winget](https://github.com/microsoft/winget-cli)
- :simple-flatpak:{ .flatpak } [Flatpak](<https://flatpak.org/>)
- [:simple-homebrew:{ .homebrew } homebrew](https://brew.sh/)
- :simple-appstore:{ .appstore } [App Store](<https://github.com/romkatv/powerlevel10k>)

</div>

/// note

On Windows, portable executables are placed in `%userprofile%/bin`. Include this in `PATH`.

///