feat: branch deployment previews via `@branch` path segments by ericpgreen2 · Pull Request #9011 · rilldata/rill

ericpgreen2 · 2026-03-10T17:50:44Z

Adds the ability for project admins to preview branch deployments in Rill Cloud. Branches are addressed via @branch path segments in the URL (e.g., /acme/analytics/@eric~revenue-metrics/explore/dashboard). Navigating between pages preserves the active branch, and stopped deployments show a "Start deployment" button with optimistic UI updates.

Also adds a Deployments management page under Project Status with start/stop/delete actions, slot usage, and author info.

Closes APP-776

Implementation highlights:

A SvelteKit reroute hook strips @branch before route matching, so existing routes work transparently
Branch names containing / are encoded as ~ (which git disallows), making them safe for URL paths
createSmartRefetchInterval scopes polling to relevant resource types, preventing perpetual polling when ProjectParser stays RUNNING on branch deployments

Checklist:

Covered by tests
Ran it and it works as intended
Reviewed the diff before requesting a review
Checked for unhandled edge cases
Linked the issues it closes
Checked if the docs need to be updated. If so, create a separate Linear DOCS issue
Intend to cherry-pick into the release branch
I'm proud of this work!

Developed in collaboration with Claude Code

… utilities - Migrate `+layout.svelte` from Svelte 4 to Svelte 5 runes (`$derived`, `$effect`, `$props`) - Extract `baseGetProjectQueryOptions` polling config to `project-query-options.ts` - Extract `resolveRuntimeConnection` to `project-runtime.ts` with unit tests - Remove duplicate mock query chain from `ProjectHeader` (layout already passes mock-aware permissions) - Add section comments and component-level doc block to layout

- Delete `invalidations.ts` (dead code, zero consumers) - Delete `ResourceError.svelte` (dead code, shadowed by `web-common` version) - Move `constants.ts` to `user-management/constants.ts` (closer to its only consumer)

Replace three positional mock params (userId, credentials, permissions) with a single `mockUser` object. The caller constructs it or passes undefined, so the "all or nothing" relationship is enforced by the type system rather than a runtime check.

Remove `pageData`, `pathname`, and `projectError` — pure aliases that add indirection without simplifying anything. Use `page.data`, `page.url.pathname`, and `$projectQuery.error` directly.

@Branch

Branch deployment UI: - Add BranchSelector component in project header breadcrumbs - Extract branch from URL's @Branch path segment via `extractBranchFromPath` - Inject active branch into intra-project navigations via `handleBranchNavigation` - Pass branch param to GetProject and GetDeploymentCredentials queries - Add BranchDeploymentStopped component for stopped/stopping states - Keep BranchSelector's ListDeployments query in sync on status transitions - Poll during STOPPING status Deployments page: - Add Deployments management page under Status tab - Add `createSmartRefetchInterval` for filtered resource polling - Add branch deployment hint to Deployments page - Extract shared deployment utilities to `deployment-utils.ts`

When the user selects a branch in the dropdown, seed the GetProject query cache with the deployment data already available from ListDeployments. This lets the layout's RuntimeProvider re-key immediately instead of waiting for the network round-trip.

…oject cache" This reverts commit ad43959.

- Migrate to Svelte 5 runes ($props, $derived, $state) - Extract cache manipulation into deployment-actions.ts - Replace 4 tracking Sets with single pendingId string - Replace deletedIds with optimistic cache removal - Consolidate delete dialog state into single nullable object - Fix CopyableCodeBlock on:click -> onclick (Svelte 5) - Fix parseInt missing radix, redundant isProdDeployment call - Fix status overview showing "main" instead of deployment branch - Fix polling gap: keep polling when only ProjectParser exists during startup - Show loading spinner instead of "no dashboards" during initial build

Replace the static yellow dot with a `LoadingCircleOutline` spinner for in-progress states (Pending, Updating, Stopping, Deleting) in both the Deployments table and overview card.

When a branch deployment's runtime is running but the project failed to load (e.g., git branch doesn't exist), the overview page was misleadingly showing "Ready" with stale data. Now: - Deployment card shows parser error in a Callout, replacing project-level rows (Last synced, OLAP, AI) that would be defaults - Infrastructure status stays truthful (separate from project health) - Resources/Tables/Errors sections hidden when project failed to load - Download Project button disabled instead of hidden - ErrorsSection no longer has a confusing parent click handler

