Skip to content

Take control over your live stream video by running it yourself. Streaming + chat out of the box.

test(web): add storybook render smoke stories for all admin pages

Gabe Kangasc056ec2001eb
diff --git a/web/.storybook/main.js b/web/.storybook/main.js
index 58141e71fa..5996199a79 100644
--- a/web/.storybook/main.js
+++ b/web/.storybook/main.js
@@ -3,6 +3,16 @@ module.exports = {
previewMdx2: true,
},
+ // Admin components build their API URLs from NEXT_PUBLIC_API_HOST
+ // (utils/apis.ts). Next.js loads it from .env.development/.env.production,
+ // but Storybook does not, leaving it undefined and producing fetches to
+ // "/undefinedapi/admin/...". Default it to "/" so admin page stories fetch
+ // "/api/admin/..." and per-story msw handlers can intercept them.
+ env: config => ({
+ ...config,
+ NEXT_PUBLIC_API_HOST: config.NEXT_PUBLIC_API_HOST || '/',
+ }),
+
stories: [
'../.storybook/stories-category-doc-pages/**/*.@(mdx|stories.js)',
'../stories/**/*.stories.@(js|jsx|ts|tsx)',
diff --git a/web/components/admin/MainLayout.stories.tsx b/web/components/admin/MainLayout.stories.tsx
new file mode 100644
index 0000000000..27441d7f8b
--- /dev/null
+++ b/web/components/admin/MainLayout.stories.tsx
@@ -0,0 +1,64 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import { MainLayout } from './MainLayout';
+import { ServerStatusContext } from '../../utils/server-status-context';
+
+// The admin chrome itself: sider menu, header with stream title editor and
+// status indicator, footer. Whole-page smoke stories render without the
+// layout, so this is the only story that covers admin navigation.
+//
+// The Consumer-inside-Provider trick reuses the context's built-in default
+// value as the fixture base without exporting the initial state objects.
+const placeholderContent = (
+ <div style={{ padding: '24px' }}>
+ <h1>Page content</h1>
+ <p>The active admin page renders here.</p>
+ </div>
+);
+
+const OnlineFixture = () => (
+ <ServerStatusContext.Consumer>
+ {defaults => (
+ <ServerStatusContext.Provider
+ value={{
+ ...defaults,
+ online: true,
+ viewerCount: 12,
+ serverConfig: {
+ ...defaults.serverConfig,
+ instanceDetails: {
+ ...defaults.serverConfig.instanceDetails,
+ name: 'Demo stream',
+ streamTitle: 'Weekly community show',
+ },
+ federation: {
+ ...defaults.serverConfig.federation,
+ enabled: true,
+ },
+ },
+ }}
+ >
+ <MainLayout>{placeholderContent}</MainLayout>
+ </ServerStatusContext.Provider>
+ )}
+ </ServerStatusContext.Consumer>
+);
+
+const meta = {
+ title: 'owncast/Admin/Main layout',
+ component: MainLayout,
+} satisfies Meta<typeof MainLayout>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// Default context: offline server, empty config.
+export const Offline: Story = {
+ args: { children: placeholderContent },
+};
+
+// Online with federation enabled, which adds the Fediverse menu section and
+// the compose button.
+export const OnlineWithFederation: Story = {
+ args: { children: placeholderContent },
+ render: () => <OnlineFixture />,
+};
diff --git a/web/components/admin/VideoVariantForm.stories.tsx b/web/components/admin/VideoVariantForm.stories.tsx
new file mode 100644
index 0000000000..54fb289eed
--- /dev/null
+++ b/web/components/admin/VideoVariantForm.stories.tsx
@@ -0,0 +1,30 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import { VideoVariantForm } from './VideoVariantForm';
+import { DEFAULT_VARIANT_STATE } from '../../utils/config-constants';
+
+// The densest form in the admin: sliders with marks and tooltips, collapse
+// panels, toggle switches, numeric text fields and a Popconfirm. If any of
+// these widgets render broken, stream output configuration is broken, so
+// this form gets its own visual baseline.
+const meta = {
+ title: 'owncast/Admin/Video variant form',
+ component: VideoVariantForm,
+} satisfies Meta<typeof VideoVariantForm>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+ args: {
+ dataState: DEFAULT_VARIANT_STATE,
+ onUpdateField: () => null,
+ },
+};
+
+// Passthrough disables the quality controls and shows the warning state.
+export const VideoPassthroughEnabled: Story = {
+ args: {
+ dataState: { ...DEFAULT_VARIANT_STATE, videoPassthrough: true },
+ onUpdateField: () => null,
+ },
+};
diff --git a/web/components/ui/Content/ActionButtons.stories.tsx b/web/components/ui/Content/ActionButtons.stories.tsx
new file mode 100644
index 0000000000..979d12bfd1
--- /dev/null
+++ b/web/components/ui/Content/ActionButtons.stories.tsx
@@ -0,0 +1,40 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ActionButtons from './ActionButtons';
+
+// The viewer's action button row (external actions, follow, notify) is
+// config-gated inside the Main layout stories, so this story keeps it
+// unconditionally visible.
+const noop = () => {};
+
+const meta = {
+ title: 'owncast/Components/Action buttons row',
+ component: ActionButtons,
+} satisfies Meta<typeof ActionButtons>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {
+ args: {
+ supportFediverseFeatures: true,
+ supportsBrowserNotifications: true,
+ showNotifyReminder: false,
+ externalActions: [
+ {
+ title: 'Support the stream',
+ description: 'Buy a coffee',
+ url: 'https://example.com/support',
+ color: '#5232c8',
+ openExternally: true,
+ },
+ {
+ title: 'Merch',
+ url: 'https://example.com/merch',
+ },
+ ],
+ setShowFollowModal: noop,
+ setShowNotifyModal: noop,
+ disableNotifyReminderPopup: noop,
+ externalActionSelected: noop,
+ },
+};
diff --git a/web/stories/Feedback.stories.tsx b/web/stories/Feedback.stories.tsx
new file mode 100644
index 0000000000..a70d2a0f4a
--- /dev/null
+++ b/web/stories/Feedback.stories.tsx
@@ -0,0 +1,54 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import { Button, Modal, message, notification } from 'antd';
+
+// Exercises antd's imperative feedback surfaces (message toasts,
+// notifications, Modal.confirm) so they have a visual baseline. These render
+// outside the normal component tree, which is exactly the plumbing that
+// changes across antd major versions, so a story that shows them is the
+// cheapest regression net.
+const FeedbackDemo = () => (
+ <div style={{ height: '400px' }}>
+ <Button type="primary" onClick={() => message.success('Settings saved.', 0)}>
+ Show a message toast
+ </Button>
+ </div>
+);
+
+const sleep = (ms: number) => {
+ const { promise, resolve } = Promise.withResolvers<void>();
+ setTimeout(resolve, ms);
+ return promise;
+};
+
+const meta = {
+ title: 'owncast/Feedback',
+ component: FeedbackDemo,
+ parameters: {
+ chromatic: { delay: 1000 },
+ },
+} satisfies Meta<typeof FeedbackDemo>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+// Fire every imperative feedback type at once. Durations are 0 so nothing
+// auto-dismisses before the snapshot is taken.
+export const ToastsAndConfirm: Story = {
+ play: async () => {
+ message.success('Settings saved.', 0);
+ message.error('Unable to reach the server.', 0);
+ notification.open({
+ message: 'New follower',
+ description: '[email protected] followed your stream.',
+ duration: 0,
+ });
+ Modal.confirm({
+ title: 'Delete this stream key?',
+ content: 'Anyone using this key will no longer be able to stream.',
+ okText: 'Delete',
+ okType: 'danger',
+ });
+ // Let the open animations settle before any snapshot.
+ await sleep(500);
+ },
+};
diff --git a/web/stories/admin-pages/access-tokens.stories.tsx b/web/stories/admin-pages/access-tokens.stories.tsx
new file mode 100644
index 0000000000..d8d4f65af1
--- /dev/null
+++ b/web/stories/admin-pages/access-tokens.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import AccessTokens from '../../pages/admin/access-tokens';
+
+// Render smoke for the admin Access Tokens page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Access Tokens',
+ component: AccessTokens,
+} satisfies Meta<typeof AccessTokens>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/actions.stories.tsx b/web/stories/admin-pages/actions.stories.tsx
new file mode 100644
index 0000000000..0ef404d587
--- /dev/null
+++ b/web/stories/admin-pages/actions.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Actions from '../../pages/admin/actions';
+
+// Render smoke for the admin Actions page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Actions',
+ component: Actions,
+} satisfies Meta<typeof Actions>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/chat-emojis.stories.tsx b/web/stories/admin-pages/chat-emojis.stories.tsx
new file mode 100644
index 0000000000..39dea658b5
--- /dev/null
+++ b/web/stories/admin-pages/chat-emojis.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ChatEmojis from '../../pages/admin/chat/emojis';
+
+// Render smoke for the admin Chat Emojis page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Chat Emojis',
+ component: ChatEmojis,
+} satisfies Meta<typeof ChatEmojis>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/chat-messages.stories.tsx b/web/stories/admin-pages/chat-messages.stories.tsx
new file mode 100644
index 0000000000..9287860c78
--- /dev/null
+++ b/web/stories/admin-pages/chat-messages.stories.tsx
@@ -0,0 +1,84 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import { http, HttpResponse } from 'msw';
+import ChatMessages from '../../pages/admin/chat/messages';
+
+// The chat messages admin page is the only Table usage with row selection,
+// which is styling that regressed across antd versions before (selected rows
+// were invisible in Firefox with antd 5 defaults). WithSelection keeps a
+// visual baseline of the selected-row treatment.
+
+const user = (id: string, displayName: string, displayColor: number) => ({
+ id,
+ displayName,
+ displayColor,
+ createdAt: '2026-06-01T12:00:00Z',
+ previousNames: [displayName],
+ scopes: [],
+ isBot: false,
+ authenticated: false,
+});
+
+const messages = [
+ {
+ id: 'msg-1',
+ timestamp: '2026-07-01T18:00:00Z',
+ body: 'Hello everyone, stream starting soon!',
+ user: user('user-1', 'StreamerFan42', 1),
+ visible: true,
+ hiddenAt: null,
+ },
+ {
+ id: 'msg-2',
+ timestamp: '2026-07-01T18:01:30Z',
+ body: 'The audio is a little quiet on my end.',
+ user: user('user-2', 'NightOwl', 3),
+ visible: true,
+ hiddenAt: null,
+ },
+ {
+ id: 'msg-3',
+ timestamp: '2026-07-01T18:02:10Z',
+ body: 'This message was hidden by a moderator.',
+ user: user('user-3', 'SpamAccount', 5),
+ visible: false,
+ hiddenAt: '2026-07-01T18:03:00Z',
+ },
+];
+
+const sleep = (ms: number) => {
+ const { promise, resolve } = Promise.withResolvers<void>();
+ setTimeout(resolve, ms);
+ return promise;
+};
+
+const meta = {
+ title: 'owncast/Admin/Pages/Chat Messages',
+ component: ChatMessages,
+ parameters: {
+ msw: {
+ handlers: [http.get('*/api/admin/chat/messages', () => HttpResponse.json(messages))],
+ },
+ },
+} satisfies Meta<typeof ChatMessages>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
+
+// Select the first row so the selected-row styling is part of the snapshot.
+export const WithSelection: Story = {
+ play: async ({ canvasElement }) => {
+ const deadline = Date.now() + 5000;
+ let checkbox: HTMLInputElement | null = null;
+ while (!checkbox && Date.now() < deadline) {
+ checkbox = canvasElement.querySelector('.ant-table-tbody input[type="checkbox"]');
+ if (!checkbox) {
+ // eslint-disable-next-line no-await-in-loop
+ await sleep(100);
+ }
+ }
+ checkbox?.click();
+ await sleep(200);
+ },
+};
diff --git a/web/stories/admin-pages/config-chat.stories.tsx b/web/stories/admin-pages/config-chat.stories.tsx
new file mode 100644
index 0000000000..6276d8a03e
--- /dev/null
+++ b/web/stories/admin-pages/config-chat.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigChat from '../../pages/admin/config-chat';
+
+// Render smoke for the admin Config Chat page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Chat',
+ component: ConfigChat,
+} satisfies Meta<typeof ConfigChat>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-featured.stories.tsx b/web/stories/admin-pages/config-featured.stories.tsx
new file mode 100644
index 0000000000..00deb5dacf
--- /dev/null
+++ b/web/stories/admin-pages/config-featured.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigFeatured from '../../pages/admin/config-featured';
+
+// Render smoke for the admin Config Featured Streams page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Featured Streams',
+ component: ConfigFeatured,
+} satisfies Meta<typeof ConfigFeatured>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-general.stories.tsx b/web/stories/admin-pages/config-general.stories.tsx
new file mode 100644
index 0000000000..dada8ab31c
--- /dev/null
+++ b/web/stories/admin-pages/config-general.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigGeneral from '../../pages/admin/config/general';
+
+// Render smoke for the admin Config General page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config General',
+ component: ConfigGeneral,
+} satisfies Meta<typeof ConfigGeneral>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-notify.stories.tsx b/web/stories/admin-pages/config-notify.stories.tsx
new file mode 100644
index 0000000000..8c1c24e43e
--- /dev/null
+++ b/web/stories/admin-pages/config-notify.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigNotify from '../../pages/admin/config-notify';
+
+// Render smoke for the admin Config Notifications page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Notifications',
+ component: ConfigNotify,
+} satisfies Meta<typeof ConfigNotify>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-server.stories.tsx b/web/stories/admin-pages/config-server.stories.tsx
new file mode 100644
index 0000000000..2b1c03cbbb
--- /dev/null
+++ b/web/stories/admin-pages/config-server.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigServer from '../../pages/admin/config/server';
+
+// Render smoke for the admin Config Server page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Server',
+ component: ConfigServer,
+} satisfies Meta<typeof ConfigServer>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-social-items.stories.tsx b/web/stories/admin-pages/config-social-items.stories.tsx
new file mode 100644
index 0000000000..7c8ea858cc
--- /dev/null
+++ b/web/stories/admin-pages/config-social-items.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigSocialItems from '../../pages/admin/config-social-items';
+
+// Render smoke for the admin Config Social Items page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Social Items',
+ component: ConfigSocialItems,
+} satisfies Meta<typeof ConfigSocialItems>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/config-video.stories.tsx b/web/stories/admin-pages/config-video.stories.tsx
new file mode 100644
index 0000000000..f5e13d3c7a
--- /dev/null
+++ b/web/stories/admin-pages/config-video.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ConfigVideo from '../../pages/admin/config-video';
+
+// Render smoke for the admin Config Video page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Config Video',
+ component: ConfigVideo,
+} satisfies Meta<typeof ConfigVideo>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/federation-actions.stories.tsx b/web/stories/admin-pages/federation-actions.stories.tsx
new file mode 100644
index 0000000000..90e70b6bc9
--- /dev/null
+++ b/web/stories/admin-pages/federation-actions.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import FederationActions from '../../pages/admin/federation/actions';
+
+// Render smoke for the admin Federation Actions page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Federation Actions',
+ component: FederationActions,
+} satisfies Meta<typeof FederationActions>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/federation-followers.stories.tsx b/web/stories/admin-pages/federation-followers.stories.tsx
new file mode 100644
index 0000000000..b7696408c5
--- /dev/null
+++ b/web/stories/admin-pages/federation-followers.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import FederationFollowers from '../../pages/admin/federation/followers';
+
+// Render smoke for the admin Federation Followers page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Federation Followers',
+ component: FederationFollowers,
+} satisfies Meta<typeof FederationFollowers>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/hardware-info.stories.tsx b/web/stories/admin-pages/hardware-info.stories.tsx
new file mode 100644
index 0000000000..61ccee4492
--- /dev/null
+++ b/web/stories/admin-pages/hardware-info.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import HardwareInfo from '../../pages/admin/hardware-info';
+
+// Render smoke for the admin Hardware Info page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Hardware Info',
+ component: HardwareInfo,
+} satisfies Meta<typeof HardwareInfo>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/help.stories.tsx b/web/stories/admin-pages/help.stories.tsx
new file mode 100644
index 0000000000..af8193978b
--- /dev/null
+++ b/web/stories/admin-pages/help.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Help from '../../pages/admin/help';
+
+// Render smoke for the admin Help page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Help',
+ component: Help,
+} satisfies Meta<typeof Help>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/index.stories.tsx b/web/stories/admin-pages/index.stories.tsx
new file mode 100644
index 0000000000..50ecdff430
--- /dev/null
+++ b/web/stories/admin-pages/index.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import AdminHome from '../../pages/admin/index';
+
+// Render smoke for the admin Home page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Home',
+ component: AdminHome,
+} satisfies Meta<typeof AdminHome>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/logs.stories.tsx b/web/stories/admin-pages/logs.stories.tsx
new file mode 100644
index 0000000000..1ab087948a
--- /dev/null
+++ b/web/stories/admin-pages/logs.stories.tsx
@@ -0,0 +1,40 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import { http, HttpResponse } from 'msw';
+import Logs from '../../pages/admin/logs';
+
+// Render smoke for the admin Logs page. The page renders nothing at all
+// without log data (LogTable returns null when empty), so the story feeds a
+// few entries through msw to make the table, level tags and pagination
+// visible.
+const logs = [
+ {
+ level: 'info',
+ time: '2026-07-01T18:00:00Z',
+ message: 'Owncast v0.2.0 started. Web server is listening on port 8080.',
+ },
+ {
+ level: 'warning',
+ time: '2026-07-01T18:05:12Z',
+ message: 'The stream is using a video codec that some devices may not support.',
+ },
+ {
+ level: 'error',
+ time: '2026-07-01T18:07:45Z',
+ message: 'Unable to connect to the directory at https://directory.owncast.online.',
+ },
+];
+
+const meta = {
+ title: 'owncast/Admin/Pages/Logs',
+ component: Logs,
+ parameters: {
+ msw: {
+ handlers: [http.get('*/api/admin/logs', () => HttpResponse.json(logs))],
+ },
+ },
+} satisfies Meta<typeof Logs>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/plugins-configure.stories.tsx b/web/stories/admin-pages/plugins-configure.stories.tsx
new file mode 100644
index 0000000000..08f46f5114
--- /dev/null
+++ b/web/stories/admin-pages/plugins-configure.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import PluginConfigure from '../../pages/admin/plugins/configure';
+
+// Render smoke for the admin Plugin Configure page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Plugin Configure',
+ component: PluginConfigure,
+} satisfies Meta<typeof PluginConfigure>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/plugins.stories.tsx b/web/stories/admin-pages/plugins.stories.tsx
new file mode 100644
index 0000000000..5841b48671
--- /dev/null
+++ b/web/stories/admin-pages/plugins.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Plugins from '../../pages/admin/plugins';
+
+// Render smoke for the admin Plugins page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Plugins',
+ component: Plugins,
+} satisfies Meta<typeof Plugins>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/stream-health.stories.tsx b/web/stories/admin-pages/stream-health.stories.tsx
new file mode 100644
index 0000000000..60306f78cc
--- /dev/null
+++ b/web/stories/admin-pages/stream-health.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import StreamHealth from '../../pages/admin/stream-health';
+
+// Render smoke for the admin Stream Health page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Stream Health',
+ component: StreamHealth,
+} satisfies Meta<typeof StreamHealth>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/upgrade.stories.tsx b/web/stories/admin-pages/upgrade.stories.tsx
new file mode 100644
index 0000000000..aad8e8bf3f
--- /dev/null
+++ b/web/stories/admin-pages/upgrade.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Upgrade from '../../pages/admin/upgrade';
+
+// Render smoke for the admin Upgrade page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Upgrade',
+ component: Upgrade,
+} satisfies Meta<typeof Upgrade>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/users.stories.tsx b/web/stories/admin-pages/users.stories.tsx
new file mode 100644
index 0000000000..c07fcc02f8
--- /dev/null
+++ b/web/stories/admin-pages/users.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Users from '../../pages/admin/users';
+
+// Render smoke for the admin Users page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Users',
+ component: Users,
+} satisfies Meta<typeof Users>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/viewer-info.stories.tsx b/web/stories/admin-pages/viewer-info.stories.tsx
new file mode 100644
index 0000000000..df5f180ce7
--- /dev/null
+++ b/web/stories/admin-pages/viewer-info.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import ViewerInfo from '../../pages/admin/viewer-info';
+
+// Render smoke for the admin Viewer Info page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Viewer Info',
+ component: ViewerInfo,
+} satisfies Meta<typeof ViewerInfo>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};
diff --git a/web/stories/admin-pages/webhooks.stories.tsx b/web/stories/admin-pages/webhooks.stories.tsx
new file mode 100644
index 0000000000..db384e030f
--- /dev/null
+++ b/web/stories/admin-pages/webhooks.stories.tsx
@@ -0,0 +1,15 @@
+import { Meta, StoryObj } from '@storybook/nextjs';
+import Webhooks from '../../pages/admin/webhooks';
+
+// Render smoke for the admin Webhooks page: a story that throws fails the
+// Storybook build, catching page-level breakage on every PR. Renders with
+// default (empty) server config context, no backend.
+const meta = {
+ title: 'owncast/Admin/Pages/Webhooks',
+ component: Webhooks,
+} satisfies Meta<typeof Webhooks>;
+
+export default meta;
+type Story = StoryObj<typeof meta>;
+
+export const Default: Story = {};