gsadmin/sencho
1
0
Fork 0
mirror of https://github.com/Studio-Saelix/sencho.git synced 2026-08-19 23:06:49 +00:00
Code Issues Packages Projects Releases Wiki Activity

fix(routing): split stack detail URL from compose editor URL (#1605)

Browse Source 
Sidebar opens /stacks/:name (anatomy). Monaco uses /compose|/env|/files.
Refresh of a detail URL no longer opens the editor, and editor deep links
keep a hydration shell instead of flashing the dashboard.
This commit is contained in:
Anso
2026-07-09 12:05:36 -04:00
committed by GitHub
parent 7517a4f49c
commit 296ddff2a0
11 changed files with 216 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/features/deep-links.mdx
+15 -2
View File
@@ -13,7 +13,8 @@ Sencho encodes the active node, the view you are on, and the deep state that vie
|-------------|--------------|---------------|
| Home dashboard | `/nodes/local/dashboard` | The home dashboard for the `local` node |
| Stack list (phone) | `/nodes/local/stacks` | The full-width stack list on a phone |
| Stack editor | `/nodes/local/stacks/radarr/compose` | Radarr's compose tab |
| Stack detail | `/nodes/local/stacks/radarr` | Radarr's stack detail (anatomy). Sidebar entry point |
| Compose editor | `/nodes/local/stacks/radarr/compose` | Radarr's compose.yaml Monaco editor |
| Env tab + file | `/nodes/local/stacks/radarr/env?env=.env.prod` | Radarr's env tab with a specific env file selected |
| Resources | `/nodes/local/resources` | Resources for the active node |
| Security tab | `/nodes/local/security/images` | Security view on the Images tab |
@@ -23,6 +24,18 @@ Sencho encodes the active node, the view you are on, and the deep state that vie
Remote nodes use a slug derived from the node name and id (for example `/nodes/nas-box-42/dashboard`). The default local node keeps the short `local` slug.
## Stack detail vs compose editor
Clicking a stack in the sidebar opens **stack detail** at `/nodes/<node>/stacks/<stack>` (anatomy on the right). Opening the compose, env, or files editor appends that tab to the path:
- `/stacks/radarr` — detail
- `/stacks/radarr/compose` — compose.yaml editor
- `/stacks/radarr/env` — env editor
- `/stacks/radarr/files` — file browser (desktop)
Closing the Monaco editor returns you to the detail URL for that stack.
## Env tab URLs
Sencho encodes env file selection in the `?env=` query on the Env tab only:
@@ -48,7 +61,7 @@ If a link points at a stack that cannot be loaded (for example the node is offli
## Back, Forward, and refresh
- **Back / Forward** walk through the views you opened in order, including stack editor tabs where applicable.
- **Refresh** reloads the current URL and restores the same node, view, stack, and tab when the underlying data is available.
- **Refresh** reloads the current URL and restores the same node, view, stack, and surface (detail vs compose/env/files editor) when the underlying data is available.
- **Unsaved edits** still block navigation. Sencho prompts before you leave a dirty compose or env buffer via Back, a sidebar link, or another stack.
## Phone layout