dk-harness 0.1.0

package/templates/next-axum-monorepo/apps/axum/Cargo.toml

@@ -0,0 +1,12 @@
+[package]
+name = "axum-server"
+version = "0.1.0"
+edition = "2021"
+license = "MIT"
+
+[dependencies]
+axum = "0.8"
+tokio = { version = "1", features = ["full"] }
+
+[dev-dependencies]
+tower = { version = "0.5", features = ["util"] }

package/templates/next-axum-monorepo/apps/axum/deny.toml

@@ -0,0 +1,13 @@
+[licenses]
+allow = [
+  "Apache-2.0",
+  "BSD-3-Clause",
+  "ISC",
+  "MIT",
+  "Unicode-3.0",
+  "Zlib"
+]
+
+[advisories]
+db-path = "~/.cargo/advisory-db"
+db-urls = ["https://github.com/rustsec/advisory-db"]

package/templates/next-axum-monorepo/apps/axum/src/api/mod.rs

@@ -0,0 +1 @@
+pub mod router;

package/templates/next-axum-monorepo/apps/axum/src/api/router.rs

@@ -0,0 +1,53 @@
+use axum::{routing::get, Router};
+
+use crate::domain::health::{health_message, root_message};
+
+pub fn app_router() -> Router {
+    Router::new()
+        .route("/", get(root))
+        .route("/health", get(health))
+}
+
+async fn root() -> &'static str {
+    root_message()
+}
+
+async fn health() -> &'static str {
+    health_message()
+}
+
+#[cfg(test)]
+mod tests {
+    use axum::{
+        body::Body,
+        http::{Request, StatusCode},
+    };
+    use tower::ServiceExt;
+
+    use super::app_router;
+
+    #[tokio::test]
+    async fn root_route_returns_ok() {
+        let response = app_router()
+            .oneshot(Request::builder().uri("/").body(Body::empty()).unwrap())
+            .await
+            .unwrap();
+
+        assert_eq!(response.status(), StatusCode::OK);
+    }
+
+    #[tokio::test]
+    async fn health_route_returns_ok() {
+        let response = app_router()
+            .oneshot(
+                Request::builder()
+                    .uri("/health")
+                    .body(Body::empty())
+                    .unwrap(),
+            )
+            .await
+            .unwrap();
+
+        assert_eq!(response.status(), StatusCode::OK);
+    }
+}

package/templates/next-axum-monorepo/apps/axum/src/core/config.rs

@@ -0,0 +1,17 @@
+use std::net::{AddrParseError, SocketAddr};
+
+const SERVER_ADDRESS: &str = "127.0.0.1:3001";
+
+pub fn server_address() -> Result<SocketAddr, AddrParseError> {
+    SERVER_ADDRESS.parse()
+}
+
+#[cfg(test)]
+mod tests {
+    use super::server_address;
+
+    #[test]
+    fn server_address_parses_to_the_expected_port() {
+        assert_eq!(server_address().unwrap().port(), 3001);
+    }
+}

package/templates/next-axum-monorepo/apps/axum/src/core/mod.rs

@@ -0,0 +1 @@
+pub mod config;

package/templates/next-axum-monorepo/apps/axum/src/domain/health.rs

@@ -0,0 +1,22 @@
+pub fn root_message() -> &'static str {
+    "axum server"
+}
+
+pub fn health_message() -> &'static str {
+    "ok"
+}
+
+#[cfg(test)]
+mod tests {
+    use super::{health_message, root_message};
+
+    #[test]
+    fn health_message_is_ok() {
+        assert_eq!(health_message(), "ok");
+    }
+
+    #[test]
+    fn root_message_is_not_empty() {
+        assert!(!root_message().is_empty());
+    }
+}

package/templates/next-axum-monorepo/apps/axum/src/domain/mod.rs

@@ -0,0 +1 @@
+pub mod health;

package/templates/next-axum-monorepo/apps/axum/src/lib.rs