…add deployment-utils tests - Replace `TRANSIENT_STATUSES` Set with existing `isTransitoryStatus()` in `DeploymentsSection` - Use semantic `border-border` instead of `border-gray-200` on data rows - Use index fallback for `{#each}` key when `deployment.id` is undefined - Add `deduplicateDeployments` unit tests - Document web-admin vitest usage in CLAUDE.md

AdityaHegde

Adding 1st round of comments.

…nts` Restructure branch-utils tests to use shared test data array per reviewer suggestion. Remove `deduplicateDeployments` since the backend guards against duplicates at creation time (a DB constraint follow-up is needed for race conditions).

AdityaHegde

Apart from a couple nit this looks good. We can take the confirmation improvement separately based on requirement.

… branches alphabetically

ericpgreen2 self-assigned this Mar 10, 2026

ericpgreen2 changed the title ~~feat: branch deployment selector with @branch path segments~~ feat: branch deployment previews via @branch path segments Mar 11, 2026

ericpgreen2 mentioned this pull request Mar 13, 2026

Cloud editing MVP #8912

Open

8 tasks

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from 6543e45 to cb6a7cf Compare March 26, 2026 13:57

ericpgreen2 added 3 commits March 30, 2026 14:23

chore: clean up features/projects directory

5368c81

- Delete `invalidations.ts` (dead code, zero consumers) - Delete `ResourceError.svelte` (dead code, shadowed by `web-common` version) - Move `constants.ts` to `user-management/constants.ts` (closer to its only consumer)

fix: update remaining constants import paths after file move

fb407db

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from 724c618 to d13e3bf Compare March 30, 2026 12:12

ericpgreen2 changed the base branch from main to ericgreen/project-layout-refactor March 30, 2026 12:12

fix: update ResourceError import to use web-common version

a0f9672

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from d13e3bf to 8eddf35 Compare March 30, 2026 12:14

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from 8eddf35 to 2b26c7a Compare March 30, 2026 12:24

ericpgreen2 mentioned this pull request Mar 30, 2026

refactor: project layout Svelte 5 migration and cleanup #9140

Merged

8 tasks

ericpgreen2 added 2 commits March 30, 2026 15:44

refactor: remove unnecessary derived wrappers in project layout

3629e36

Remove `pageData`, `pathname`, and `projectError` — pure aliases that add indirection without simplifying anything. Use `page.data`, `page.url.pathname`, and `$projectQuery.error` directly.

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from 2b26c7a to 081ddb4 Compare March 30, 2026 12:44

ericpgreen2 added 2 commits March 30, 2026 16:00

Revert "fix: eliminate branch switch lag by optimistically seeding pr…

d9cb63f

…oject cache" This reverts commit ad43959.

Base automatically changed from ericgreen/project-layout-refactor to main March 31, 2026 07:02

ericpgreen2 added 5 commits April 1, 2026 17:14

Merge origin/main into ericgreen/branch-selector-ui

4009957

feat: show spinner for transitory deployment statuses

81ef06c

Replace the static yellow dot with a `LoadingCircleOutline` spinner for in-progress states (Pending, Updating, Stopping, Deleting) in both the Deployments table and overview card.

ericpgreen2 marked this pull request as ready for review April 2, 2026 14:03

ericpgreen2 requested a review from AdityaHegde April 2, 2026 14:03

fix: revert unrelated download-report.ts change from bad merge

ed92693

AdityaHegde requested changes Apr 6, 2026

View reviewed changes

ericpgreen2 requested a review from AdityaHegde April 9, 2026 11:30

ericpgreen2 force-pushed the ericgreen/branch-selector-ui branch from fdb951a to c2d0283 Compare April 9, 2026 11:33

AdityaHegde approved these changes Apr 10, 2026

View reviewed changes

fix: review feedback — rename mutateFn, extract delete dialog, sort…

0da6b83

… branches alphabetically

ericpgreen2 merged commit 3621a45 into main Apr 10, 2026
13 of 14 checks passed

ericpgreen2 deleted the ericgreen/branch-selector-ui branch April 10, 2026 07:56

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: branch deployment previews via `@branch` path segments#9011

feat: branch deployment previews via `@branch` path segments#9011
ericpgreen2 merged 17 commits intomainfrom
ericgreen/branch-selector-ui

ericpgreen2 commented Mar 10, 2026 •

edited

Loading

Uh oh!

AdityaHegde left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

AdityaHegde left a comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

ericpgreen2 commented Mar 10, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

AdityaHegde left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

AdityaHegde left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

ericpgreen2 commented Mar 10, 2026 •

edited

Loading