• ┓       
    ┓┏┣┓┏┓┏┓┏┓
    ┗┛┛┗┗┻┛ ┗┻

Ishara Dotfiles

A clean, minimal, and responsive Hyprland configuration featuring a dual-mode workflow and dynamic theme generation.

---

Concept

Ishara is designed for users who appreciate clean, uncluttered workspaces but still require a full suite of desktop tools when executing tasks. The system prioritizes visual harmony, layout flexibility, and distraction-free operation.

At the core of the Ishara workflow is its Dual-Mode System, allowing you to transition your entire desktop state depending on your cognitive workload:

• ** Regular Mode**: Optimized for active multitasking, administration, and system management. Shows the status bar, system indicators, workspace switchers, and widgets in a tiled layout.
• ** Zen Mode**: Designed for deep focus, creative writing, or coding. It hides the status bar, notifications, and desktop widgets, running your active window in a clean centered focus layout with optimal margins.

---

Quality of Life (QoL) Features

While the user interface remains minimal, the underlying architecture is built to be robust and developer-friendly:

• Idempotent Installation & Updates: Pull updates and run the update script at any time without resetting your configurations or forcing system reboots.
• Decoupled Personal Configs: All user settings reside in Git-ignored user/ directories. You will never face merge conflicts when running git pull to update the rice.
• Matugen Theme Generation: Dynamic, real-time colorschemes calculated directly from your active wallpaper.
• GNU Stow Integration: Easily link and unlink system configurations cleanly using Stow.

---

Getting Started

Prerequisites

Ishara is designed for Arch Linux. Ensure you have git installed before proceeding:

sudo pacman -S git

Installation

Clone the repository and run the installation script. The script will check your shell, install required packages, back up conflicting physical configs, link dotfiles via Stow, and configure network and bluetooth services:

git clone https://github.com/lilim/ishara.git
cd ishara
chmod +x install.sh
./install.sh

Updating

To update your rice, pull the repository changes and run the update script. This script fetches updates, installs newly added packages, re-stows, and copy over new configuration templates without overwriting your existing personal configs:

cd ishara
chmod +x update.sh
./update.sh

Uninstallation

To cleanly remove all Stow symlinks and revert configurations while leaving your physical configuration files untouched, run:

cd ishara
chmod +x uninstall.sh
./uninstall.sh

---

Customization Guide

All user-specific configurations are ignored by Git. Modify these files to customize your setup:

• Zsh: Add aliases/exports inside ~/.config/zsh/user/user.zsh.
• Hyprland: Add keybinds, autostart programs, and window rules in ~/.config/hypr/user/ (apps.lua, keybinds.lua, etc.).
• Kitty: Add personal terminal settings inside ~/.config/kitty/user/user.conf.
• Global Theme: Change light/dark mode and active GTK/Cursor theme options inside ~/.config/global/user/theme.conf.

---