@@ -0,0 +1,6 @@
+pub mod api;
+pub mod core;
+pub mod domain;
+
+pub use api::router::app_router;
+pub use core::config::server_address;

package/templates/next-axum-monorepo/apps/axum/src/main.rs

@@ -0,0 +1,15 @@
+use axum_server::{app_router, server_address};
+
+#[tokio::main]
+async fn main() {
+    let address = server_address().expect("failed to parse server address");
+    let listener = tokio::net::TcpListener::bind(address)
+        .await
+        .expect("failed to bind TCP listener");
+
+    println!("axum server listening on http://{address}");
+
+    axum::serve(listener, app_router())
+        .await
+        .expect("axum server failed");
+}

package/templates/next-axum-monorepo/apps/web/app/layout.tsx

@@ -0,0 +1,43 @@
+import type { Metadata } from "next"
+import { Geist_Mono, Inter } from "next/font/google"
+
+import "@workspace/ui/globals.css"
+import { ThemeProvider } from "@/components/theme-provider"
+import { cn } from "@workspace/ui/runtime/utils"
+
+const inter = Inter({
+  subsets: ["latin"],
+  variable: "--font-sans",
+})
+
+const fontMono = Geist_Mono({
+  subsets: ["latin"],
+  variable: "--font-mono",
+})
+
+export const metadata: Metadata = {
+  title: "Project ready",
+}
+
+export default function RootLayout({
+  children,
+}: Readonly<{
+  children: React.ReactNode
+}>) {
+  return (
+    <html
+      lang="en"
+      suppressHydrationWarning
+      className={cn(
+        "antialiased",
+        fontMono.variable,
+        "font-sans",
+        inter.variable,
+      )}
+    >
+      <body>
+        <ThemeProvider>{children}</ThemeProvider>
+      </body>
+    </html>
+  )
+}

package/templates/next-axum-monorepo/apps/web/app/page.tsx

@@ -0,0 +1,19 @@
+import { Button } from "@workspace/ui/ui/button"
+
+export default function Page() {
+  return (
+    <main className="flex min-h-svh p-6">
+      <div className="flex max-w-md min-w-0 flex-col gap-4 text-sm leading-loose">
+        <section>
+          <h1 className="font-medium">Project ready!</h1>
+          <p>You may now add components and start building.</p>
+          <p>We&apos;ve already added the button component for you.</p>
+          <Button className="mt-2">Button</Button>
+        </section>
+        <div className="text-muted-foreground font-mono text-xs">
+          (Press <kbd>d</kbd> to toggle dark mode)
+        </div>
+      </div>
+    </main>
+  )
+}

package/templates/next-axum-monorepo/apps/web/biome.json

@@ -0,0 +1,16 @@
+{
+  "$schema": "https://biomejs.dev/schemas/1.9.4/schema.json",
+  "formatter": {
+    "enabled": true,
+    "indentStyle": "space"
+  },
+  "linter": {
+    "enabled": true
+  },
+  "javascript": {
+    "formatter": {
+      "quoteStyle": "double",
+      "semicolons": "asNeeded"
+    }
+  }
+}

package/templates/next-axum-monorepo/apps/web/components/theme-provider.tsx

