https://github.com/hashiiiii/dotfiles
Dotfiles for Debian-based Linux and MacOSX.
https://github.com/hashiiiii/dotfiles
debian dotfiles dotfiles-linux dotfiles-macos powershell shell wsl2 zsh zshrc
Last synced: 12 months ago
JSON representation
Dotfiles for Debian-based Linux and MacOSX.
- Host: GitHub
- URL: https://github.com/hashiiiii/dotfiles
- Owner: hashiiiii
- License: mit
- Created: 2025-01-28T06:54:51.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-23T12:44:14.000Z (12 months ago)
- Last Synced: 2025-02-23T13:36:58.043Z (12 months ago)
- Topics: debian, dotfiles, dotfiles-linux, dotfiles-macos, powershell, shell, wsl2, zsh, zshrc
- Language: Shell
- Homepage:
- Size: 804 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# 🚀 Cross-Platform Dotfiles
[](LICENSE.md)
**Documentation ( [English](README.md), [Japanese](README_JA.md) )**
A powerful dotfiles management system designed for developers who work across multiple platforms. Seamlessly manages your development environment across Debian-based Linux (including WSL2), and macOS.
## 📚 Overview
Details
- [✨ Key Features](#-key-features)
- [🔄 Cross-Platform Compatibility](#-cross-platform-compatibility)
- [🛡 Safe Configuration Management](#-safe-configuration-management)
- [🎯 Smart Package Management](#-smart-package-management)
- [⚡️ Enhanced Productivity Tools](#%EF%B8%8F-enhanced-productivity-tools)
- [🎨 Terminal Customization](#-terminal-customization)
- [🚀 Quick Start](#-quick-start)
- [📦 What's Included](#-whats-included)
- [Core Tools](#core-tools)
- [🔄 Backup and Restore](#-backup-and-restore)
- [Automatic Backups](#automatic-backups)
- [Restore Previous Configuration](#restore-previous-configuration)
- [🔎 FAQ](#-faq)
- [📝 License](#-license)
## ✨ Key Features
### 🔄 Cross-Platform Compatibility
- **WSL2**: Full support for Windows Subsystem for Linux
- **Debian-based Linux**: Native support for Debian and Ubuntu
- **MacOSX**: Complete support for both Apple Silicon and Intel processors
### 🛡 Safe Configuration Management
- **Automatic Backups**: Every existing configuration is backed up before modification
- **Easy Rollback**: Restore your previous configuration with a single command:
```bash
make restore
```
### 🎯 Smart Package Management
- **Sheldon Integration**: Modern plugin management using `plugins.toml`
- Centralized plugin configuration
- Fast, async plugin loading
- Easy to maintain and update
- **Platform-Specific Package Management**:
- Homebrew for MacOSX and Linux
- apt for Debian-based systems
### ⚡️ Enhanced Productivity Tools
- **FZF Integration**:
- Quick file search (`Ctrl+T`)
- Command history search (`Ctrl+R`)
- **Custom FZF Commands**:
- `fb`: Interactive Git branch switching
- `sf`: Search file contents with preview
- `fd`: Fast directory navigation based on file selection
### 🎨 Terminal Customization
- **Nerd Fonts Support**: Automatic installation and configuration
- Windows (via Scoop)
- MacOSX (via Homebrew)
- **Terminal-Specific Setup**:
- Windows Terminal
- iTerm2
- Terminal.app
## 🚀 Quick Start
1. **Clone the Repository**:
```bash
git clone https://github.com/yourusername/dotfiles.git
cd dotfiles
```
2. **Install**:
```bash
make install
```
3. **Restart the shell**
```bash
exec zsh
```
## 📦 What's Included
### Core Tools
- **Shell**: Modern ZSH configuration with Sheldon plugin management
- **Git**: Optimized Git configuration with useful aliases
- **Terminal**: Platform-specific terminal configurations
- **Fonts**: JetBrainsMono Nerd Font for a consistent look
## 🔄 Backup and Restore
### Automatic Backups
- All existing configurations are automatically backed up before installation
- Backups are stored in `~/{fileName}.backup`
### Restore Previous Configuration
```bash
make restore
```
## 🔎 FAQ
1. **Installing Nerd Fonts in Windows Terminal**
For WSL2 users, logs will be displayed as shown above. You can install Nerd Fonts by executing the displayed path in Windows Terminal.
2. **Adding zsh plugins**
We use sheldon as the plugin manager. Edit `.config/sheldon/plugins.toml` to add new plugins. Documentation can be found [here](https://sheldon.cli.rs/Introduction.html).
3. **Adding custom utility functions**
It's recommended to add your custom functions as plugins in the `.zsh/plugins` directory with names like `foo.zsh`, keeping them separate from .zshrc.
## 📝 License
This software is released under the MIT License.
You are free to use it within the scope of the license, but you must include the following copyright notice and license text when using this software:
* [LICENSE.md](LICENSE.md)
Additionally, the table of contents in this document was generated using the following software:
* [toc-generator](https://github.com/technote-space/toc-generator)
For details on the toc-generator license, please see [Third Party Notices.md](Third%20Party%20Notices.md).