Axiom Dotfiles is my personal collection of dotfiles and configurations for Hyprland and related tools, designed to create a cohesive, feature-packed, and visually appealing desktop environment.

• Grid-Based Workspaces: Completely new way to manage workspaces using a grid system
• Color Generation: Generate color schemes based on your wallpaper
• Pinnable AI Chat: Pinnable Menu panel with built-in AI chat functionality
• Application Based OSD: Set multiple applications for the OSD

• Onboarding + Setup Wizard
• Clipboard manager
• Dice roller???
• First stable release -> Moving from chaos in git history to merged PRs only
• AUR Package
• Limitless Widgets

• Implement all planned features
• Create and release teaser video
• Bug fix + refactor messy code + optimizations
• Implement/utilize/fix comprehensive configuration options --> (potentially move to PR's only here)
• Housekeeping + Documentation
• Collaboration + pipeline setup
• Installation script + management
• AUR package (stretch goal for first stable release)
• Docker support (stretch goal for first stable release)
• Widget templating (stretch goal for first stable release)
• First stable release | DUE DATE: 2025-12-10 (Major personal life changes at this date)

This organization contains modular repositories for different components:

• Widgets: axiom
• Hypr Config: hypr

TODO: Add Docker setup and instructions.

TODO: Add installation script and AUR package

TODO: Find all dependencies

Required:

• Dependency 1 ([version/range])

Optional:

• Optional Dependency 1: ([version/range])([purpose])

# Good luck. This is not really ready for public use yet :)
git clone https://github.com/axiom-dotfiles/axiom.git ~/.config/quickshell/axiom
git clone https://github.com/axiom-dotfiles/hypr.git ~/.config/hypr
# ... debug

Configuration is available via config/config.json Please note that until the first release, all options are considered a suggestion, and may not actually do anything yet

# No managed installation available yet :(
# If you have made changes to the source code, I would reccomend using this workflow to safely update
# You can also create and delete a branch
# make a random commit to save your changes
# You shouldn't need to back up your user folder, but you can if you want to be safe
git commit -am "temp commit"
# now that we have our safety commit, we can reset main to pull
git reset --hard origin/main
git pull origin main
git cherry-pick --no-commit HEAD@{1}
# resolve any conflicts - lazygit is my preferred tool for merge confilcts

# Remove configuration directories
rm -rf ~/.config/quickshell/axiom
rm -rf ~/.config/hypr

TODO: Add common issues and solutions here.

For when contributions are ready: Contributions are welcome! Please feel free to submit a Pull Request to any of the repositories in this organization. (see above, not ready yet, PR's on github will be closed)

1. Fork the relevant repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

This project is licensed under the MIT License. See LICENSE

• hyprland
• quickshell
• illogical-impulse
• caelestia-dots
• JaKooLit

• Contact: @travmonkey:matrix.org
• Space: @axiom-dotfiles:matrix.org (not ready yet) (potentially looking for moderators)

⭐ If you find this useful, please consider starring the repositories!