dotfiles

dotfiles used by Chikurin1014

Environment requirements for installation

• Git
• Nix (recommended, optional)
• Dotter (optional)

You can choose a deployment tool to manage your dotfiles. The following tools are available:

• Nix
  You can deploy the dotfiles and install packages with a single command

• Dotter
  You need to install packages manually.

• Nothing
  You don't need any external tools (expect git), but you use the shellscripts in sl-maker-for-dotfiles, which is a repository hosted by Chikurin1014. You need to install packages manually.

Note

If you are using Windows, you should use Dotter

Installation of Nix (optional)

If you haven't installed Nix, you can install it by following the instructions below.

• NixOS website
• Determinate Nix

Installation of Dotter (optional)

If you don't use Nix, you can use Dotter to manage your dotfiles. You can install it by following the instructions below.

• Dotter Wiki

Installation

1. Clone this repository to home directory

cd ~
git clone [email protected]:Chikurin1014/dotfiles.git
cd dotfiles

2. Set up a deployment tool

• Nix

  Run:

  nix run home-manager -- switch --flake . -b bak

• Dotter

  Create .dotter/local.toml and add the following content:

  includes = []
  packages = ["default"]

  [!NOTE] On Windows, .dotter/local.toml should be like below:

  includes = [".dotter/windows.toml"]
  packages = ["default", "wsl", "latex", "lazygit", "nushell"]

• Nothing

  Initialize and update submodules to use sl-maker-for-dotfiles:

  git submodule init && git submodule update

Usage

Deploying dotfiles

After the installation, you can use the following command to deploy the dotfiles (in zsh or nushell):

deploy-dotfiles

Installing packages

• Nix

  Run:

  deploy-dotfiles

• Dotter or Nothing

  You need to install packages manually.

  Check the home-manager/home/packages.nix file for the list of packages to install.

  • Example for Debian/Ubuntu

    sudo apt update && sudo apt upgrade -y
    sudo apt install -y \
        build-essential \
        ...

Note

On Windows, you can use Scoop to install packages:

scoop import scoop.json

You should install Firge Nerd Font manually from Releases · yuru7/Firge.

After installing packages, you can install language runtimes by the following command:

mise install