# 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 `Loader`s 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](https://ii.clsty.link/en/ii-qs/01setup/) 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.