@@ -0,0 +1,71 @@
+"use client"
+
+import { ThemeProvider as NextThemesProvider, useTheme } from "next-themes"
+import * as React from "react"
+
+function ThemeProvider({
+  children,
+  ...props
+}: React.ComponentProps<typeof NextThemesProvider>) {
+  return (
+    <NextThemesProvider
+      attribute="class"
+      defaultTheme="system"
+      enableSystem
+      disableTransitionOnChange
+      {...props}
+    >
+      <ThemeHotkey />
+      {children}
+    </NextThemesProvider>
+  )
+}
+
+function isTypingTarget(target: EventTarget | null) {
+  if (!(target instanceof HTMLElement)) {
+    return false
+  }
+
+  return (
+    target.isContentEditable ||
+    target.tagName === "INPUT" ||
+    target.tagName === "TEXTAREA" ||
+    target.tagName === "SELECT"
+  )
+}
+
+function ThemeHotkey() {
+  const { resolvedTheme, setTheme } = useTheme()
+
+  React.useEffect(() => {
+    function onKeyDown(event: KeyboardEvent) {
+      if (event.defaultPrevented || event.repeat) {
+        return
+      }
+
+      if (event.metaKey || event.ctrlKey || event.altKey) {
+        return
+      }
+
+      if (event.key.toLowerCase() !== "d") {
+        return
+      }
+
+      if (isTypingTarget(event.target)) {
+        return
+      }
+
+      setTheme(resolvedTheme === "dark" ? "light" : "dark")
+    }
+
+    window.addEventListener("keydown", onKeyDown)
+
+    return () => {
+      window.removeEventListener("keydown", onKeyDown)
+    }
+  }, [resolvedTheme, setTheme])
+
+  return null
+}
+
+export { ThemeProvider }

package/templates/next-axum-monorepo/apps/web/components.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "https://ui.shadcn.com/schema.json",
+  "style": "radix-lyra",
+  "rsc": true,
+  "tsx": true,
+  "tailwind": {
+    "config": "",
+    "css": "../../packages/ui/src/styles/globals.css",
+    "baseColor": "neutral",
+    "cssVariables": true
+  },
+  "iconLibrary": "lucide",
+  "aliases": {
+    "components": "@/components",
+    "hooks": "@/hooks",
+    "lib": "@/lib",
+    "utils": "@workspace/ui/runtime/utils",
+    "ui": "@workspace/ui/ui"
+  },
+  "rtl": true,
+  "menuColor": "default",
+  "menuAccent": "subtle"
+}

package/templates/next-axum-monorepo/apps/web/dependency-cruiser.cjs

@@ -0,0 +1,66 @@
+/** @type {import("dependency-cruiser").IConfiguration} */
+module.exports = {
+  forbidden: [
+    {
+      name: "no-circular",
+      severity: "error",
+      from: {},
+      to: {
+        circular: true,
+      },
+    },
+    {
+      name: "app-does-not-import-upwards",
+      severity: "error",
+      from: {
+        path: "^app/",
+      },
+      to: {
+        path: "^(?!app/|components/|hooks/|lib/)",
+        dependencyTypesNot: ["npm", "npm-dev", "core"],
+      },
+    },
+    {
+      name: "components-do-not-import-app",
+      severity: "error",
+      from: {
+        path: "^components/",
+      },
+      to: {
+        path: "^(app/|(?!(components/|hooks/|lib/)).+)",
+        dependencyTypesNot: ["npm", "npm-dev", "core"],
+      },
+    },
+    {
+      name: "hooks-only-import-lib",
+      severity: "error",
+      from: {
+        path: "^hooks/",
+      },
+      to: {
+        path: "^(app/|components/|hooks/|(?!(lib/)).+)",
+        dependencyTypesNot: ["npm", "npm-dev", "core"],
+      },
+    },
+    {
+      name: "lib-does-not-import-upwards",
+      severity: "error",
+      from: {
+        path: "^lib/",
+      },
+      to: {
+        path: "^(app/|components/|hooks/|(?!(lib/)).+)",
+        dependencyTypesNot: ["npm", "npm-dev", "core"],
+      },
+    },
+  ],
+  options: {
+    doNotFollow: {
+      path: "node_modules",
+    },
+    includeOnly: "^(app|components|hooks|lib)",
+    tsConfig: {
+      fileName: "tsconfig.json",
+    },
+  },
+}

package/templates/next-axum-monorepo/apps/web/eslint.config.js

@@ -0,0 +1,4 @@
+import { nextJsConfig } from "@workspace/eslint-config/next-js"
+
+/** @type {import("eslint").Linter.Config} */
+export default nextJsConfig

