dots-hyprland/CONTRIBUTING.md

Contributing

• Please, please, please, make multiple PRs if you have many features/fixes, and don't shove your personal changes along with the PR, including changed defaults
• We can accept features that we do not personally want, but in that case we will ask you to make it configurable/optionally loaded.
• If you want to start working on something big to contribute, it might be a good idea to ask first to not waste your effort (but if you've already done it for yourself, it doesn't hurt to submit).

Code details

Contributing to i18n

For contributing in translation (i18n) for Quickshell, see also .config/quickshell/translations/tools.

Dynamic loading

• If something's not always necessary, especially when guarded by a config option to enable/disable, put it in a Loader. One tip with Loaders is sometimes you will need to declare positioning properties (like anchors) in the Loader, not the sourceComponent.

Practical concerns

• Make sure what you add does not require significant resources for a minor purpose or harm usability just for the sake of looking nice. The dotfiles must remain practical for daily driving.
• If there is something really fancy and impractical anyway, add a config option for it and make sure it's disabled by default.

Setting up

The following instruction assumes that you have an Arch(-based) Linux system.

Complete

Might not be necessary depending on what you change, but this is recommended.

• Install the dotfiles (if you don't wanna replace your stuff completely, do it on a new user).
• Make changes, copy changes to a fork, create PR.

Partially working shell

Most stuff in the shell will work but not everything.

• Install Hyprland and the development version of Quickshell (yay -S hyprland quickshell-git).
• Copy .config/quickshell folder to your home directory.

Extra setup for Quickshell

• Quickshell-specific LSP setup: Run touch ~/.config/quickshell/ii/.qmlls.ini for proper LSP support.
• Hint for VSCode: Get the official "Qt Qml" extension, go to its settings and change custom exe path to /usr/bin/qmlls6.

Python

If your changes involves using python package or script, please use the virtual environment created by uv as described in scriptdata/uv/README.md.

Running

• Launch Hyprland (not the "uwsm-managed" one)
• For the shell:
  • Open ~/.config/quickshell/ii in your code editor.
  • In a terminal run pkill qs; qs -c ii to start the shell in the terminal (for logs).
  • Make edits in the opened folder. Changes are reloaded live.