# Developing Omarchy One App Per Workspace

This repository contains a third-party service and bar-widget plugin for the
Omarchy 4 Quickshell shell. It is not a standalone Quickshell application.

## Requirements

- Omarchy 4 with the Quickshell bar
- Hyprland
- GJS for the model tests
- Lua for the pre-layout hook tests

## Validate

Run the local checks from the repository root:

```bash
omarchy plugin validate .
./test/one-app-per-workspace-test.sh
qmllint -I "$OMARCHY_PATH/shell" Service.qml
qmllint -I "$OMARCHY_PATH/shell" Widget.qml
```

## Local Testing

The scripts under `scripts/` are local development helpers. Omarchy does not
run them during normal plugin installation, updates, or removal.

Install the current working tree:

```bash
./scripts/dev-install.sh
```

The development installer copies the runtime files to
`~/.config/omarchy/plugins/ericvrp.one-app-per-workspace`, adds the widget to
the left bar section, and restarts the Omarchy shell. It creates a timestamped
backup before changing an existing shell configuration. It does not edit
Hyprland files or remove the previous implementation.

Remove the local development installation with:

```bash
./scripts/dev-uninstall.sh
```

Pass `--no-restart` to either helper when testing configuration changes without
restarting the live shell.

## Runtime Notes

The service listens to Hyprland's `openwindow` and `closewindow` IPC events. It
waits briefly for Quickshell's Hyprland object model to settle before acting on
an event. These delayed handlers remain the fallback for the regular
configuration provider.

When Hyprland reports Lua configuration mode, the service also loads
`OneAppPerWorkspaceEarlyHook.lua` through `hyprctl repl`. That hook handles
`window.open_early`, before Hyprland inserts the new window into Dwindle,
Scrolling, or another layout. It moves a second tiled window directly to the
first empty workspace, avoiding the intermediate layout shift. It also handles
`window.close` while the closing window is still in its old layout, focusing the
nearest occupied workspace before Hyprland removes that layout target. This
avoids briefly rendering the old empty workspace. The service resynchronizes
the hook after a Hyprland config reload and removes it when the plugin service
is destroyed.

The off state is represented by:

```text
~/.local/state/omarchy/toggles/one-app-per-workspace-off
```

No marker means enabled. The marker is created and removed by the bar icon;
the service reads it when the shell starts and watches the existing toggle
directory for later changes.