Clean Dev Terminal

Clean Dev Terminal is a beginner-friendly repository that guides developers through setting up a beautiful, functional Linux terminal.

It combines several popular tools – Alacritty (terminal emulator), Zsh (shell), Powerlevel10k (Zsh prompt theme), Tmux (terminal multiplexer), and patched Nerd Fonts.

The goal is to provide an easy getting-started guide explaining why each tool is used and how to configure it step by step. New users can either install the entire setup with one script or pick and customize components as needed. By following best practices in documentation and repo structure, the project aims to reach a broad audience (attracting more users, stars, and forks).

✨ Why This Project Exists

Most Linux terminals come with basic shells, minimal visuals, and no productivity features. This project is designed to help beginners quickly set up a professional, fast, and aesthetically pleasing terminal environment — with tools loved by developers around the world.

Each tool is chosen for a reason:

Tool	Description	Why Use It
Alacritty	A GPU-accelerated terminal emulator with simple YAML configuration	Fast, minimal, modern terminal for performance-focused workflows
Zsh	An extended shell with better autocompletion, globbing, and scripting	More powerful and customizable than Bash, great plugin ecosystem
Powerlevel10k	A Zsh theme with a highly customizable and informative prompt	Fast and beautiful prompt with Git, time, exit code, and icons
Tmux	Terminal multiplexer: multiple windows/panes in one terminal session	Enables session persistence, pane layouts, and multitasking
Nerd Fonts	Patched fonts with developer icons and powerline symbols	Required for prompt and tmux themes to render icons and separators

📁 Project Structure

clean-dev-terminal/
├── alacritty/        # Alacritty terminal config and guide
│   └── README.md     # Alacritty setup instructions
│   └── ...
├── zsh/              # Zsh config, plugins, and Powerlevel10k setup
│   └── README.md     # Zsh + p10k configuration
│   └── ...
├── tmux/             # Tmux config and plugin manager
│   └── README.md     # Tmux usage & customization
│   └── ...
├── fonts/            # Font installation and setup
│   └── README.md     # Nerd Fonts info and links
│   └── ...
└── README.md         # Main documentation

Each subdirectory contains:

• ✅ Ready-to-use configuration files.
• 📖 A dedicated guide for setup and customization.

Installation Options

You can configure your environment step-by-step or quickly set up everything using the provided configuration files. Below are categorized installation and configuration guides for each component:

Category	Setup Guide	Configuration Guide	Ready Config
Zsh	Zsh Setup	Zsh Configuration	.zshrc
Oh My Zsh	Oh My Zsh Setup	—	—
Powerlevel10k	P10K Setup	—	—
Alacritty	Alacritty Setup	Alacritty Configuration	alacritty.toml
Fonts	Fonts Install	—	—
Tmux	Tmux Setup	Tmux Configuration, How to Use Tmux	.tmux.conf

✅ You can follow each section individually, or use our ready-made config files for a quicker experience.

Manual Installation

If you want a structured way to get started, follow this path:

1. Install Fonts — Nerd Font for icons/glyphs
2. Install Zsh — Replace Bash with Zsh
3. Oh My Zsh — Plugin & theme manager
4. Powerlevel10k — Beautiful & fast prompt
5. Configure .zshrc — Plugins, aliases, settings
6. Install Alacritty — Terminal emulator
7. Alacritty Config — Style, font, keybinds
8. Install Tmux — Terminal multiplexer
9. Tmux Config — Theme, plugins, options
10. How to Use Tmux (optional) — Learn the basics

If you're short on time, copy the ready config files and tweak as needed.
If you want to learn everything in depth, follow each section above for explanations and screenshots.

One-Click Installation

For fast setup with all configurations, fonts, and plugins included:

sh ./install.sh

⚠️ Works on most Debian-based Linux systems. Make sure you review the script before running.

Who Is This For?

This guide is perfect for:

• Linux users (especially Ubuntu/Debian-based distros)
• Beginners curious about dotfiles and terminal config
• Anyone who loves visual polish with performance
• Developers who want a clean and efficient terminal

🙌 Contributing

We welcome contributions!

• Add themes, config variants, or improvements
• Submit fixes or suggestions to make setup easier
• Help expand support (e.g., Kitty, Neovim, etc.)

If you found this helpful, please give it a ⭐ on GitHub — it helps others discover it!

Tools & Frameworks

Alacritty | Zsh | Powerlevel10k | Oh My Zsh | Tmux | Nerd Fonts