From e1d07bd456e93590e4d9544791b793943f3e2630 Mon Sep 17 00:00:00 2001
From: roboloop <12248453+roboloop@users.noreply.github.com>
Date: Thu, 27 Aug 2026 23:52:07 +0000
Subject: [PATCH] Link each provider card to that platform's own broadcast
 console

The card shows a platform's live state but offered no way to reach the
platform's own dashboard. Each fetchStatus now returns a dashboardUrl
alongside the display fields, rendered as a DASHBOARD link in the card's
actions row while connected.

The url is built in the Worker because it is keyed by a slug, not the
display name: Twitch's is the login (display_name lowercased is only
coincidentally the same, and diverges for non-Latin display names), and
VK's is the channel url that fetchStatus already resolves. Kick's console
takes the channel from the session, so its url is a constant.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01737mSEpLksb7XbfNK2pn6j
---
 src/components/ProviderCard.vue           | 17 ++++++++++++++++
 src/shared/types.ts                       |  5 +++++
 src/views/__tests__/DashboardView.spec.ts | 20 +++++++++++++++++++
 src/worker/__tests__/providers.spec.ts    | 24 ++++++++++++++++++++---
 src/worker/index.ts                       |  1 +
 src/worker/providers/kick.ts              |  3 +++
 src/worker/providers/twitch.ts            |  3 +++
 src/worker/providers/types.ts             |  6 ++++++
 src/worker/providers/vkvideo.ts           | 10 +++++++++-
 src/worker/status.ts                      |  3 +++
 10 files changed, 88 insertions(+), 4 deletions(-)

