npm - dk-harness - Versions diffs - 0.1.0 - Mend

dk-harness 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (291) hide show

package/templates/next-fastapi-monorepo/apps/web/app/favicon.ico ADDED Viewed

Binary file

package/templates/next-fastapi-monorepo/apps/web/app/layout.tsx ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/app/page.tsx ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/biome.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/components/.gitkeep ADDED Viewed

File without changes

package/templates/next-fastapi-monorepo/apps/web/components/theme-provider.tsx ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/components.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/dependency-cruiser.cjs ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/eslint.config.js ADDED Viewed

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

package/templates/next-fastapi-monorepo/apps/web/hooks/.gitkeep ADDED Viewed

File without changes

package/templates/next-fastapi-monorepo/apps/web/knip.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/lib/.gitkeep ADDED Viewed

File without changes

package/templates/next-fastapi-monorepo/apps/web/lighthouserc.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/next-env.d.ts ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/next.config.mjs ADDED Viewed

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

package/templates/next-fastapi-monorepo/apps/web/package.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/playwright.config.ts ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/postcss.config.mjs ADDED Viewed

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

package/templates/next-fastapi-monorepo/apps/web/skills-lock.json ADDED Viewed

@@ -0,0 +1,40 @@
+{
+  "version": 1,
+  "skills": {
+    "frontend-design": {
+      "source": "anthropics/skills",
+      "sourceType": "github",
+      "computedHash": "063a0e6448123cd359ad0044cc46b0e490cc7964d45ef4bb9fd842bd2ffbca67"
+    },
+    "shadcn": {
+      "source": "shadcn/ui",
+      "sourceType": "github",
+      "computedHash": "873c67922d80775a9fdf596db7964b579f0408c30ec6e3d11989f6055bbec89f"
+    },
+    "vercel-composition-patterns": {
+      "source": "vercel-labs/agent-skills",
+      "sourceType": "github",
+      "computedHash": "575757e3e25761c8c562d6e395d29f0b76c98b1273c0bd72d88e6ab1bc9c7d42"
+    },
+    "vercel-react-best-practices": {
+      "source": "vercel-labs/agent-skills",
+      "sourceType": "github",
+      "computedHash": "43ca6c197f8ec13055079da7053232d477068b03ca443f9ac1bc819b95cdd432"
+    },
+    "vercel-react-native-skills": {
+      "source": "vercel-labs/agent-skills",
+      "sourceType": "github",
+      "computedHash": "41d24eafa7c3d82e270439808f7cfbc4d51aeb2d14f2809a2267c16275784d06"
+    },
+    "vercel-react-view-transitions": {
+      "source": "vercel-labs/agent-skills",
+      "sourceType": "github",
+      "computedHash": "c8952fc9127fa0564d0cb71dccb4215a5608ac933b5831104f09173a97a46f85"
+    },
+    "web-design-guidelines": {
+      "source": "vercel-labs/agent-skills",
+      "sourceType": "github",
+      "computedHash": "f3bc47f890f42a44db1007ab390709ec368e4b8c089baee6b0007182236ac474"
+    }
+  }
+}

package/templates/next-fastapi-monorepo/apps/web/tests/e2e/smoke.spec.ts ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/tests/unit/page.test.tsx ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/tsconfig.json ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/vitest.config.ts ADDED Viewed

@@ -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-fastapi-monorepo/apps/web/vitest.setup.ts ADDED Viewed

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

package/templates/next-fastapi-monorepo/docs/DESIGN.md ADDED Viewed

@@ -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.

package/templates/next-fastapi-monorepo/docs/FRONTEND.md ADDED Viewed

@@ -0,0 +1,26 @@
+# Frontend
+## Scope
+Frontend work lives in `apps/web` and `packages/ui`.
+Backend work lives separately in `apps/api`.
+## Shared UI Package
+Use these public paths from `@workspace/ui`:
+- `@workspace/ui/ui/*`
+- `@workspace/ui/runtime/*`
+- `@workspace/ui/providers/*`
+Keep shared UI work aligned with the enforced stack and do not reintroduce the old `components/hooks/lib` package layers.
+## Component Workflow
+Add shared primitives with:
+```bash
+pnpm dlx shadcn@latest add button -c apps/web
+```
+Generated shared components should land in `packages/ui/src/ui`.

