From 8be18b16bb5a6d4e08c381d58793e6f377c19dd6 Mon Sep 17 00:00:00 2001
From: Jeremy Ruppel <jeremy.ruppel@gmail.com>
Date: Wed, 6 May 2026 15:57:10 +0000
Subject: [PATCH] feat(site): add ModuleConfiguration and TemplateConfiguration
 components

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
---
 .../ModuleConfiguration.stories.tsx           | 230 ++++++++++++++++++
 .../TemplateBuilder/ModuleConfiguration.tsx   |  78 ++++++
 .../TemplateConfiguration.stories.tsx         | 105 ++++++++
 .../TemplateBuilder/TemplateConfiguration.tsx |  58 +++++
 4 files changed, 471 insertions(+)
 create mode 100644 site/src/pages/TemplateBuilder/ModuleConfiguration.stories.tsx
 create mode 100644 site/src/pages/TemplateBuilder/ModuleConfiguration.tsx
 create mode 100644 site/src/pages/TemplateBuilder/TemplateConfiguration.stories.tsx
 create mode 100644 site/src/pages/TemplateBuilder/TemplateConfiguration.tsx

diff --git a/site/src/pages/TemplateBuilder/ModuleConfiguration.stories.tsx b/site/src/pages/TemplateBuilder/ModuleConfiguration.stories.tsx
new file mode 100644
index 0000000000..abbf3fb96f
--- /dev/null
+++ b/site/src/pages/TemplateBuilder/ModuleConfiguration.stories.tsx
@@ -0,0 +1,230 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { fn } from "storybook/test";
+import { Input } from "#/components/Input/Input";
+import { Label } from "#/components/Label/Label";
+import { RadioGroup, RadioGroupItem } from "#/components/RadioGroup/RadioGroup";
+import {
+	Select,
+	SelectContent,
+	SelectItem,
+	SelectTrigger,
+	SelectValue,
+} from "#/components/Select/Select";
+import { Switch } from "#/components/Switch/Switch";
+import { ModuleConfiguration } from "./ModuleConfiguration";
+
+const meta: Meta<typeof ModuleConfiguration> = {
+	title: "pages/TemplateBuilder/ModuleConfiguration",
+	component: ModuleConfiguration,
+	args: {
+		onRemove: fn(),
+	},
+};
+
+export default meta;
+type Story = StoryObj<typeof ModuleConfiguration>;
+
+const TextInputField: React.FC<{
+	id: string;
+	label: string;
+	required?: boolean;
+	placeholder?: string;
+}> = ({ id, label, required, placeholder }) => (
+	<div className="flex flex-col gap-1 w-full">
+		<Label htmlFor={id} className="text-sm font-normal text-content-primary">
+			{label}
+			{required && " *"}
+		</Label>
+		<Input id={id} placeholder={placeholder} />
+	</div>
+);
+
+const RadioField: React.FC<{
+	label: string;
+	required?: boolean;
+	options: { value: string; label: string; iconUrl?: string }[];
+}> = ({ label, required, options }) => (
+	<div className="flex flex-col gap-1 w-full">
+		<Label className="text-sm font-normal text-content-primary">
+			{label}
+			{required && " *"}
+		</Label>
+		<RadioGroup className="gap-2">
+			{options.map((opt) => (
+				<div key={opt.value} className="flex items-start gap-2">
+					<div className="flex items-center py-1">
+						<RadioGroupItem id={`radio-${opt.value}`} value={opt.value} />
+					</div>
+					<Label
+						htmlFor={`radio-${opt.value}`}
+						className="flex items-center gap-1 text-sm font-normal text-content-primary leading-6"
+					>
+						{opt.iconUrl && (
+							<img src={opt.iconUrl} alt="" className="size-6 object-contain" />
+						)}
+						{opt.label}
+					</Label>
+				</div>
+			))}
+		</RadioGroup>
+	</div>
+);
+
+const SelectField: React.FC<{
+	id: string;
+	label: string;
+	optional?: boolean;
+	placeholder?: string;
+	options: { value: string; label: string }[];
+}> = ({ id, label, optional, placeholder, options }) => (
+	<div className="flex flex-col gap-1 w-full">
+		<Label htmlFor={id} className="text-sm font-normal text-content-primary">
+			{label}
+			{optional && <span className="text-content-secondary"> (optional)</span>}
+		</Label>
+		<Select>
+			<SelectTrigger id={id}>
+				<SelectValue placeholder={placeholder ?? "Select..."} />
+			</SelectTrigger>
+			<SelectContent>
+				{options.map((opt) => (
+					<SelectItem key={opt.value} value={opt.value}>
+						{opt.label}
+					</SelectItem>
+				))}
+			</SelectContent>
+		</Select>
+	</div>
+);
+
+const SwitchField: React.FC<{
+	id: string;
+	label: string;
+	defaultChecked?: boolean;
+}> = ({ id, label, defaultChecked }) => (
+	<div className="flex items-start gap-2">
+		<div className="p-0.5">
+			<Switch id={id} defaultChecked={defaultChecked} />
+		</div>
+		<Label
+			htmlFor={id}
+			className="text-sm font-normal text-content-primary leading-6"
+		>
+			{label}
+		</Label>
+	</div>
+);
+
+const SwitchGroupField: React.FC<{
+	label: string;
+	required?: boolean;
+	switches: { id: string; label: string; defaultChecked?: boolean }[];
+}> = ({ label, required, switches }) => (
+	<div className="flex flex-col gap-1 w-full">
+		<Label className="text-sm font-normal text-content-primary">
+			{label}
+			{required && " *"}
+		</Label>
+		<div className="flex flex-col gap-2">
+			{switches.map((s) => (
+				<SwitchField
+					key={s.id}
+					id={s.id}
+					label={s.label}
+					defaultChecked={s.defaultChecked}
+				/>
+			))}
+		</div>
+	</div>
+);
+
+export const Default: Story = {
+	args: {
+		name: "Claude Code",
+		description: "Run the Claude Code agent in your workspace.",
+		iconUrl: "/icon/claude.svg",
+		detailsUrl: "https://registry.coder.com/modules/claude-code",
+	},
+	render: (args) => (
+		<ModuleConfiguration {...args}>
+			<div className="flex flex-col gap-6">
+				<TextInputField
+					id="anthropic-api-key"
+					label="Anthropic API key"
+					required
+					placeholder="Enter API key"
+				/>
+				<RadioField
+					label="Other example"
+					required
+					options={[
+						{ value: "opt-1", label: "Radio text", iconUrl: "/icon/aws.svg" },
+						{ value: "opt-2", label: "Radio text", iconUrl: "/icon/aws.svg" },
+						{ value: "opt-3", label: "Radio text", iconUrl: "/icon/aws.svg" },
+						{ value: "opt-4", label: "Radio text", iconUrl: "/icon/aws.svg" },
+					]}
+				/>
+			</div>
+			<div className="flex flex-col gap-6">
+				<SelectField
+					id="one-more-example"
+					label="One more example"
+					optional
+					options={[
+						{ value: "a", label: "Option A" },
+						{ value: "b", label: "Option B" },
+						{ value: "c", label: "Option C" },
+					]}
+				/>
+				<SwitchGroupField
+					label="Other example"
+					required
+					switches={[
+						{ id: "switch-1", label: "Explaining text", defaultChecked: true },
+						{ id: "switch-2", label: "Explaining text", defaultChecked: false },
+					]}
+				/>
+			</div>
+		</ModuleConfiguration>
+	),
+};
+
+export const NoConfiguration: Story = {
+	args: {
+		name: "Git Clone",
+		description: "Clone a Git repository into your workspace on start.",
+		iconUrl: "/icon/git.svg",
+		detailsUrl: "https://registry.coder.com/modules/git-clone",
+	},
+};
+
+export const WithoutDetailsLink: Story = {
+	args: {
+		name: "Custom Module",
+		description: "A module without an external details link.",
+		iconUrl: "/icon/code.svg",
+	},
+	render: (args) => (
+		<ModuleConfiguration {...args}>
+			<TextInputField
+				id="custom-input"
+				label="Configuration value"
+				required
+				placeholder="Enter value"
+			/>
+		</ModuleConfiguration>
+	),
+};
+
+export const WithoutIcon: Story = {
+	args: {
+		name: "Unnamed Module",
+		description: "A module without an icon.",
+		detailsUrl: "https://registry.coder.com",
+	},
+	render: (args) => (
+		<ModuleConfiguration {...args}>
+			<SwitchField id="enabled" label="Enabled" defaultChecked />
+		</ModuleConfiguration>
+	),
+};
diff --git a/site/src/pages/TemplateBuilder/ModuleConfiguration.tsx b/site/src/pages/TemplateBuilder/ModuleConfiguration.tsx
new file mode 100644
index 0000000000..8db9f409a0
--- /dev/null
+++ b/site/src/pages/TemplateBuilder/ModuleConfiguration.tsx
@@ -0,0 +1,78 @@
+import { TrashIcon } from "lucide-react";
+import { Button } from "#/components/Button/Button";
+import { Link } from "#/components/Link/Link";
+
+type ModuleConfigurationProps = {
+	name: string;
+	description: string;
+	iconUrl?: string;
+	detailsUrl?: string;
+	onRemove?: () => void;
+	children?: React.ReactNode;
+};
+
+export const ModuleConfiguration: React.FC<ModuleConfigurationProps> = ({
+	name,
+	description,
+	iconUrl,
+	detailsUrl,
+	onRemove,
+	children,
+}) => {
+	return (
+		<div className="flex flex-col gap-6 pt-4 px-4 pb-6 rounded bg-surface-secondary">
+			<div className="flex items-start gap-6">
+				<div className="flex flex-1 items-center gap-3 min-w-0">
+					<div className="flex items-center justify-center p-1 rounded-md size-10 shrink-0 bg-surface-secondary border border-solid border-border">
+						{iconUrl ? (
+							<img
+								src={iconUrl}
+								alt={`${name} icon`}
+								className="size-7 object-contain"
+							/>
+						) : (
+							<div className="size-7 rounded bg-surface-primary" />
+						)}
+					</div>
+					<div className="flex flex-col flex-1 min-w-0">
+						<div className="text-sm font-semibold text-content-primary">
+							{name}
+						</div>
+						<div className="flex items-center flex-wrap">
+							<span className="text-xs font-normal text-content-secondary">
+								{description}
+							</span>
+							{detailsUrl && (
+								<Link
+									href={detailsUrl}
+									target="_blank"
+									rel="noreferrer"
+									size="sm"
+									className="text-xs font-normal ml-1"
+								>
+									View details
+								</Link>
+							)}
+						</div>
+					</div>
+				</div>
+				{onRemove && (
+					<Button
+						variant="outline"
+						size="icon"
+						onClick={onRemove}
+						aria-label={`Remove ${name}`}
+					>
+						<TrashIcon />
+					</Button>
+				)}
+			</div>
+
+			{children && (
+				<div className="grid grid-cols-1 md:grid-cols-2 gap-6 items-start">
+					{children}
+				</div>
+			)}
+		</div>
+	);
+};
diff --git a/site/src/pages/TemplateBuilder/TemplateConfiguration.stories.tsx b/site/src/pages/TemplateBuilder/TemplateConfiguration.stories.tsx
new file mode 100644
index 0000000000..2994955885
--- /dev/null
+++ b/site/src/pages/TemplateBuilder/TemplateConfiguration.stories.tsx
@@ -0,0 +1,105 @@
+import type { Meta, StoryObj } from "@storybook/react-vite";
+import { Label } from "#/components/Label/Label";
+import {
+	Select,
+	SelectContent,
+	SelectItem,
+	SelectTrigger,
+	SelectValue,
+} from "#/components/Select/Select";
+import { TemplateConfiguration } from "./TemplateConfiguration";
+
+const meta: Meta<typeof TemplateConfiguration> = {
+	title: "pages/TemplateBuilder/TemplateConfiguration",
+	component: TemplateConfiguration,
+};
+
+export default meta;
+type Story = StoryObj<typeof TemplateConfiguration>;
+
+const SelectField: React.FC<{
+	id: string;
+	label: string;
+	placeholder: string;
+	options: { value: string; label: string }[];
+}> = ({ id, label, placeholder, options }) => (
+	<div className="flex flex-col gap-1 w-[380px] max-w-full">
+		<Label htmlFor={id} className="text-sm font-normal text-content-primary">
+			{label}
+		</Label>
+		<Select>
+			<SelectTrigger id={id}>
+				<SelectValue placeholder={placeholder} />
+			</SelectTrigger>
+			<SelectContent>
+				{options.map((opt) => (
+					<SelectItem key={opt.value} value={opt.value}>
+						{opt.label}
+					</SelectItem>
+				))}
+			</SelectContent>
+		</Select>
+	</div>
+);
+
+export const Default: Story = {
+	args: {
+		name: "Docker Containers",
+		description: "Provision Docker containers as Coder workspaces.",
+		iconUrl: "/icon/docker.svg",
+		detailsUrl: "https://registry.coder.com/templates/docker",
+	},
+	render: (args) => (
+		<TemplateConfiguration {...args}>
+			<SelectField
+				id="docker-image"
+				label="Select image"
+				placeholder="Ubuntu (default)"
+				options={[
+					{ value: "ubuntu", label: "Ubuntu" },
+					{ value: "debian", label: "Debian" },
+					{ value: "alpine", label: "Alpine" },
+					{ value: "fedora", label: "Fedora" },
+				]}
+			/>
+		</TemplateConfiguration>
+	),
+};
+
+export const NoConfiguration: Story = {
+	args: {
+		name: "Kubernetes Pods",
+		description: "Provision Kubernetes pods as Coder workspaces.",
+		iconUrl: "/icon/k8s.svg",
+		detailsUrl: "https://registry.coder.com/templates/kubernetes",
+	},
+};
+
+export const WithoutDetailsLink: Story = {
+	args: {
+		name: "Custom Template",
+		description: "A template without an external details link.",
+		iconUrl: "/icon/code.svg",
+	},
+	render: (args) => (
+		<TemplateConfiguration {...args}>
+			<SelectField
+				id="custom-config"
+				label="Configuration"
+				placeholder="Select option"
+				options={[
+					{ value: "a", label: "Option A" },
+					{ value: "b", label: "Option B" },
+				]}
+			/>
+		</TemplateConfiguration>
+	),
+};
+
+export const WithoutIcon: Story = {
+	args: {
+		name: "Unnamed Template",
+		description: "A template without an icon.",
+		detailsUrl: "https://registry.coder.com",
+	},
+};
diff --git a/site/src/pages/TemplateBuilder/TemplateConfiguration.tsx b/site/src/pages/TemplateBuilder/TemplateConfiguration.tsx
new file mode 100644
index 0000000000..3e1ffba0e6
--- /dev/null
+++ b/site/src/pages/TemplateBuilder/TemplateConfiguration.tsx
@@ -0,0 +1,58 @@
+import { Link } from "#/components/Link/Link";
+
+type TemplateConfigurationProps = {
+	name: string;
+	description: string;
+	iconUrl?: string;
+	detailsUrl?: string;
+	children?: React.ReactNode;
+};
+
+export const TemplateConfiguration: React.FC<TemplateConfigurationProps> = ({
+	name,
+	description,
+	iconUrl,
+	detailsUrl,
+	children,
+}) => {
+	return (
+		<div className="flex flex-col gap-6 pt-4 px-4 pb-6 rounded bg-surface-secondary">
+			<div className="flex flex-col gap-3">
+				<div className="flex items-center justify-center p-1 rounded-md size-10 shrink-0 bg-surface-secondary border border-solid border-border">
+					{iconUrl ? (
+						<img
+							src={iconUrl}
+							alt={`${name} icon`}
+							className="size-7 object-contain"
+						/>
+					) : (
+						<div className="size-7 rounded bg-surface-primary" />
+					)}
+				</div>
+				<div className="flex flex-col">
+					<div className="text-sm font-semibold text-content-primary">
+						{name}
+					</div>
+					<div className="flex items-center flex-wrap">
+						<span className="text-xs font-normal text-content-secondary">
+							{description}
+						</span>
+						{detailsUrl && (
+							<Link
+								href={detailsUrl}
+								target="_blank"
+								rel="noreferrer"
+								size="sm"
+								className="text-xs font-normal ml-1"
+							>
+								View details
+							</Link>
+						)}
+					</div>
+				</div>
+			</div>
+
+			{children && <div className="flex flex-col gap-6">{children}</div>}
+		</div>
+	);
+};