package/templates/next-axum-monorepo/apps/web/knip.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "https://unpkg.com/knip@5/schema.json",
+  "entry": [
+    "app/page.tsx",
+    "components/theme-provider.tsx",
+    "next.config.mjs",
+    "postcss.config.mjs",
+    "playwright.config.ts",
+    "vitest.config.ts"
+  ],
+  "project": [
+    "app/**/*.{ts,tsx}",
+    "components/**/*.{ts,tsx}",
+    "tests/**/*.{ts,tsx}"
+  ],
+  "ignoreDependencies": ["@workspace/ui", "@tailwindcss/postcss"]
+}

package/templates/next-axum-monorepo/apps/web/lighthouserc.json

@@ -0,0 +1,23 @@
+{
+  "ci": {
+    "collect": {
+      "numberOfRuns": 1,
+      "url": ["http://127.0.0.1:3000/"],
+      "settings": {
+        "preset": "desktop",
+        "chromeFlags": "--headless --no-sandbox"
+      }
+    },
+    "assert": {
+      "assertions": {
+        "categories:accessibility": ["error", { "minScore": 0.9 }],
+        "categories:best-practices": ["error", { "minScore": 0.9 }],
+        "categories:performance": ["warn", { "minScore": 0.6 }],
+        "categories:seo": "off"
+      }
+    },
+    "upload": {
+      "target": "temporary-public-storage"
+    }
+  }
+}

package/templates/next-axum-monorepo/apps/web/next-env.d.ts

@@ -0,0 +1,6 @@
+/// <reference types="next" />
+/// <reference types="next/image-types/global" />
+import "./.next/dev/types/routes.d.ts"
+
+// NOTE: This file should not be edited
+// see https://nextjs.org/docs/app/api-reference/config/typescript for more information.

package/templates/next-axum-monorepo/apps/web/next.config.mjs

@@ -0,0 +1,6 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  transpilePackages: ["@workspace/ui"],
+}
+
+export default nextConfig

package/templates/next-axum-monorepo/apps/web/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "web",
+  "version": "0.0.1",
+  "type": "module",
+  "private": true,
+  "scripts": {
+    "dev": "next dev --turbopack",
+    "build": "next build",
+    "start": "next start",
+    "lint": "biome check . && depcruise --config dependency-cruiser.cjs . && knip --config knip.json --no-config-hints",
+    "format": "biome format --write .",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run --config vitest.config.ts",
+    "test:e2e": "playwright test",
+    "lighthouse": "lhci autorun --config ./lighthouserc.json",
+    "ux": "start-server-and-test \"pnpm dev\" http://127.0.0.1:3000 \"pnpm test:e2e && pnpm lighthouse\""
+  },
+  "dependencies": {
+    "@workspace/ui": "workspace:*",
+    "next": "16.1.6",
+    "next-themes": "^0.4.6",
+    "react": "^19.2.4",
+    "react-dom": "^19.2.4"
+  },
+  "devDependencies": {
+    "@axe-core/playwright": "^4.11.0",
+    "@biomejs/biome": "^1.9.4",
+    "@lhci/cli": "^0.15.1",
+    "@playwright/test": "^1.51.1",
+    "@tailwindcss/postcss": "^4.1.18",
+    "@testing-library/jest-dom": "^6.8.0",
+    "@testing-library/react": "^16.3.0",
+    "@vitejs/plugin-react": "^5.0.4",
+    "@types/node": "^25.1.0",
+    "@types/react": "^19.2.10",
+    "@types/react-dom": "^19.2.3",
+    "@workspace/typescript-config": "workspace:*",
+    "dependency-cruiser": "^17.1.0",
+    "jsdom": "^26.1.0",
+    "knip": "^5.44.4",
+    "start-server-and-test": "^3.0.2",
+    "typescript": "^5.9.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4"
+  }
+}

package/templates/next-axum-monorepo/apps/web/playwright.config.ts