diff --git a/src/components/ProviderCard.vue b/src/components/ProviderCard.vue
index 534fa18..8014c5d 100644
--- a/src/components/ProviderCard.vue
+++ b/src/components/ProviderCard.vue
@@ -48,6 +48,15 @@ const PLATFORM_COLORS: Record<ProviderId, string> = {
         CONNECT
       </a>
       <template v-else>
+        <a
+          v-if="provider.dashboardUrl"
+          class="action dashboard"
+          :href="provider.dashboardUrl"
+          target="_blank"
+          rel="noopener"
+        >
+          DASHBOARD ↗
+        </a>
         <a
           v-if="provider.needsReauth"
           class="action connect"
@@ -185,6 +194,14 @@ const PLATFORM_COLORS: Record<ProviderId, string> = {
   color: var(--accent-hover);
 }
 
+.action.dashboard {
+  color: var(--text-dim);
+}
+
+.action.dashboard:hover {
+  color: var(--accent);
+}
+
 .action.disconnect {
   color: var(--text-dim);
 }
diff --git a/src/shared/types.ts b/src/shared/types.ts
index c0ced4e..e2b70d0 100644
--- a/src/shared/types.ts
+++ b/src/shared/types.ts
@@ -41,6 +41,11 @@ export interface ProviderState {
   isLive: boolean
   /** Category / game, where the platform exposes one. */
   category: Category | null
+  /**
+   * Deep link to the platform's own broadcast console. Null when disconnected,
+   * or when the platform keys the URL by a channel the account does not have.
+   */
+  dashboardUrl: string | null
   /**
    * Connected, but the stored token predates the write scopes — saves would
    * fail until the user reconnects.
diff --git a/src/views/__tests__/DashboardView.spec.ts b/src/views/__tests__/DashboardView.spec.ts
index 19a699f..73985b4 100644
--- a/src/views/__tests__/DashboardView.spec.ts
+++ b/src/views/__tests__/DashboardView.spec.ts
@@ -14,6 +14,7 @@ function providerState(overrides: Partial<ProviderState> = {}): ProviderState {
     streamTitle: null,
     isLive: false,
     category: null,
+    dashboardUrl: null,
     needsReauth: false,
     error: null,
     ...overrides,
@@ -91,6 +92,25 @@ describe('DashboardView', () => {
     expect(wrapper.find('a[href="/auth/twitch/start"]').exists()).toBe(false)
   })
 
+  it('links a connected card to that platform’s own console', async () => {
+    stubApi([
+      providerState({
+        connected: true,
+        displayName: 'Streamer',
+        dashboardUrl: 'https://dashboard.twitch.tv/u/streamer_tv/stream-manager',
+      }),
+      providerState({ id: 'kick', label: 'Kick', connected: true }),
+    ])
+    const wrapper = await mountView()
+
+    const link = wrapper.get('a.dashboard')
+    expect(link.attributes('href')).toBe('https://dashboard.twitch.tv/u/streamer_tv/stream-manager')
+    expect(link.attributes('target')).toBe('_blank')
+    expect(link.text()).toContain('DASHBOARD')
+    // A platform that reported no url — like Kick here — offers no link.
+    expect(wrapper.findAll('a.dashboard')).toHaveLength(1)
+  })
+
   it('pre-fills the title input with the current shared title', async () => {
     stubApi([providerState({ connected: true, streamTitle: 'Current title' })])
     const wrapper = await mountView()
diff --git a/src/worker/__tests__/providers.spec.ts b/src/worker/__tests__/providers.spec.ts
index 1d80c94..5ce26e4 100644
--- a/src/worker/__tests__/providers.spec.ts
+++ b/src/worker/__tests__/providers.spec.ts
@@ -42,7 +42,11 @@ function routeFetch(routes: Record<string, unknown>) {
 describe('twitch fetchStatus', () => {
   it('reads the title from the channel and liveness from /streams', async () => {
     routeFetch({
-      'https://api.twitch.tv/helix/users': { data: [{ id: '42', display_name: 'Streamer' }] },
+      'https://api.twitch.tv/helix/users': {
+        // The login is deliberately not the display name lowercased: the
+        // dashboard url must follow the login.
+        data: [{ id: '42', display_name: 'Streamer', login: 'streamer_tv' }],
+      },
       'https://api.twitch.tv/helix/channels': {
         data: [
           {
@@ -66,12 +70,17 @@ describe('twitch fetchStatus', () => {
       streamTitle: 'Playing something',
       isLive: true,
       category: { id: '743', name: 'Chess', imageUrl: 'https://img/68x90.jpg' },
+      dashboardUrl: 'https://dashboard.twitch.tv/u/streamer_tv/stream-manager',
     })
   })
 
   it('reports offline when /streams returns nothing', async () => {
     routeFetch({
-      'https://api.twitch.tv/helix/users': { data: [{ id: '42', display_name: 'Streamer' }] },
+      'https://api.twitch.tv/helix/users': {
+        // The login is deliberately not the display name lowercased: the
+        // dashboard url must follow the login.
+        data: [{ id: '42', display_name: 'Streamer', login: 'streamer_tv' }],
+      },
       'https://api.twitch.tv/helix/channels': {
         data: [{ title: 'Offline title', game_id: '', game_name: '' }],
       },
@@ -117,7 +126,11 @@ describe('twitch categories and updates', () => {
 
   it('PATCHes the channel keyed by the token holder’s own id', async () => {
     const calls = routeFetch({
-      'https://api.twitch.tv/helix/users': { data: [{ id: '42', display_name: 'Streamer' }] },
+      'https://api.twitch.tv/helix/users': {
+        // The login is deliberately not the display name lowercased: the
+        // dashboard url must follow the login.
+        data: [{ id: '42', display_name: 'Streamer', login: 'streamer_tv' }],
+      },
       'https://api.twitch.tv/helix/channels': {},
     })
 
@@ -155,6 +168,7 @@ describe('kick fetchStatus', () => {
       streamTitle: 'Kick stream',
       isLive: true,
       category: { id: '5', name: 'Just Chatting', imageUrl: 'https://thumb.jpg' },
+      dashboardUrl: 'https://dashboard.kick.com/stream',
     })
   })
 
@@ -243,6 +257,8 @@ describe('vkvideo fetchStatus', () => {
       streamTitle: 'VK stream',
       isLive: true,
       category: { id: 'g1', name: 'Games', imageUrl: 'https://cover.jpg', kind: 'game' },
+      // Keyed by the channel url, not the nick.
+      dashboardUrl: 'https://live.vkvideo.ru/my-channel/studio',
     })
   })
 
@@ -273,6 +289,8 @@ describe('vkvideo fetchStatus', () => {
       streamTitle: null,
       isLive: false,
       category: null,
+      // No channel means no studio to link to.
+      dashboardUrl: null,
     })
   })
 
diff --git a/src/worker/index.ts b/src/worker/index.ts
index 948fb3f..d05de31 100644
--- a/src/worker/index.ts
+++ b/src/worker/index.ts
@@ -138,6 +138,7 @@ app.get('/api/me', async (c) => {
         streamTitle: null,
         isLive: false,
         category: null,
+        dashboardUrl: null,
         needsReauth: false,
         error: null,
       })),
diff --git a/src/worker/providers/kick.ts b/src/worker/providers/kick.ts
index 295a352..e2e94f9 100644
--- a/src/worker/providers/kick.ts
+++ b/src/worker/providers/kick.ts
@@ -62,6 +62,9 @@ export const kick: Provider = {
             imageUrl: channel.category.thumbnail || null,
           }
         : null,
+      // Kick's console resolves the channel from the session, so the URL is
+      // the same for every account.
+      dashboardUrl: 'https://dashboard.kick.com/stream',
     }
   },
 
diff --git a/src/worker/providers/twitch.ts b/src/worker/providers/twitch.ts
index 1465787..10568bf 100644
--- a/src/worker/providers/twitch.ts
+++ b/src/worker/providers/twitch.ts
@@ -6,6 +6,8 @@ import type { Provider, ProviderStatus, StreamPatch } from './types'
 interface TwitchUser {
   id: string
   display_name: string
+  /** The URL-safe channel name. Not always `display_name` lowercased. */
+  login: string
 }
 
 interface TwitchChannel {
@@ -93,6 +95,7 @@ export const twitch: Provider = {
       // /streams returns an entry only while actually broadcasting.
       isLive: stream !== null,
       category,
+      dashboardUrl: `https://dashboard.twitch.tv/u/${encodeURIComponent(user.login)}/stream-manager`,
     }
   },
 
diff --git a/src/worker/providers/types.ts b/src/worker/providers/types.ts
index 45c1d8a..a876d91 100644
--- a/src/worker/providers/types.ts
+++ b/src/worker/providers/types.ts
@@ -7,6 +7,12 @@ export interface ProviderStatus {
   streamTitle: string | null
   isLive: boolean
   category: Category | null
+  /**
+   * The platform's own broadcast console. Built here rather than in the browser
+   * because the URL is keyed by a slug (Twitch's `login`, VK's channel url),
+   * which is not the same string as `displayName`.
+   */
+  dashboardUrl: string | null
 }
 
 /**
diff --git a/src/worker/providers/vkvideo.ts b/src/worker/providers/vkvideo.ts
index 3e7c2c8..f02d8ac 100644
--- a/src/worker/providers/vkvideo.ts
+++ b/src/worker/providers/vkvideo.ts
@@ -74,7 +74,13 @@ export const vkvideo: Provider = {
     if (!channelUrl) {
       // A VK account that has never streamed has no channel. That is a valid
       // state, not an error — report the identity and leave the title empty.
-      return { displayName: nick, streamTitle: null, isLive: false, category: null }
+      return {
+        displayName: nick,
+        streamTitle: null,
+        isLive: false,
+        category: null,
+        dashboardUrl: null,
+      }
     }
 
     const channel = await vkGet<VkChannel>(
@@ -88,6 +94,8 @@ export const vkvideo: Provider = {
       streamTitle: stream?.title || null,
       isLive: stream?.status === 'started',
       category: toCategory(stream?.category),
+      // The studio path takes the channel url, not the nick shown on the card.
+      dashboardUrl: `https://live.vkvideo.ru/${encodeURIComponent(channelUrl)}/studio`,
     }
   },
 
diff --git a/src/worker/status.ts b/src/worker/status.ts
index ad95882..be59b41 100644
--- a/src/worker/status.ts
+++ b/src/worker/status.ts
@@ -135,6 +135,7 @@ export async function resolveProvider(
             streamTitle: null,
             isLive: false,
             category: null,
+            dashboardUrl: null,
           }),
           needsReauth,
           error: call.error,
@@ -181,6 +182,7 @@ function disconnected(provider: Provider, error: string | null = null): Resolved
       streamTitle: null,
       isLive: false,
       category: null,
+      dashboardUrl: null,
       needsReauth: false,
       error,
     },
@@ -198,6 +200,7 @@ function connected(provider: Provider, status: ProviderStatus): ProviderState {
     streamTitle: status.streamTitle,
     isLive: status.isLive,
     category: status.category,
+    dashboardUrl: status.dashboardUrl,
     needsReauth: false,
     error: null,
   }