package/templates/next-fastapi-monorepo/docs/PLANS.md ADDED Viewed

@@ -0,0 +1,25 @@
+# Plans
+Plans are first-class artifacts in this template.
+## Planning Model
+- small, transient work may use a short local plan without a committed plan file
+- complex or multi-step work should create an execution plan in `docs/exec-plans/active/`
+- finished execution plans move to `docs/exec-plans/completed/`
+- known cleanup and follow-up items live in `docs/exec-plans/tech-debt-tracker.md`
+- repeated operational work belongs in `docs/exec-plans/repeated-work.md`
+## Required Sections For Execution Plans
+Every execution plan in `active/` or `completed/` should include:
+- `## Status`
+- `## Scope`
+- `## Steps`
+- `## Progress Log`
+- `## Decision Log`
+## Operating Rule
+Execution plans, completed plans, and tech debt are all versioned and stored in the repository so agents can work without hidden external context.

package/templates/next-fastapi-monorepo/docs/PRODUCT_SENSE.md ADDED Viewed

@@ -0,0 +1,11 @@
+# Product Sense
+This starter is optimized for teams that want a Next.js frontend and a Python API with strict boundaries from day one.
+The default experience should communicate:
+- the frontend is ready immediately
+- the API has a minimal health surface
+- architecture boundaries are not optional
+Detailed specs live in `product-specs/`.

package/templates/next-fastapi-monorepo/docs/QUALITY_SCORE.md ADDED Viewed

@@ -0,0 +1,16 @@
+# Quality Score
+Use this rubric when reviewing the starter or changes to it.
+## High Quality Means
+- frontend and backend layer rules are mechanically enforced
+- shared UI imports are obvious
+- route code stays thin
+- docs match the actual command surface
+## Red Flags
+- UI code bypassing `providers`
+- domain logic drifting into route files
+- docs that lag behind the template

package/templates/next-fastapi-monorepo/docs/RELIABILITY.md ADDED Viewed

@@ -0,0 +1,38 @@
+# Reliability
+## Local Commands
+Run from the repository root:
+```bash
+just install
+pnpm dev
+just lint
+just typecheck
+just test
+just ux
+just supply-chain
+just ci
+```
+Run the API directly when needed:
+```bash
+pnpm --filter api dev
+```
+## Lane Responsibilities
+- `just lint`: web lint, shared UI layer checks, Ruff, deptry, and import-linter
+- `just typecheck`: Next.js typecheck plus `basedpyright`
+- `just test`: Vitest plus `pytest`
+- `just ux`: Playwright, axe, and Lighthouse for the web app
+- `just supply-chain`: gitleaks, osv-scanner, `pnpm audit`, and `pip-audit`
+## CI
+GitHub Actions runs the build and test lanes defined in `.github/workflows/ci.yml`.
+## Doc Gardening
+Doc gardening is a repeated manual task tracked in `docs/exec-plans/repeated-work.md`.

package/templates/next-fastapi-monorepo/docs/SECURITY.md ADDED Viewed

@@ -0,0 +1,15 @@
+# Security
+This starter includes basic Node and Python supply-chain checks.
+## Included Checks
+- `gitleaks`
+- `osv-scanner`
+- `pnpm audit`
+- `pip-audit`
+## Expectations
+- do not commit secrets
+- keep Node and Python dependencies current

package/templates/next-fastapi-monorepo/docs/design-docs/core-beliefs.md ADDED Viewed

@@ -0,0 +1,6 @@
+# Core Beliefs
+- the starter should feel production-minded without feeling heavy
+- frontend and backend boundaries should be explicit from the first commit
+- API code should stay layered and easy to reason about
+- shared UI should remain easy to extend safely