@@ -0,0 +1,18 @@
+import { defineConfig, devices } from "@playwright/test"
+
+export default defineConfig({
+  testDir: "./tests/e2e",
+  timeout: 30_000,
+  use: {
+    baseURL: "http://127.0.0.1:3000",
+    trace: "retain-on-failure",
+  },
+  projects: [
+    {
+      name: "chromium",
+      use: {
+        ...devices["Desktop Chrome"],
+      },
+    },
+  ],
+})

package/templates/next-axum-monorepo/apps/web/postcss.config.mjs

@@ -0,0 +1 @@
+export { default } from "@workspace/ui/postcss.config"

package/templates/next-axum-monorepo/apps/web/skills-lock.json

@@ -0,0 +1,15 @@
+{
+  "version": 1,
+  "skills": {
+    "frontend-design": {
+      "source": "anthropics/skills",
+      "sourceType": "github",
+      "computedHash": "063a0e6448123cd359ad0044cc46b0e490cc7964d45ef4bb9fd842bd2ffbca67"
+    },
+    "shadcn": {
+      "source": "shadcn/ui",
+      "sourceType": "github",
+      "computedHash": "873c67922d80775a9fdf596db7964b579f0408c30ec6e3d11989f6055bbec89f"
+    }
+  }
+}

package/templates/next-axum-monorepo/apps/web/tests/e2e/smoke.spec.ts

@@ -0,0 +1,13 @@
+import AxeBuilder from "@axe-core/playwright"
+import { expect, test } from "@playwright/test"
+
+test("homepage smoke flow passes accessibility checks", async ({ page }) => {
+  await page.goto("/")
+
+  await expect(
+    page.getByRole("heading", { name: "Project ready!" }),
+  ).toBeVisible()
+
+  const results = await new AxeBuilder({ page }).analyze()
+  expect(results.violations).toEqual([])
+})

package/templates/next-axum-monorepo/apps/web/tests/unit/page.test.tsx

@@ -0,0 +1,16 @@
+import { render, screen } from "@testing-library/react"
+
+import Page from "@/app/page"
+
+describe("Page", () => {
+  it("renders the starter copy", () => {
+    render(<Page />)
+
+    expect(
+      screen.getByRole("heading", { name: "Project ready!" }),
+    ).toBeInTheDocument()
+    expect(
+      screen.getByText("You may now add components and start building."),
+    ).toBeInTheDocument()
+  })
+})

package/templates/next-axum-monorepo/apps/web/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "extends": "@workspace/typescript-config/nextjs.json",
+  "compilerOptions": {
+    "paths": {
+      "@/*": ["./*"],
+      "@workspace/ui/*": ["../../packages/ui/src/*"]
+    },
+    "types": ["vitest/globals"],
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ]
+  },
+  "include": [
+    "next-env.d.ts",
+    "next.config.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts"
+  ],
+  "exclude": ["node_modules"]
+}

package/templates/next-axum-monorepo/apps/web/vitest.config.ts

@@ -0,0 +1,13 @@
+import react from "@vitejs/plugin-react"
+import tsconfigPaths from "vite-tsconfig-paths"
+import { defineConfig } from "vitest/config"
+
+export default defineConfig({
+  plugins: [react(), tsconfigPaths()],
+  test: {
+    environment: "jsdom",
+    globals: true,
+    include: ["tests/unit/**/*.test.ts?(x)"],
+    setupFiles: ["./vitest.setup.ts"],
+  },
+})

package/templates/next-axum-monorepo/apps/web/vitest.setup.ts

@@ -0,0 +1 @@
+import "@testing-library/jest-dom/vitest"

package/templates/next-axum-monorepo/docs/DESIGN.md

@@ -0,0 +1,10 @@
+# Design
+
+Use this file as the entrypoint for design-oriented knowledge.
+
+- Design document index: `design-docs/index.md`
+- Core beliefs: `design-docs/core-beliefs.md`
+- Included design and frontend skills: `design-docs/included-skills.md`
+- Design-system references for agents: `references/design-system-reference-llms.txt`
+
+The starter should stay visually minimal while keeping room for product-specific styling.