feat: add deployments route

[jog1t]

Description

Please include a summary of the changes and the related issue. Please also include relevant motivation and context.

Type of change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• This change requires a documentation update

How Has This Been Tested?

Please describe the tests that you ran to verify your changes.

Checklist:

• My code follows the style guidelines of this project
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes

[jog1t]

This change is part of the following stack:

• fix: new project flow incorrect redirect #4341
  • fix: docs-button #4342
    • fix: runner configs being outdated when editing again #4343
      • fix: modals being stuck opaque on firefox #4344
        • feat(frontend): add additional debug information when actor inspector fails to load #4346
          • feat: add deployments route #4357 ◀

_{Change managed by git-spice.}

[railway-app]

🚅 Deployed to the rivet-pr-4357 environment in rivet-frontend

Service	Status	Web	Updated (UTC)
frontend-cloud	✅ Success (View Logs)	Web	Mar 13, 2026 at 6:55 pm
website	😴 Sleeping (View Logs)	Web	Mar 13, 2026 at 6:54 pm
frontend-inspector	✅ Success (View Logs)	Web	Mar 13, 2026 at 6:53 pm
ladle	❌ Build Failed (View Logs)	Web	Mar 13, 2026 at 6:52 pm
mcp-hub	✅ Success (View Logs)	Web	Mar 4, 2026 at 11:02 pm

[claude]

PR Review: feat: add deployments route

This PR adds a deployments route to the Rivet Cloud dashboard, including managed pool support, Docker image browsing, deployment logs streaming, a Rivet Cloud onboarding flow, and several stepper form improvements. The overall approach is sound, but there are a few issues worth addressing.

---

Bugs

Inverted validation condition in upsert-deployment-form.tsx: The superRefine check has the condition backwards. It reports an error when both repository and tag are present, which is the valid case. The correct condition should be if (data.image.repository AND NOT data.image.tag). As written, this will prevent users from ever submitting a valid image selection.

Debug console.log left in production code: frontend/src/app/forms/upsert-deployment-form.tsx has console.log(data) inside the superRefine validator and should be removed before merge.

---

Security Concern

API token creation via a query: In connect-rivet-frame.tsx and getting-started.tsx, createApiTokenQueryOptions uses queryOptions with staleTime: Infinity but token creation is a mutation (POST), not a GET. This should be a useMutation triggered by explicit user action. Additionally the token is shown without masking - consider masking by default with a reveal toggle.

---

Code Quality

DeploymentCheck form context: deployment-check.tsx calls useController internally without an explicit FormProvider. If rendered outside react-hook-form context it will throw.

Duplicate PoolStatus: Defined independently in both deployment-check.tsx and connect-rivet-frame.tsx. Extract to a shared component.

getValues() in render: Called during render in stepper-form.tsx to compute visibleSteps. Does not subscribe to updates - use useWatch instead.

DeploymentsLink missing Suspense: CloudSidebarContentInner renders DeploymentsLink which calls useSuspenseQuery without a wrapping Suspense boundary.

Font change bundled: Switching from Manrope to Open Sans affects the entire dashboard. Hard to isolate and revert independently.

---

Minor Issues

displayBackendOnboarding logic appears inverted when pool is ready. Indentation in data.ts uses 4-space instead of tabs. Missing trailing newline in frontend/src/lib/data.ts. Extra blank line in use-dialog.tsx at line 267. maxPages: Infinity on polling queries will eagerly fetch all pages on every poll interval.

---

Summary

Severity	Issue
Bug	Inverted tag-required validation in upsert-deployment-form.tsx
Debug	console.log left in production code
Security	Token creation as a query; token shown without masking
Logic	displayBackendOnboarding condition appears inverted
Rendering	getValues() in render does not react to form value changes
Suspense	DeploymentsLink missing Suspense boundary in sidebar
Quality	Duplicate PoolStatus components; implicit form context dependency
Style	4-space indentation in data.ts; missing trailing newline

Generated with Claude Code

[pkg-pr-new]

More templates

• actor-actions
• actor-actions-vercel
• ai-agent
• ai-agent-vercel
• example-ai-and-user-generated-actors-freestyle
• chat-room
• chat-room-vercel
• example-cloudflare-workers
• example-cloudflare-workers-hono
• collaborative-document
• collaborative-document-vercel
• cross-actor-actions
• cross-actor-actions-vercel
• example-cursors
• example-cursors-raw-websocket
• example-cursors-raw-websocket-vercel
• example-cursors-vercel
• custom-serverless
• example-elysia
• example-experimental-durable-streams-ai-agent
• example-experimental-durable-streams-ai-agent-vercel
• geo-distributed-database
• geo-distributed-database-vercel
• hello-world
• hello-world-vercel
• example-hono
• hono-react
• hono-react-vercel
• example-kitchen-sink
• example-kitchen-sink-vercel
• multi-region-vercel
• multiplayer-game
• example-multiplayer-game-patterns
• example-multiplayer-game-patterns-vercel
• multiplayer-game-vercel
• native-websockets
• native-websockets-vercel
• next-js
• per-tenant-database
• per-tenant-database-vercel
• example-raw-fetch-handler
• example-raw-fetch-handler-vercel
• example-raw-websocket-handler
• example-raw-websocket-handler-proxy
• example-raw-websocket-handler-proxy-vercel
• example-raw-websocket-handler-vercel
• example-react
• example-react-vercel
• sandbox
• sandbox-coding-agent
• sandbox-coding-agent-vercel
• sandbox-vercel
• scheduling
• scheduling-vercel
• example-sqlite-drizzle
• example-sqlite-raw
• state
• state-vercel
• example-stream
• example-stream-vercel
• example-trpc

@rivetkit/cloudflare-workers

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/cloudflare-workers@4357

@rivetkit/framework-base

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/framework-base@4357

@rivetkit/next-js

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/next-js@4357

@rivetkit/react

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/react@4357

rivetkit

pnpm add https://pkg.pr.new/rivet-dev/rivet/rivetkit@4357

@rivetkit/sql-loader

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sql-loader@4357

@rivetkit/sqlite-vfs

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/sqlite-vfs@4357

@rivetkit/traces

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/traces@4357

@rivetkit/workflow-engine

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/workflow-engine@4357

@rivetkit/virtual-websocket

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/virtual-websocket@4357

@rivetkit/engine-runner

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner@4357

@rivetkit/engine-runner-protocol

pnpm add https://pkg.pr.new/rivet-dev/rivet/@rivetkit/engine-runner-protocol@4357

commit: f28c507