feat: volume stats & charts

apps/client/app/app.css

@@ -135,3 +135,21 @@ body {
 		@apply bg-background text-foreground;
 	}
 }
+
+@layer base {
+	:root {
+		--chart-1: oklch(0.646 0.222 41.116);
+		--chart-2: oklch(0.6 0.118 184.704);
+		--chart-3: oklch(0.398 0.07 227.392);
+		--chart-4: oklch(0.828 0.189 84.429);
+		--chart-5: oklch(0.769 0.188 70.08);
+	}
+
+	.dark {
+		--chart-1: oklch(0.488 0.243 264.376);
+		--chart-2: oklch(0.696 0.17 162.48);
+		--chart-3: oklch(0.769 0.188 70.08);
+		--chart-4: oklch(0.627 0.265 303.9);
+		--chart-5: oklch(0.645 0.246 16.439);
+	}
+}

apps/client/app/components/edit-volume-dialog.tsx

@@ -1,9 +1,9 @@
 import { useMutation } from "@tanstack/react-query";
 import { useId } from "react";
 import { toast } from "sonner";
-import type { GetVolumeResponse } from "~/api-client";
 import { updateVolumeMutation } from "~/api-client/@tanstack/react-query.gen";
 import { parseError } from "~/lib/errors";
+import type { Volume } from "../lib/types";
 import { CreateVolumeForm } from "./create-volume-form";
 import { Button } from "./ui/button";
 import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, DialogTitle } from "./ui/dialog";
