Skip to main content

Unix-inspired dotfiles for power users

A complete Arch Linux development environment with i3 tiling window manager, polybar, doom emacs, neovim, and zsh — optimized for terminal-based workflows and developer productivity.

Get StartedInstallation Guide

Quick start

Get your development environment configured in minutes

1

Clone the repository

Clone the dotfiles repository to your home directory.
git clone git@github.com:joaopedroaats/dotfiles.git ~/dotfiles
This operation will overwrite existing configuration files. Make sure to back up important data before proceeding.
2

Sync your configurations

Run the sync script to create symlinks for all configuration files.
sh ~/dotfiles/sync.sh
The script uses the custom stot wrapper around GNU stow to manage dotfile symlinks across your system.
3

Start using custom commands

All custom commands are now available in your PATH via ~/.local/bin.
# Update system packages
update

# Stream radio from terminal
radio

# Generate a secure password
pass
Explore the full list of available commands in the Custom Commands section.

Explore the configuration

Deep dive into each component of the development environment

Window Manager

i3 tiling window manager with custom keybindings, polybar status bar, and rofi launcher

Terminal Setup

Kitty terminal emulator with zsh, powerlevel10k, and extensive plugin configuration

Editors

Doom Emacs and Neovim setups optimized for coding and writing

Custom Commands

Custom CLI utilities for dotfile management, system updates, and productivity

System Config

Bootloader, networking, and audio configuration for Arch Linux

Reference

Complete reference for all commands, keybindings, and directory structure

Key features

Everything you need for a powerful development environment

i3 Tiling Window Manager

Keyboard-driven workflow with custom keybindings, workspace layouts, and efficient window management

Powerful Shell Configuration

Zsh with powerlevel10k theme, auto-suggestions, syntax highlighting, and extensive plugin ecosystem

Doom Emacs & Neovim

Two powerful editors configured for coding and writing, with LSP support and productivity enhancements

Custom Command Suite

Purpose-built utilities for dotfile management, system updates, radio streaming, and password generation

Ready to configure your environment?

Get started with the installation guide and have your development environment set up in minutes.

Install Now