A collection of configuration files that forms a unique development environment.
Here are some visuals and details to see how this project configures a given host.
dotfiles installs and configures hyprland as the main window manager.
dotfiles does not touch existing window managers during the installation and configuration of hyprland.
Status Bar
There are no status bars (e.g. waybar) in this configuration.
Workspace 1: btop
This workspace is mainly designed to monitor the system with btop.
btop
Workspace 2: main terminal
This workspace is designed to hold the main terminal instance of the user.
fastfetch is only executed during the initial boot to show the system information.
Main terminal
Workspace 3: librewolf
This workspace is designed to hold the main browser instance.
librewolf is used as the browser.
Note: User specific configurations for librewolf (e.g. extensions, themes, font, keymaps) should be done explicitly by the user.
librewolf
Empty workspaces & hyprpaper
dotfiles installs hyprpaper to configure wallpapers on a given host.
Here is how an empty workspace looks like:
Empty workspace
Special Workspaces aka scratchpads
There is one non-persistent special workspace called terminal which triggers alacritty on a floating (tiled) window to execute less frequent commands.
dotfiles installs and configures alacritty as the terminal on a given host.
It also installs and configures starship as the shell prompt.
Here is how alacritty looks by default:
Alacritty
dotfiles installs and configures either tmux or zellij to be used as the main terminal multiplexer.
A minimal status bar is used for tmux, like below:
tmux
For zellij, a minimal UI is used similar to tmux:
zellij
dotfiles installs and configures either Neovim or Helix as the editor on a given host.
Here is how nvim looks like upon launching it in a directory:
Neovim (Netrw)
A monochromatic theme is used for Neovim, with its primary color set to rose-pine's rose color, as shown below:
Neovim (Buffer)
Here is how helix looks like upon launching it in a directory:
Helix (Scratch + File Picker)
For Helix, rose-pine theme is used with a transparent background, instead of having a monochromatic theme.
Helix (Buffer)
dotfiles is a configuration management project that allow users to easily replicate their local environment configuration.
For the architecture, please refer to ARCHITECTURE.md.
As of version 0.3.0, dotfiles is designed to support x86_64 Arch Linux hosts only.
Due to time constraints, unfortunately I can only maintain the project for the main OS I use.
However, most of the installation steps can be applied to other Linux distributions easily thanks to Ansible.
The installation is done through an Ansible playbook. Please refer here to see the tools and installation steps.
The usage of the tools are the same, regardless of the installation method. Please refer to each tool's documentation to see their usage.
- (P1) Add missing tools to the installation (recurring).
- (P1) Create an interface to verify and list the installed tools, a different playbook maybe?