@@ -11,7 +11,7 @@ import { Dialog, DialogContent, DialogDescription, DialogFooter, DialogHeader, D
 type Props = {
 	open: boolean;
 	setOpen: (open: boolean) => void;
-	initialValues?: Partial<GetVolumeResponse>;
+	initialValues?: Partial<Volume>;
 };
 
 export const EditVolumeDialog = ({ open, setOpen, initialValues }: Props) => {

apps/client/app/components/ui/chart.tsx

@@ -0,0 +1,355 @@
+import * as React from "react"
+import * as RechartsPrimitive from "recharts"
+
+import { cn } from "~/lib/utils"
+
+// Format: { THEME_NAME: CSS_SELECTOR }
+const THEMES = { light: "", dark: ".dark" } as const
+
+export type ChartConfig = {
+  [k in string]: {
+    label?: React.ReactNode
+    icon?: React.ComponentType
+  } & (
+    | { color?: string; theme?: never }
+    | { color?: never; theme: Record<keyof typeof THEMES, string> }
+  )
+}
+
+type ChartContextProps = {
+  config: ChartConfig
+}
+
+const ChartContext = React.createContext<ChartContextProps | null>(null)
+
+function useChart() {
+  const context = React.useContext(ChartContext)
+
+  if (!context) {
+    throw new Error("useChart must be used within a <ChartContainer />")
+  }
+
+  return context
+}
+
+function ChartContainer({
+  id,
+  className,
+  children,
+  config,
+  ...props
+}: React.ComponentProps<"div"> & {
+  config: ChartConfig
+  children: React.ComponentProps<
+    typeof RechartsPrimitive.ResponsiveContainer
+  >["children"]
+}) {
+  const uniqueId = React.useId()
+  const chartId = `chart-${id || uniqueId.replace(/:/g, "")}`
+
+  return (
+    <ChartContext.Provider value={{ config }}>
+      <div
+        data-slot="chart"
+        data-chart={chartId}
+        className={cn(
+          "[&_.recharts-cartesian-axis-tick_text]:fill-muted-foreground [&_.recharts-cartesian-grid_line[stroke='#ccc']]:stroke-border/50 [&_.recharts-curve.recharts-tooltip-cursor]:stroke-border [&_.recharts-polar-grid_[stroke='#ccc']]:stroke-border [&_.recharts-radial-bar-background-sector]:fill-muted [&_.recharts-rectangle.recharts-tooltip-cursor]:fill-muted [&_.recharts-reference-line_[stroke='#ccc']]:stroke-border flex aspect-video justify-center text-xs [&_.recharts-dot[stroke='#fff']]:stroke-transparent [&_.recharts-layer]:outline-hidden [&_.recharts-sector]:outline-hidden [&_.recharts-sector[stroke='#fff']]:stroke-transparent [&_.recharts-surface]:outline-hidden",
+          className
+        )}
+        {...props}
+      >
+        <ChartStyle id={chartId} config={config} />
+        <RechartsPrimitive.ResponsiveContainer>
+          {children}
+        </RechartsPrimitive.ResponsiveContainer>
+      </div>
+    </ChartContext.Provider>
+  )
+}
+
+const ChartStyle = ({ id, config }: { id: string; config: ChartConfig }) => {
+  const colorConfig = Object.entries(config).filter(
+    ([, config]) => config.theme || config.color
+  )
+
+  if (!colorConfig.length) {
+    return null
+  }
+
+  return (
+    <style
+      dangerouslySetInnerHTML={{
+        __html: Object.entries(THEMES)
+          .map(
+            ([theme, prefix]) => `
+${prefix} [data-chart=${id}] {
+${colorConfig
+  .map(([key, itemConfig]) => {
+    const color =
+      itemConfig.theme?.[theme as keyof typeof itemConfig.theme] ||
+      itemConfig.color
+    return color ? `  --color-${key}: ${color};` : null
+  })
+  .join("\n")}
+}
+`
+          )
+          .join("\n"),
+      }}
+    />
+  )
+}
+
+const ChartTooltip = RechartsPrimitive.Tooltip
+
+function ChartTooltipContent({
+  active,
+  payload,
+  className,
+  indicator = "dot",
+  hideLabel = false,
+  hideIndicator = false,
+  label,
+  labelFormatter,
+  labelClassName,
+  formatter,
+  color,
+  nameKey,
+  labelKey,
+}: React.ComponentProps<typeof RechartsPrimitive.Tooltip> &
+  React.ComponentProps<"div"> & {
+    hideLabel?: boolean
+    hideIndicator?: boolean
+    indicator?: "line" | "dot" | "dashed"
+    nameKey?: string
+    labelKey?: string
+  }) {
+  const { config } = useChart()
+
+  const tooltipLabel = React.useMemo(() => {
+    if (hideLabel || !payload?.length) {
+      return null
+    }
+
+    const [item] = payload
+    const key = `${labelKey || item?.dataKey || item?.name || "value"}`
+    const itemConfig = getPayloadConfigFromPayload(config, item, key)
+    const value =
+      !labelKey && typeof label === "string"
+        ? config[label as keyof typeof config]?.label || label
+        : itemConfig?.label
+
+    if (labelFormatter) {
+      return (
+        <div className={cn("font-medium", labelClassName)}>
+          {labelFormatter(value, payload)}
+        </div>
+      )
+    }
+
+    if (!value) {
+      return null
+    }
+
+    return <div className={cn("font-medium", labelClassName)}>{value}</div>
+  }, [
+    label,
+    labelFormatter,
+    payload,
+    hideLabel,
+    labelClassName,
+    config,
+    labelKey,
+  ])
+
+  if (!active || !payload?.length) {
+    return null
+  }
+
+  const nestLabel = payload.length === 1 && indicator !== "dot"
+
+  return (
+    <div
+      className={cn(
+        "border-border/50 bg-background grid min-w-[8rem] items-start gap-1.5 rounded-lg border px-2.5 py-1.5 text-xs shadow-xl",
+        className
+      )}
+    >
+      {!nestLabel ? tooltipLabel : null}
+      <div className="grid gap-1.5">
+        {payload
+          .filter((item) => item.type !== "none")
+          .map((item, index) => {
+            const key = `${nameKey || item.name || item.dataKey || "value"}`
+            const itemConfig = getPayloadConfigFromPayload(config, item, key)
+            const indicatorColor = color || item.payload.fill || item.color
+
+            return (
+              <div
+                key={item.dataKey}
+                className={cn(
+                  "[&>svg]:text-muted-foreground flex w-full flex-wrap items-stretch gap-2 [&>svg]:h-2.5 [&>svg]:w-2.5",
+                  indicator === "dot" && "items-center"
+                )}
+              >
+                {formatter && item?.value !== undefined && item.name ? (
+                  formatter(item.value, item.name, item, index, item.payload)
+                ) : (
+                  <>
+                    {itemConfig?.icon ? (
+                      <itemConfig.icon />
+                    ) : (
+                      !hideIndicator && (
+                        <div
+                          className={cn(
+                            "shrink-0 rounded-[2px] border-(--color-border) bg-(--color-bg)",
+                            {
+                              "h-2.5 w-2.5": indicator === "dot",
+                              "w-1": indicator === "line",
+                              "w-0 border-[1.5px] border-dashed bg-transparent":
+                                indicator === "dashed",
+                              "my-0.5": nestLabel && indicator === "dashed",
+                            }
+                          )}
+                          style={
+                            {
+                              "--color-bg": indicatorColor,
+                              "--color-border": indicatorColor,
+                            } as React.CSSProperties
+                          }
+                        />
+                      )
+                    )}
+                    <div
+                      className={cn(
+                        "flex flex-1 justify-between leading-none",
+                        nestLabel ? "items-end" : "items-center"
+                      )}
+                    >
+                      <div className="grid gap-1.5">
+                        {nestLabel ? tooltipLabel : null}
+                        <span className="text-muted-foreground">
+                          {itemConfig?.label || item.name}
+                        </span>
+                      </div>
+                      {item.value && (
+                        <span className="text-foreground font-mono font-medium tabular-nums">
+                          {item.value.toLocaleString()}
+                        </span>
+                      )}
+                    </div>
+                  </>
+                )}
+              </div>
+            )
+          })}
+      </div>
+    </div>
+  )
+}
+
+const ChartLegend = RechartsPrimitive.Legend
+
+function ChartLegendContent({
+  className,
+  hideIcon = false,
+  payload,
+  verticalAlign = "bottom",
+  nameKey,
+}: React.ComponentProps<"div"> &
+  Pick<RechartsPrimitive.LegendProps, "payload" | "verticalAlign"> & {
+    hideIcon?: boolean
+    nameKey?: string
+  }) {
+  const { config } = useChart()
+
+  if (!payload?.length) {
+    return null
+  }
+
+  return (
+    <div
+      className={cn(
+        "flex items-center justify-center gap-4",
+        verticalAlign === "top" ? "pb-3" : "pt-3",
+        className
+      )}
+    >
+      {payload
+        .filter((item) => item.type !== "none")
+        .map((item) => {
+          const key = `${nameKey || item.dataKey || "value"}`
+          const itemConfig = getPayloadConfigFromPayload(config, item, key)
+
+          return (
+            <div
+              key={item.value}
+              className={cn(
+                "[&>svg]:text-muted-foreground flex items-center gap-1.5 [&>svg]:h-3 [&>svg]:w-3"
+              )}
+            >
+              {itemConfig?.icon && !hideIcon ? (
+                <itemConfig.icon />
+              ) : (
+                <div
+                  className="h-2 w-2 shrink-0 rounded-[2px]"
+                  style={{
+                    backgroundColor: item.color,
+                  }}
+                />
+              )}
+              {itemConfig?.label}
+            </div>
+          )
+        })}
+    </div>
+  )
+}
+
+// Helper to extract item config from a payload.
+function getPayloadConfigFromPayload(
+  config: ChartConfig,
+  payload: unknown,
+  key: string
+) {
+  if (typeof payload !== "object" || payload === null) {
+    return undefined
+  }
+
+  const payloadPayload =
+    "payload" in payload &&
+    typeof payload.payload === "object" &&
+    payload.payload !== null
+      ? payload.payload
+      : undefined
+
+  let configLabelKey: string = key
+
+  if (
+    key in payload &&
+    typeof payload[key as keyof typeof payload] === "string"
+  ) {
+    configLabelKey = payload[key as keyof typeof payload] as string
+  } else if (
+    payloadPayload &&
+    key in payloadPayload &&
+    typeof payloadPayload[key as keyof typeof payloadPayload] === "string"
+  ) {
+    configLabelKey = payloadPayload[
+      key as keyof typeof payloadPayload
+    ] as string
+  }
+
+  return configLabelKey in config
+    ? config[configLabelKey]
+    : config[key as keyof typeof config]
+}
+
+export {
+  ChartContainer,
+  ChartTooltip,
+  ChartTooltipContent,
+  ChartLegend,
+  ChartLegendContent,
+  ChartStyle,
+}

apps/client/app/modules/details/components/healthchecks-card.tsx

@@ -15,10 +15,10 @@ export const HealthchecksCard = ({ volume }: Props) => {
 	});
 
 	return (
-		<Card className="p-6 flex-1 flex flex-col">
+		<Card className="p-6 flex-1 flex flex-col h-full">
 			<div className="flex flex-col flex-1 justify-start">
 				<span className="flex items-center gap-2 mb-4">
-					<ScanHeartIcon size={24} />
+					<ScanHeartIcon className="h-4 w-4" />
 					<h2 className="text-lg font-medium">Health Checks</h2>
 				</span>
 				{volume.lastError && <span className="text-md text-red-600 ">{volume.lastError}</span>}

apps/client/app/modules/details/components/storage-chart.tsx

@@ -0,0 +1,93 @@
+"use client";
+
+import { HardDrive } from "lucide-react";
+import * as React from "react";
+import { Label, Pie, PieChart } from "recharts";
+import { ByteSize } from "~/components/bytes-size";
+import { Card, CardContent, CardHeader, CardTitle } from "~/components/ui/card";
+import { ChartContainer, ChartTooltip, ChartTooltipContent, type ChartConfig } from "~/components/ui/chart";
+import type { StatFs } from "~/lib/types";
+
+type Props = {
+	statfs: StatFs;
+};
+
+export function StorageChart({ statfs }: Props) {
+	const chartData = React.useMemo(
+		() => [
+			{
+				name: "Used",
+				value: statfs.used,
+				fill: "blue",
+			},
+			{
+				name: "Free",
+				value: statfs.free,
+				fill: "lightgray",
+			},
+		],
+		[statfs],
+	);
+
+	const chartConfig = {
+		value: {
+			label: "Storage",
+		},
+		used: {
+			label: "Used",
+			color: "hsl(var(--destructive))",
+		},
+		free: {
+			label: "Free",
+			color: "hsl(var(--primary))",
+		},
+	} satisfies ChartConfig;
+
+	const usagePercentage = React.useMemo(() => {
+		return Math.round((statfs.used / statfs.total) * 100);
+	}, [statfs]);
+
+	return (
+		<Card className="flex flex-col h-full text-sm">
+			<CardHeader className="items-center pb-0">
+				<CardTitle className="flex items-center gap-2">
+					<HardDrive className="h-4 w-4" />
+					Storage Usage
+				</CardTitle>
+			</CardHeader>
+			<CardContent className="flex-1 pb-0">
+				<ChartContainer config={chartConfig} className="mx-auto aspect-square max-h-[250px]">
+					<PieChart>
+						<ChartTooltip
+							cursor={false}
+							content={
+								<ChartTooltipContent
+									hideLabel
+									formatter={(value, name) => [<ByteSize key={name} bytes={value as number} />, name]}
+								/>
+							}
+						/>
+						<Pie data={chartData} dataKey="value" nameKey="name" innerRadius={60} strokeWidth={5}>
+							<Label
+								content={({ viewBox }) => {
+									if (viewBox && "cx" in viewBox && "cy" in viewBox) {
+										return (
+											<text x={viewBox.cx} y={viewBox.cy} textAnchor="middle" dominantBaseline="middle">
+												<tspan x={viewBox.cx} y={viewBox.cy} className="fill-foreground text-3xl font-bold">
+													{usagePercentage}%
+												</tspan>
+												<tspan x={viewBox.cx} y={(viewBox.cy || 0) + 24} className="fill-muted-foreground">
+													Used
+												</tspan>
+											</text>
+										);
+									}
+								}}
+							/>
+						</Pie>
+					</PieChart>
+				</ChartContainer>
+			</CardContent>
+		</Card>
+	);
+}

apps/client/app/modules/details/components/storage-info-card.tsx

@@ -0,0 +1,54 @@
+import { Database, HardDrive } from "lucide-react";
+import { ByteSize } from "~/components/bytes-size";
+import { Card, CardContent, CardHeader, CardTitle } from "~/components/ui/card";
+import type { StatFs } from "~/lib/types";
+
+type Props = {
+	statfs: StatFs;
+};
+
+export function StorageInfoCard({ statfs }: Props) {
+	return (
+		<Card className="h-full text-sm">
+			<CardHeader>
+				<CardTitle className="flex items-center gap-2">
+					<Database className="h-4 w-4" />
+					Storage Details
+				</CardTitle>
+			</CardHeader>
+			<CardContent className="space-y-4">
+				<div className="flex flex-col h-full justify-center">
+					<div className="grid gap-4 w-full">
+						<div className="flex items-center justify-between p-3 rounded-lg bg-muted/50">
+							<div className="flex items-center gap-3">
+								<HardDrive className="h-4 w-4 text-muted-foreground" />
+								<span className="font-medium">Total Capacity</span>
+							</div>
+							<ByteSize bytes={statfs.total} className="font-mono text-sm" />
+						</div>
+
+						<div className="flex items-center justify-between p-3 rounded-lg bg-blue-500/10">
+							<div className="flex items-center gap-3">
+								<div className="h-4 w-4 rounded-full bg-blue-500" />
+								<span className="font-medium">Used Space</span>
+							</div>
+							<div className="text-right">
+								<ByteSize bytes={statfs.used} className="font-mono text-sm" />
+							</div>
+						</div>
+
+						<div className="flex items-center justify-between p-3 rounded-lg bg-primary/10">
+							<div className="flex items-center gap-3">
+								<div className="h-4 w-4 rounded-full bg-primary" />
+								<span className="font-medium">Free Space</span>
+							</div>
+							<div className="text-right">
+								<ByteSize bytes={statfs.free} className="font-mono text-sm" />
+							</div>
+						</div>
+					</div>
+				</div>
+			</CardContent>
+		</Card>
+	);
+}

apps/client/app/modules/details/tabs/info.tsx

@@ -1,8 +1,9 @@
 import { CreateVolumeForm } from "~/components/create-volume-form";
 import { Card } from "~/components/ui/card";
-import { HealthchecksCard } from "../components/healthchecks-card";
 import type { StatFs, Volume } from "~/lib/types";
-import { ByteSize } from "~/components/bytes-size";
+import { HealthchecksCard } from "../components/healthchecks-card";
+import { StorageChart } from "../components/storage-chart";
+import { StorageInfoCard } from "../components/storage-info-card";
 
 type Props = {
 	volume: Volume;
@@ -11,19 +12,19 @@ type Props = {
 
 export const VolumeInfoTabContent = ({ volume, statfs }: Props) => {
 	return (
-		<div className="grid gap-4 grid-cols-1 lg:grid-cols-3 lg:grid-rows-[auto_1fr]">
+		<div className="grid gap-3 grid-cols-1 lg:grid-cols-4 lg:grid-rows-[auto_auto]">
 			<Card className="p-6 lg:col-span-2 lg:row-span-2">
 				<CreateVolumeForm initialValues={{ ...volume, ...volume.config }} onSubmit={console.log} />
 			</Card>
-			<HealthchecksCard volume={volume} />
-			<Card className="p-6 h-full">
-				<h2 className="text-lg font-medium">Volume Information</h2>
-				Total: <ByteSize bytes={statfs.total} />
-				<br />
-				Free: <ByteSize bytes={statfs.free} />
-				<br />
-				Used: <ByteSize bytes={statfs.used} />
-			</Card>
+			<div className="lg:col-span-2 lg:row-span-1">
+				<HealthchecksCard volume={volume} />
+			</div>
+			<div className="lg:col-span-1">
+				<StorageChart statfs={statfs} />
+			</div>
+			<div className="lg:col-span-1">
+				<StorageInfoCard statfs={statfs} />
+			</div>
 		</div>
 	);
 };

apps/client/app/routes/details.tsx

@@ -8,19 +8,19 @@ import {
 	mountVolumeMutation,
 	unmountVolumeMutation,
 } from "~/api-client/@tanstack/react-query.gen";
+import { StatusDot } from "~/components/status-dot";
 import { Button } from "~/components/ui/button";
+import { Tabs, TabsContent, TabsList, TabsTrigger } from "~/components/ui/tabs";
 import { VolumeIcon } from "~/components/volume-icon";
 import { parseError } from "~/lib/errors";
-import type { Route } from "./+types/details";
 import { cn } from "~/lib/utils";
-import { StatusDot } from "~/components/status-dot";
-import { VolumeInfoTabContent } from "~/modules/details/tabs/info";
-import { Tabs, TabsContent, TabsList, TabsTrigger } from "~/components/ui/tabs";
 import { DockerTabContent } from "~/modules/details/tabs/docker";
+import { VolumeInfoTabContent } from "~/modules/details/tabs/info";
+import type { Route } from "./+types/details";
 
 export function meta({ params }: Route.MetaArgs) {
 	return [
-		{ title: "Ironmount - " + params.name },
+		{ title: `Ironmount - ${params.name}` },
 		{
 			name: "description",
 			content: "Create, manage, monitor, and automate your Docker volumes with ease.",
@@ -93,7 +93,6 @@ export default function DetailsPage({ loaderData }: Route.ComponentProps) {
 		return <div>Loading...</div>;
 	}
 
-	console.log(data);
 	const { volume, statfs } = data;
 
 	return (