Init commit with project codes

.dockerignore

@@ -0,0 +1,8 @@
+.git
+.next
+node_modules
+npm-debug.log
+.env
+.env.*
+!.env.example
+README.md

.env.example

@@ -0,0 +1,6 @@
+# Leave both BigQuery values empty to use the local in-memory demo directory.
+BIGQUERY_PROJECT_ID=
+BIGQUERY_DATASET=
+
+# Public canonical site URL, used for metadata and sitemap generation.
+NEXT_PUBLIC_SITE_URL=http://localhost:3000

.gitignore

@@ -0,0 +1,133 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+.pnpm-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# Snowpack dependency directory (https://snowpack.dev/)
+web_modules/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Optional stylelint cache
+.stylelintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variable files
+.env*
+!.env.example
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+.parcel-cache
+
+# Next.js build output
+.next
+out
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and not Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# vuepress v2.x temp and cache directory
+.temp
+.cache
+
+# vitepress build output
+**/.vitepress/dist
+
+# vitepress cache directory
+**/.vitepress/cache
+
+# Docusaurus cache and generated files
+.docusaurus
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# Stores VSCode versions used for testing VSCode extensions
+.vscode-test
+
+# yarn v2
+.yarn/cache
+.yarn/unplugged
+.yarn/build-state.yml
+.yarn/install-state.gz
+.pnp.*

AGENTS.md

@@ -0,0 +1,9 @@
+<!-- BEGIN:nextjs-agent-rules -->
+
+## This is NOT the Next.js you know
+
+This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in `node_modules/next/dist/docs/` (resolved from this file's directory; in monorepos the `next` package may not be visible from the repo root) before writing any code. Heed deprecation notices.
+
+This block is written and re-added by `next dev` — verify at `node_modules/next/dist/server/lib/generate-agent-files.js`. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.
+
+<!-- END:nextjs-agent-rules -->

Dockerfile

@@ -0,0 +1,25 @@
+FROM node:22-alpine AS dependencies
+WORKDIR /app
+COPY package.json package-lock.json ./
+RUN npm ci
+
+FROM node:22-alpine AS builder
+WORKDIR /app
+ENV NEXT_TELEMETRY_DISABLED=1
+COPY --from=dependencies /app/node_modules ./node_modules
+COPY . .
+RUN npm run build
+
+FROM node:22-alpine AS runner
+WORKDIR /app
+ENV NODE_ENV=production
+ENV NEXT_TELEMETRY_DISABLED=1
+ENV PORT=8080
+ENV HOSTNAME=0.0.0.0
+COPY --from=builder /app/public ./public
+COPY --from=builder /app/.next/standalone ./
+COPY --from=builder /app/.next/static ./.next/static
+RUN chown -R node:node /app
+USER node
+EXPOSE 8080
+CMD ["node", "server.js"]

README.md

@@ -0,0 +1,80 @@
+# Chainkit
+
+Chainkit is an SEO-friendly directory for discovering and sharing public, open-source AI tools used in supply chain planning, procurement, logistics, warehousing, and visibility. Tool detail pages are rendered on the server and included in the generated sitemap.
+
+## Features
+
+- Search and filter the directory by supply-chain category.
+- Sort tools by rating, review count, and recency.
+- Submit a project using its public GitHub repository URL.
+- Rate tools from one to five stars; a browser can update its own rating.
+- Per-tool metadata, canonical URLs, Open Graph tags, `robots.txt`, and `sitemap.xml`.
+- BigQuery persistence on Google Cloud, with an in-memory sample directory for local development.
+- Container deployment to Cloud Run.
+
+The local demo directory uses real public GitHub repository links as examples; they are marked as starter data and have no pre-filled community ratings.
+
+## Run locally
+
+Requirements: Node.js 22+ and npm.
+
+```sh
+npm ci
+copy .env.example .env.local
+npm run dev
+```
+
+Open [http://localhost:3000](http://localhost:3000). Without BigQuery settings the app starts in local demo mode. Local submissions and ratings are held in server memory and reset when the server restarts.
+
+## BigQuery
+
+1. Create a BigQuery dataset in the region you plan to use.
+2. Replace `YOUR_PROJECT_ID` and `YOUR_DATASET` in `infra/bigquery_schema.sql`, then run the SQL in the BigQuery console.
+3. Configure Application Default Credentials locally, or attach a runtime service account to Cloud Run.
+4. Set `BIGQUERY_PROJECT_ID`, `BIGQUERY_DATASET`, and `NEXT_PUBLIC_SITE_URL`.
+
+The runtime service account needs `roles/bigquery.jobUser` on the project and `roles/bigquery.dataEditor` on the dataset. The app uses parameterized values for BigQuery writes; project and dataset identifiers are validated before being inserted into query text.
+
+## Deploy to Cloud Run
+
+Build and deploy the container from the repository root. Supply your canonical
+domain if you already have one; otherwise omit `NEXT_PUBLIC_SITE_URL` on the
+first deployment:
+
+```sh
+gcloud run deploy chainkit \
+  --source . \
+  --region us-central1 \
+  --allow-unauthenticated \
+  --service-account chainkit-runtime@YOUR_PROJECT_ID.iam.gserviceaccount.com \
+  --set-env-vars BIGQUERY_PROJECT_ID=YOUR_PROJECT_ID,BIGQUERY_DATASET=YOUR_DATASET
+```
+
+After deployment, set `NEXT_PUBLIC_SITE_URL` to the Cloud Run URL or your
+canonical domain so canonical links and the sitemap match the live site:
+
+```sh
+gcloud run services describe chainkit --region us-central1 --format="value(status.url)"
+gcloud run services update chainkit \
+  --region us-central1 \
+  --update-env-vars NEXT_PUBLIC_SITE_URL=https://YOUR_CANONICAL_DOMAIN
+```
+
+The deployer needs permission to build/deploy the service and to act as the
+runtime service account.
+
+## Important production considerations
+
+- Submissions are immediately public in this starter. Add moderation or an approval workflow before opening submissions to an untrusted audience.
+- Ratings use a random browser-local identifier, not an authenticated user identity. It supports repeat edits from the same browser but is not abuse-resistant; add sign-in and rate limiting before treating ratings as verified.
+- The repository URL is validated and stored as a link. Chainkit does not clone, fetch, or execute submitted code.
+- BigQuery is optimized for analytics rather than high-volume transactional writes. For substantial rating or submission traffic, consider a transactional store and retain BigQuery for analytics.
+
+## Project structure
+
+```text
+src/app/            Next.js pages, SEO routes, and API endpoints
+src/lib/tools.ts    BigQuery adapter and local demo data
+infra/              BigQuery table schema
+Dockerfile           Cloud Run container
+```

eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

infra/bigquery_schema.sql

@@ -0,0 +1,23 @@
+CREATE TABLE IF NOT EXISTS `YOUR_PROJECT_ID.YOUR_DATASET.tools` (
+  tool_id STRING NOT NULL,
+  slug STRING NOT NULL,
+  name STRING NOT NULL,
+  summary STRING NOT NULL,
+  category STRING NOT NULL,
+  repo_url STRING NOT NULL,
+  website_url STRING,
+  submitted_by STRING NOT NULL,
+  created_at TIMESTAMP NOT NULL
+)
+PARTITION BY DATE(created_at)
+CLUSTER BY category, slug;
+
+CREATE TABLE IF NOT EXISTS `YOUR_PROJECT_ID.YOUR_DATASET.tool_ratings` (
+  tool_id STRING NOT NULL,
+  voter_id STRING NOT NULL,
+  rating INT64 NOT NULL,
+  created_at TIMESTAMP NOT NULL,
+  updated_at TIMESTAMP NOT NULL
+)
+PARTITION BY DATE(created_at)
+CLUSTER BY tool_id, voter_id;

next-env.d.ts

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

next.config.ts

@@ -0,0 +1,15 @@
+import type { NextConfig } from "next";
+
+const nextConfig: NextConfig = {
+  output: "standalone",
+  turbopack: {
+    rules: {
+      "*.css": {
+        loaders: ["@tailwindcss/turbopack"],
+        as: "*.css",
+      },
+    },
+  },
+};
+
+export default nextConfig;

package.json

@@ -0,0 +1,31 @@
+{
+  "name": "chainkit",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "prestart": "node scripts/prepare-standalone.mjs",
+    "start": "node .next/standalone/server.js",
+    "lint": "eslint",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@google-cloud/bigquery": "^9.6.0",
+    "lucide-react": "^1.70.0",
+    "next": "16.4.5",
+    "react": "19.3.0",
+    "react-dom": "19.3.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@tailwindcss/turbopack": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.4.5",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}

scripts/prepare-standalone.mjs

@@ -0,0 +1,7 @@
+import { cp, mkdir } from "node:fs/promises";
+
+for (const path of ["public", ".next/static"]) {
+  const destination = `.next/standalone/${path}`;
+  await mkdir(destination, { recursive: true });
+  await cp(path, destination, { recursive: true, force: true });
+}

src/app/api/ratings/route.ts

@@ -0,0 +1,44 @@
+import { NextResponse } from "next/server";
+import { z } from "zod";
+import { rateTool } from "@/lib/tools";
+
+const ratingSchema = z.object({
+  toolId: z.string().min(1).max(80),
+  voterId: z.string().uuid(),
+  rating: z.number().int().min(1).max(5),
+});
+
+export async function POST(request: Request) {
+  let body: unknown;
+  try {
+    body = await request.json();
+  } catch {
+    return NextResponse.json({ error: "Request body must be valid JSON." }, { status: 400 });
+  }
+
+  const parsed = ratingSchema.safeParse(body);
+  if (!parsed.success) {
+    return NextResponse.json({ error: "A valid tool and a 1–5 star rating are required." }, { status: 400 });
+  }
+
+  try {
+    const tool = await rateTool(
+      parsed.data.toolId,
+      parsed.data.voterId,
+      parsed.data.rating,
+    );
+    if (!tool) {
+      return NextResponse.json({ error: "Tool not found." }, { status: 404 });
+    }
+    return NextResponse.json({
+      averageRating: tool.averageRating,
+      ratingCount: tool.ratingCount,
+    });
+  } catch (error) {
+    console.error("Tool rating failed", error);
+    return NextResponse.json(
+      { error: "Your rating could not be saved. Please try again later." },
+      { status: 500 },
+    );
+  }
+}

src/app/api/tools/route.ts

@@ -0,0 +1,69 @@
+import { NextResponse } from "next/server";
+import { z } from "zod";
+import { categories } from "@/lib/tool-types";
+import { submitTool } from "@/lib/tools";
+
+const githubRepoUrl = z
+  .string()
+  .url()
+  .refine((value) => {
+    try {
+      const url = new URL(value);
+      return (
+        url.protocol === "https:" &&
+        url.hostname === "github.com" &&
+        !url.username &&
+        !url.password &&
+        !url.search &&
+        !url.hash &&
+        /^\/[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+(?:\.git)?\/?$/.test(url.pathname)
+      );
+    } catch {
+      return false;
+    }
+  }, "Enter a public GitHub repository URL.");
+
+const optionalWebsiteUrl = z
+  .union([z.literal(""), z.string().url()])
+  .refine((value) => {
+    if (!value) return true;
+    const url = new URL(value);
+    return url.protocol === "https:" && !url.username && !url.password;
+  }, "Website must be a public HTTPS URL.");
+
+const submissionSchema = z.object({
+  name: z.string().trim().min(2).max(80),
+  summary: z.string().trim().min(20).max(300),
+  category: z.enum(categories),
+  repoUrl: githubRepoUrl,
+  websiteUrl: optionalWebsiteUrl,
+  submittedBy: z.string().trim().min(2).max(60),
+});
+
+export async function POST(request: Request) {
+  let body: unknown;
+  try {
+    body = await request.json();
+  } catch {
+    return NextResponse.json({ error: "Request body must be valid JSON." }, { status: 400 });
+  }
+
+  const parsed = submissionSchema.safeParse(body);
+  if (!parsed.success) {
+    return NextResponse.json(
+      { error: "Please review the submission fields and try again.", fields: parsed.error.flatten().fieldErrors },
+      { status: 400 },
+    );
+  }
+
+  try {
+    const tool = await submitTool(parsed.data);
+    return NextResponse.json({ tool }, { status: 201 });
+  } catch (error) {
+    console.error("Tool submission failed", error);
+    return NextResponse.json(
+      { error: "The tool could not be saved. Please try again later." },
+      { status: 500 },
+    );
+  }
+}

src/app/directory.tsx

@@ -0,0 +1,409 @@
+"use client";
+
+import Link from "next/link";
+import { useEffect, useMemo, useRef, useState } from "react";
+import {
+  ArrowDownUp,
+  ArrowRight,
+  ArrowUpRight,
+  Boxes,
+  Check,
+  ChevronDown,
+  CircleHelp,
+  GitFork,
+  Globe2,
+  Moon,
+  Plus,
+  Search,
+  Sparkles,
+  Sun,
+  X,
+} from "lucide-react";
+import { categories, type SupplyChainTool, type ToolCategory } from "@/lib/tool-types";
+import { ToolRating } from "@/app/tool-rating";
+
+type Props = { initialTools: SupplyChainTool[] };
+
+type FormFields = {
+  name: string;
+  summary: string;
+  category: ToolCategory;
+  repoUrl: string;
+  websiteUrl: string;
+  submittedBy: string;
+};
+
+function ThemeToggle() {
+  useEffect(() => {
+    const savedTheme = window.localStorage.getItem("chainkit-theme");
+    const prefersDark = window.matchMedia("(prefers-color-scheme: dark)").matches;
+    const shouldUseDark = savedTheme ? savedTheme === "dark" : prefersDark;
+    document.documentElement.classList.toggle("theme-dark", shouldUseDark);
+  }, []);
+
+  function toggleTheme() {
+    const nextDark = !document.documentElement.classList.contains("theme-dark");
+    document.documentElement.classList.toggle("theme-dark", nextDark);
+    window.localStorage.setItem("chainkit-theme", nextDark ? "dark" : "light");
+  }
+
+  return (
+    <button className="theme-toggle" onClick={toggleTheme} aria-label="Toggle color theme">
+      <Moon size={16} className="moon-icon" />
+      <Sun size={16} className="sun-icon" />
+    </button>
+  );
+}
+
+const emptyForm: FormFields = {
+  name: "",
+  summary: "",
+  category: "Planning",
+  repoUrl: "",
+  websiteUrl: "",
+  submittedBy: "",
+};
+
+export function Directory({ initialTools }: Props) {
+  const [tools, setTools] = useState(initialTools);
+  const [search, setSearch] = useState("");
+  const searchRef = useRef<HTMLInputElement>(null);
+  const [category, setCategory] = useState("All tools");
+  const [sort, setSort] = useState("Featured");
+  const [showForm, setShowForm] = useState(false);
+  const [form, setForm] = useState(emptyForm);
+  const [submitting, setSubmitting] = useState(false);
+  const [submitError, setSubmitError] = useState("");
+  const [submitted, setSubmitted] = useState(false);
+
+  useEffect(() => {
+    function focusSearch(event: KeyboardEvent) {
+      const activeElement = document.activeElement;
+      const isEditing =
+        activeElement instanceof HTMLElement &&
+        (activeElement.isContentEditable ||
+          ["INPUT", "TEXTAREA", "SELECT"].includes(activeElement.tagName));
+      if (event.key === "/" && !isEditing) {
+        event.preventDefault();
+        searchRef.current?.focus();
+      }
+    }
+
+    window.addEventListener("keydown", focusSearch);
+    return () => window.removeEventListener("keydown", focusSearch);
+  }, []);
+
+  const filteredTools = useMemo(() => {
+    const query = search.trim().toLowerCase();
+    const filtered = tools.filter((tool) => {
+      const matchesCategory = category === "All tools" || tool.category === category;
+      const matchesQuery =
+        !query ||
+        [tool.name, tool.summary, tool.category, tool.repoUrl]
+          .join(" ")
+          .toLowerCase()
+          .includes(query);
+      return matchesCategory && matchesQuery;
+    });
+
+    return [...filtered].sort((a, b) => {
+      if (sort === "Top rated") return b.averageRating - a.averageRating;
+      if (sort === "Most reviewed") return b.ratingCount - a.ratingCount;
+      if (sort === "Recently added")
+        return new Date(b.createdAt).getTime() - new Date(a.createdAt).getTime();
+      return b.ratingCount - a.ratingCount || b.averageRating - a.averageRating;
+    });
+  }, [category, search, sort, tools]);
+
+  async function handleSubmit(event: React.FormEvent<HTMLFormElement>) {
+    event.preventDefault();
+    setSubmitting(true);
+    setSubmitError("");
+    try {
+      const response = await fetch("/api/tools", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify(form),
+      });
+      const data = (await response.json()) as {
+        tool?: SupplyChainTool;
+        error?: string;
+        fields?: Record<string, string[] | undefined>;
+      };
+      if (!response.ok) {
+        const detail = Object.values(data.fields ?? {}).flat().find(Boolean);
+        throw new Error(detail || data.error || "Your submission could not be saved.");
+      }
+      const newTool = data.tool;
+      if (newTool) {
+        setTools((current) => [newTool, ...current]);
+        setSearch("");
+        setCategory("All tools");
+        setSort("Recently added");
+      }
+      setSubmitted(true);
+      setForm(emptyForm);
+    } catch (error) {
+      setSubmitError(error instanceof Error ? error.message : "Something went wrong. Please try again.");
+    } finally {
+      setSubmitting(false);
+    }
+  }
+
+  const updateForm = <K extends keyof FormFields>(key: K, value: FormFields[K]) =>
+    setForm((current) => ({ ...current, [key]: value }));
+
+  return (
+    <>
+      <header className="site-header">
+        <div className="header-inner">
+          <Link className="brand" href="/" aria-label="Chainkit home">
+            <span className="brand-icon"><Boxes size={19} strokeWidth={2.2} /></span>
+            <span>chainkit<span className="brand-period">.</span></span>
+          </Link>
+          <nav className="header-nav" aria-label="Main navigation">
+            <a href="#directory" className="nav-link is-active">Explore tools</a>
+            <a href="#how-it-works" className="nav-link">About</a>
+          </nav>
+          <div className="header-actions">
+            <ThemeToggle />
+            <button className="button button-small button-primary header-submit" onClick={() => { setShowForm(true); setSubmitted(false); }}>
+              <Plus size={16} aria-hidden="true" /> Submit a tool
+            </button>
+          </div>
+        </div>
+      </header>
+
+      <main>
+        <section className="hero">
+          <div className="hero-glow" aria-hidden="true" />
+          <div className="hero-content">
+            <div className="eyebrow"><span className="eyebrow-dot" /> THE OPEN SUPPLY CHAIN AI INDEX</div>
+            <h1>Find the AI tools<br />moving supply chains <span>forward.</span></h1>
+            <p className="hero-copy">
+              A community-built directory of open-source AI projects for planning, procurement, logistics, and beyond.
+            </p>
+            <div className="hero-actions">
+              <a className="button button-primary hero-cta" href="#directory">
+                Explore the directory <ArrowRight size={16} aria-hidden="true" />
+              </a>
+              <button className="button button-quiet" onClick={() => { setShowForm(true); setSubmitted(false); }}>
+                <Plus size={16} aria-hidden="true" /> Add your project
+              </button>
+            </div>
+            <div className="hero-proof">
+              <div className="avatar-stack" aria-hidden="true">
+                <span>AI</span><span>SC</span><span>ML</span><span>+</span>
+              </div>
+              <span>Built by practitioners, for practitioners</span>
+            </div>
+          </div>
+          <div className="hero-art" aria-hidden="true">
+            <div className="art-orbit orbit-outer" />
+            <div className="art-orbit orbit-inner" />
+            <div className="art-core"><Sparkles size={26} /></div>
+            <div className="art-node node-top"><span className="node-mark"><Sparkles size={15} /></span><span>AI PLANNING</span></div>
+            <div className="art-node node-right"><span className="node-mark"><GitFork size={15} /></span><span>OPEN SOURCE</span></div>
+            <div className="art-node node-bottom"><span className="node-mark"><Globe2 size={15} /></span><span>GLOBAL NETWORK</span></div>
+            <div className="art-node node-left"><span className="node-mark"><Boxes size={15} /></span><span>SUPPLY CHAIN</span></div>
+          </div>
+          <div className="hero-bottom-line">
+            <span>Discover what’s being built</span>
+            <span className="line" />
+            <span>01 / 05</span>
+          </div>
+        </section>
+
+        <section className="directory-section" id="directory">
+          <div className="section-heading">
+            <div>
+              <div className="section-kicker">THE DIRECTORY</div>
+              <h2>Explore the ecosystem<span className="heading-dot">.</span></h2>
+              <p>Find your next building block in the supply chain AI landscape.</p>
+            </div>
+            <div className="directory-count">
+              <span className="count-number">{tools.length.toString().padStart(2, "0")}</span>
+              <span>indexed<br />projects</span>
+            </div>
+          </div>
+
+          <div className="directory-toolbar">
+            <div className="search-field">
+              <Search size={17} aria-hidden="true" />
+              <input
+                ref={searchRef}
+                type="search"
+                placeholder="Search projects, use cases..."
+                value={search}
+                onChange={(event) => setSearch(event.target.value)}
+                aria-label="Search projects"
+              />
+              <kbd>/</kbd>
+            </div>
+            <label className="sort-control">
+              <ArrowDownUp size={15} aria-hidden="true" />
+              <span className="sort-label">Sort:</span>
+              <select value={sort} onChange={(event) => setSort(event.target.value)} aria-label="Sort projects">
+                <option>Featured</option>
+                <option>Top rated</option>
+                <option>Most reviewed</option>
+                <option>Recently added</option>
+              </select>
+              <ChevronDown size={14} className="select-chevron" aria-hidden="true" />
+            </label>
+          </div>
+
+          <div className="category-list" role="group" aria-label="Filter by category">
+            {["All tools", ...categories].map((item) => (
+              <button
+                className={`category-tab${category === item ? " selected" : ""}`}
+                key={item}
+                onClick={() => setCategory(item)}
+                aria-pressed={category === item}
+              >
+                {item}
+                {item === "All tools" ? <span className="tab-count">{tools.length}</span> : null}
+              </button>
+            ))}
+          </div>
+
+          {filteredTools.length ? (
+            <div className="tool-grid">
+              {filteredTools.map((tool, index) => (
+                <article className="tool-card" key={tool.id}>
+                  <div className="card-top">
+                    <span className={`tool-mark mark-${index % 5}`} aria-hidden="true">
+                      {index % 5 === 0 ? <Sparkles size={18} /> : index % 5 === 1 ? <GitFork size={18} /> : index % 5 === 2 ? <Boxes size={18} /> : index % 5 === 3 ? <Globe2 size={18} /> : <CircleHelp size={18} />}
+                    </span>
+                    <span className="category-chip">{tool.category}</span>
+                    <a className="external-icon" href={tool.repoUrl} target="_blank" rel="noopener noreferrer" aria-label={`Open ${tool.name} GitHub repository`}>
+                      <ArrowUpRight size={17} />
+                    </a>
+                  </div>
+                  <Link className="card-title-link" href={`/tools/${tool.slug}`}>
+                    <h3>{tool.name}</h3>
+                  </Link>
+                  <p className="card-summary">{tool.summary}</p>
+                  <div className="repo-line">
+                    <span className="github-mark" aria-hidden="true">⌘</span>
+                    <span>{tool.repoUrl.replace("https://github.com/", "").replace(/\/$/, "")}</span>
+                  </div>
+                  <div className="card-footer">
+                    <ToolRating
+                      toolId={tool.id}
+                      initialRating={tool.averageRating}
+                      initialCount={tool.ratingCount}
+                    />
+                    <Link href={`/tools/${tool.slug}`} className="card-view-link">
+                      View details <ArrowRight size={14} />
+                    </Link>
+                  </div>
+                </article>
+              ))}
+            </div>
+          ) : (
+            <div className="empty-state">
+              <Search size={22} />
+              <h3>No matching projects</h3>
+              <p>Try a different search or category.</p>
+              <button className="button button-secondary" onClick={() => { setSearch(""); setCategory("All tools"); }}>
+                Clear filters
+              </button>
+            </div>
+          )}
+          <div className="directory-foot">
+            <span>Showing <strong>{filteredTools.length}</strong> of <strong>{tools.length}</strong> projects</span>
+            <button className="button button-outline" onClick={() => { setShowForm(true); setSubmitted(false); }}>
+              Share a project <ArrowUpRight size={15} />
+            </button>
+          </div>
+        </section>
+
+        <section className="community-section" id="how-it-works">
+          <div className="community-icon"><Sparkles size={19} /></div>
+          <div className="community-copy">
+            <div className="section-kicker">A BETTER SUPPLY CHAIN, TOGETHER</div>
+            <h2>Good tools deserve to be found.</h2>
+            <p>Submit an open-source project, share what works, and help the community find its next idea.</p>
+          </div>
+          <button className="button button-primary community-cta" onClick={() => { setShowForm(true); setSubmitted(false); }}>
+            Submit a tool <ArrowUpRight size={16} />
+          </button>
+        </section>
+      </main>
+
+      <footer className="site-footer">
+        <Link className="brand footer-brand" href="/">
+          <span className="brand-icon"><Boxes size={17} /></span>
+          <span>chainkit<span className="brand-period">.</span></span>
+        </Link>
+        <span>Open source meets the supply chain.</span>
+        <a href="https://github.com/" target="_blank" rel="noopener noreferrer">Built for the community <ArrowUpRight size={13} /></a>
+      </footer>
+
+      {showForm ? (
+        <div
+          className="modal-backdrop"
+          onKeyDown={(event) => { if (event.key === "Escape") setShowForm(false); }}
+          onMouseDown={(event) => { if (event.target === event.currentTarget) setShowForm(false); }}
+        >
+          <section className="submit-modal" role="dialog" aria-modal="true" aria-labelledby="modal-heading">
+            <button className="modal-close" onClick={() => setShowForm(false)} aria-label="Close submission form">
+              <X size={19} />
+            </button>
+            {submitted ? (
+              <div className="success-panel">
+                <div className="success-icon"><Check size={23} /></div>
+                <div className="section-kicker">YOU’RE IN THE INDEX</div>
+                <h2 id="modal-heading">Thanks for sharing.</h2>
+                <p>Your project has been added to the community directory.</p>
+                <button className="button button-primary" onClick={() => setShowForm(false)}>Back to exploring</button>
+              </div>
+            ) : (
+              <>
+                <div className="section-kicker">GROW THE ECOSYSTEM</div>
+                <h2 id="modal-heading">Submit a tool<span className="heading-dot">.</span></h2>
+                <p className="modal-intro">Share an open-source project that helps move supply chains forward.</p>
+                <form className="submit-form" onSubmit={(event) => void handleSubmit(event)}>
+                  <label>
+                    Project name
+                    <input required minLength={2} maxLength={80} value={form.name} onChange={(event) => updateForm("name", event.target.value)} placeholder="e.g. Demand Forecaster" />
+                  </label>
+                  <label>
+                    What does it do?
+                    <textarea required minLength={20} maxLength={300} value={form.summary} onChange={(event) => updateForm("summary", event.target.value)} placeholder="A short, clear description of the project..." rows={3} />
+                  </label>
+                  <div className="form-row">
+                    <label>
+                      Category
+                      <select value={form.category} onChange={(event) => updateForm("category", event.target.value as ToolCategory)}>
+                        {categories.map((item) => <option key={item}>{item}</option>)}
+                      </select>
+                    </label>
+                    <label>
+                      Your name or handle
+                      <input required minLength={2} maxLength={60} value={form.submittedBy} onChange={(event) => updateForm("submittedBy", event.target.value)} placeholder="How should we credit you?" />
+                    </label>
+                  </div>
+                  <label>
+                    Public GitHub repository
+                    <input required type="url" value={form.repoUrl} onChange={(event) => updateForm("repoUrl", event.target.value)} placeholder="https://github.com/owner/repository" />
+                  </label>
+                  <label>
+                    Project website <span className="optional-label">optional</span>
+                    <input type="url" value={form.websiteUrl} onChange={(event) => updateForm("websiteUrl", event.target.value)} placeholder="https://your-project.com" />
+                  </label>
+                  {submitError ? <p className="form-error" role="alert">{submitError}</p> : null}
+                  <button className="button button-primary form-submit" type="submit" disabled={submitting}>
+                    {submitting ? "Submitting..." : "Submit project"} {!submitting ? <ArrowUpRight size={16} /> : null}
+                  </button>
+                  <p className="form-disclaimer">Only public GitHub repositories are accepted. Please submit projects you have permission to share.</p>
+                </form>
+              </>
+            )}
+          </section>
+        </div>
+      ) : null}
+    </>
+  );
+}

src/app/globals.css

@@ -0,0 +1,396 @@
+@import "tailwindcss";
+
+:root {
+  color-scheme: light;
+  --page: #f9f9f7;
+  --surface: #ffffff;
+  --surface-soft: #f5f5f2;
+  --ink: #17231e;
+  --ink-soft: #55645d;
+  --muted: #78827c;
+  --line: #e4e9e5;
+  --accent: #c5f36b;
+  --accent-dark: #1d392c;
+  --green: #34674d;
+  --green-soft: #eef5eb;
+  --shadow: 0 14px 42px rgba(23, 45, 32, 0.06);
+}
+
+html.theme-dark {
+  color-scheme: dark;
+  --page: #101713;
+  --surface: #17211b;
+  --surface-soft: #202b23;
+  --ink: #eff5ef;
+  --ink-soft: #c0ccc3;
+  --muted: #94a49a;
+  --line: #2e3b32;
+  --accent: #c5f36b;
+  --accent-dark: #1d392c;
+  --green: #b6d59c;
+  --green-soft: #223226;
+  --shadow: 0 14px 42px rgba(0, 0, 0, 0.2);
+}
+
+@theme inline {
+  --font-sans: var(--font-dm-sans);
+  --font-mono: var(--font-jetbrains-mono);
+}
+
+* { box-sizing: border-box; }
+html { scroll-behavior: smooth; }
+body {
+  margin: 0;
+  background: var(--page);
+  color: var(--ink);
+  font-family: var(--font-dm-sans), sans-serif;
+  transition: background-color 180ms ease, color 180ms ease;
+}
+button, input, textarea, select { font: inherit; }
+button, a, select { -webkit-tap-highlight-color: transparent; }
+button { cursor: pointer; }
+a { color: inherit; text-decoration: none; }
+::selection { color: #17231e; background: #d3f7a4; }
+
+.site-header {
+  height: 74px;
+  position: relative;
+  z-index: 20;
+  border-bottom: 1px solid var(--line);
+  background: var(--surface);
+}
+.header-inner {
+  width: min(1200px, calc(100% - 64px));
+  height: 100%;
+  margin: 0 auto;
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+}
+.brand { display: inline-flex; align-items: center; gap: 9px; font-size: 19px; font-weight: 750; letter-spacing: -0.8px; }
+.brand-icon {
+  width: 31px; height: 31px; display: grid; place-items: center;
+  color: var(--accent-dark); background: var(--accent); border-radius: 9px;
+}
+.brand-period, .heading-dot { color: #8dbd48; }
+.header-nav { display: flex; align-items: center; gap: 34px; margin-left: 35px; }
+.nav-link { color: var(--muted); font-size: 13px; font-weight: 550; transition: color 160ms ease; }
+.nav-link:hover, .nav-link.is-active { color: var(--ink); }
+.header-actions { display: flex; align-items: center; gap: 10px; }
+.theme-toggle {
+  width: 38px; height: 38px; display: grid; place-items: center;
+  border: 1px solid var(--line); border-radius: 50%; background: var(--surface);
+  color: var(--ink-soft); transition: background-color 160ms ease, border-color 160ms ease;
+}
+.theme-toggle:hover { background: var(--surface-soft); border-color: var(--muted); }
+.sun-icon, .theme-dark .theme-toggle .moon-icon { display: none; }
+.theme-dark .theme-toggle .sun-icon { display: block; }
+
+.button {
+  min-height: 42px;
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  gap: 9px;
+  padding: 0 17px;
+  border: 1px solid transparent;
+  border-radius: 8px;
+  font-size: 13px;
+  font-weight: 650;
+  transition: transform 160ms ease, background-color 160ms ease, border-color 160ms ease, color 160ms ease, box-shadow 160ms ease;
+}
+.button:hover:not(:disabled) { transform: translateY(-1px); }
+.button:disabled { cursor: wait; opacity: 0.65; }
+.button-primary { background: var(--accent); color: #1b2b1d; box-shadow: 0 4px 12px rgba(151, 194, 80, 0.13); }
+.button-primary:hover:not(:disabled) { background: #d0f783; box-shadow: 0 6px 16px rgba(151, 194, 80, 0.2); }
+.button-secondary { border-color: var(--line); background: var(--surface); color: var(--ink); }
+.button-secondary:hover:not(:disabled), .button-outline:hover:not(:disabled) { border-color: #bac8b8; background: var(--surface-soft); }
+.button-quiet { color: var(--ink-soft); background: transparent; }
+.button-quiet:hover:not(:disabled) { background: var(--surface); }
+.button-outline { border-color: var(--line); background: var(--surface); color: var(--ink-soft); }
+.button-small { min-height: 37px; padding: 0 13px; font-size: 12px; }
+
+.hero {
+  min-height: 505px;
+  position: relative;
+  overflow: hidden;
+  background:
+    radial-gradient(ellipse at 75% 48%, rgba(196, 243, 107, 0.12), transparent 35%),
+    var(--surface);
+  border-bottom: 1px solid var(--line);
+}
+.hero-content { width: min(1200px, calc(100% - 64px)); position: relative; z-index: 2; margin: 0 auto; padding: 78px 0 82px; }
+.eyebrow, .section-kicker {
+  display: flex; align-items: center; gap: 9px;
+  color: #637a60; font-family: var(--font-jetbrains-mono), monospace;
+  font-size: 10px; font-weight: 550; letter-spacing: 1.15px;
+}
+.eyebrow-dot { width: 7px; height: 7px; border-radius: 50%; background: #94c454; box-shadow: 0 0 0 4px rgba(148, 196, 84, 0.14); }
+.hero h1 {
+  max-width: 650px;
+  margin: 24px 0 17px;
+  font-size: clamp(42px, 5.2vw, 67px);
+  line-height: 1.045;
+  letter-spacing: -3.2px;
+  font-weight: 650;
+}
+.hero h1 span { color: #6b9650; }
+.hero-copy { max-width: 470px; margin: 0; color: var(--ink-soft); font-size: 15px; line-height: 1.75; }
+.hero-actions { display: flex; align-items: center; gap: 14px; margin-top: 26px; }
+.hero-cta { min-height: 46px; }
+.hero-proof { display: flex; align-items: center; gap: 12px; margin-top: 42px; color: var(--muted); font-size: 11px; }
+.avatar-stack { display: flex; align-items: center; padding-left: 1px; }
+.avatar-stack span {
+  width: 25px; height: 25px; display: grid; place-items: center; margin-left: -4px;
+  border: 2px solid var(--surface); border-radius: 50%; background: #c9dfa9;
+  color: #30402d; font-size: 7px; font-weight: 800;
+}
+.avatar-stack span:nth-child(2) { background: #e3c9a9; }
+.avatar-stack span:nth-child(3) { background: #c6d8d1; }
+.avatar-stack span:nth-child(4) { background: #e6e9e0; font-size: 9px; }
+.hero-art {
+  width: 425px; height: 425px; position: absolute; z-index: 1;
+  top: 31px; right: max(calc((100vw - 1200px) / 2 + 5px), 20px);
+  border-radius: 50%; opacity: 0.95;
+}
+.hero-art::before, .hero-art::after {
+  content: ""; position: absolute; inset: 44px; border: 1px solid var(--line); border-radius: 50%;
+}
+.hero-art::after { inset: 92px; border-style: dashed; opacity: 0.85; }
+.art-orbit { position: absolute; inset: 75px; border: 1px solid rgba(135, 165, 111, 0.26); border-radius: 50%; transform: rotate(-35deg) scaleX(0.82); }
+.orbit-inner { inset: 120px; transform: rotate(38deg) scaleX(1.45); border-style: dashed; }
+.art-core {
+  width: 79px; height: 79px; position: absolute; top: 173px; left: 173px; z-index: 2;
+  display: grid; place-items: center; border: 1px solid #d5e6c6; border-radius: 25px;
+  background: linear-gradient(145deg, #f8fff0, #e8f3dc); color: #5a8250;
+  box-shadow: 0 0 0 12px rgba(206, 232, 183, 0.2), 0 12px 35px rgba(45, 79, 45, 0.1);
+}
+.art-node {
+  min-width: 144px; height: 43px; position: absolute; z-index: 3;
+  display: flex; align-items: center; gap: 8px; padding: 0 10px;
+  border: 1px solid var(--line); border-radius: 10px; background: var(--surface);
+  box-shadow: var(--shadow); color: var(--ink-soft); font-family: var(--font-jetbrains-mono), monospace;
+  font-size: 8px; letter-spacing: 0.35px;
+}
+.node-mark { width: 25px; height: 25px; display: grid; place-items: center; border-radius: 7px; background: #f0f5e9; color: #68894b; }
+.node-top { left: 140px; top: 19px; }
+.node-right { top: 187px; right: -14px; }
+.node-bottom { left: 134px; bottom: 17px; }
+.node-left { top: 188px; left: -9px; }
+.hero-bottom-line {
+  width: min(1200px, calc(100% - 64px)); position: absolute; bottom: 21px; left: 50%; z-index: 3;
+  display: flex; align-items: center; gap: 12px; transform: translateX(-50%);
+  color: #8a968e; font-family: var(--font-jetbrains-mono), monospace; font-size: 9px; letter-spacing: 0.65px;
+}
+.hero-bottom-line .line { width: 42px; height: 1px; background: #c3d0c2; }
+
+.directory-section { width: min(1200px, calc(100% - 64px)); margin: 0 auto; padding: 78px 0 76px; }
+.section-heading { display: flex; align-items: flex-end; justify-content: space-between; margin-bottom: 29px; }
+.section-kicker { color: #87958a; font-size: 9px; }
+.section-heading h2, .community-copy h2 {
+  margin: 10px 0 6px; font-size: 32px; font-weight: 650; letter-spacing: -1.3px; line-height: 1.2;
+}
+.section-heading p, .community-copy p { margin: 0; color: var(--muted); font-size: 13px; line-height: 1.6; }
+.directory-count { display: flex; align-items: center; gap: 12px; color: var(--muted); font-size: 10px; line-height: 1.45; }
+.count-number { color: var(--ink); font-family: var(--font-jetbrains-mono), monospace; font-size: 30px; letter-spacing: -2px; }
+.directory-toolbar { display: flex; align-items: center; justify-content: space-between; gap: 16px; }
+.search-field {
+  width: min(485px, 100%); height: 46px; display: flex; align-items: center; gap: 11px;
+  padding: 0 13px; border: 1px solid var(--line); border-radius: 8px;
+  background: var(--surface); color: #8a958e; transition: border-color 160ms ease, box-shadow 160ms ease;
+}
+.search-field:focus-within { border-color: #9ab67e; box-shadow: 0 0 0 3px rgba(143, 180, 111, 0.11); }
+.search-field input { width: 100%; min-width: 0; border: 0; outline: 0; background: transparent; color: var(--ink); font-size: 12px; }
+.search-field input::placeholder { color: #9aa39d; }
+.search-field kbd { padding: 2px 6px; border: 1px solid var(--line); border-radius: 4px; background: var(--surface-soft); color: #929b94; font-family: var(--font-jetbrains-mono), monospace; font-size: 10px; }
+.sort-control {
+  height: 42px; position: relative; z-index: 30; display: flex; align-items: center; gap: 8px;
+  padding: 0 12px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); color: var(--muted);
+}
+.sort-label { font-size: 11px; }
+.sort-control select { min-width: 91px; appearance: none; border: 0; outline: 0; background: transparent; color: var(--ink); font-size: 11px; font-weight: 600; cursor: pointer; }
+.select-chevron { pointer-events: none; }
+.category-list { display: flex; gap: 8px; overflow-x: auto; margin: 21px 0 20px; padding: 2px 1px 5px; scrollbar-width: none; }
+.category-list::-webkit-scrollbar { display: none; }
+.category-tab {
+  min-height: 34px; flex: 0 0 auto; display: inline-flex; align-items: center; gap: 8px; padding: 0 12px;
+  border: 1px solid transparent; border-radius: 6px; background: transparent; color: var(--muted);
+  font-size: 11px; font-weight: 550; transition: background-color 150ms ease, color 150ms ease, border-color 150ms ease;
+}
+.category-tab:hover { background: var(--surface); color: var(--ink); }
+.category-tab.selected { border-color: var(--line); background: var(--surface); color: var(--ink); box-shadow: 0 2px 5px rgba(19, 38, 24, 0.035); }
+.tab-count { min-width: 18px; padding: 2px 4px; border-radius: 4px; background: var(--surface-soft); color: var(--muted); font-family: var(--font-jetbrains-mono), monospace; font-size: 9px; text-align: center; }
+.tool-grid { display: grid; grid-template-columns: repeat(3, minmax(0, 1fr)); gap: 15px; }
+.tool-card {
+  min-width: 0; display: flex; flex-direction: column; min-height: 240px; padding: 19px 19px 15px;
+  border: 1px solid var(--line); border-radius: 11px; background: var(--surface);
+  transition: transform 180ms ease, box-shadow 180ms ease, border-color 180ms ease;
+}
+.tool-card:hover { transform: translateY(-3px); border-color: #d1dccd; box-shadow: var(--shadow); }
+.card-top { display: flex; align-items: center; gap: 9px; margin-bottom: 14px; }
+.tool-mark { width: 34px; height: 34px; display: grid; place-items: center; margin-right: 1px; border-radius: 9px; background: #edf5e6; color: #668d4d; }
+.mark-1 { background: #f2efe5; color: #987b4e; }
+.mark-2 { background: #e9f1ef; color: #648b7a; }
+.mark-3 { background: #f2eaf0; color: #946e88; }
+.mark-4 { background: #e9edf5; color: #6d7f9c; }
+.category-chip { display: inline-flex; align-items: center; padding: 5px 8px; border-radius: 5px; background: var(--green-soft); color: var(--green); font-size: 9px; font-weight: 650; }
+.external-icon { width: 28px; height: 28px; display: grid; place-items: center; margin-left: auto; border-radius: 6px; color: #99a39b; transition: background 150ms ease, color 150ms ease; }
+.external-icon:hover { background: var(--surface-soft); color: var(--ink); }
+.card-title-link { width: fit-content; }
+.tool-card h3 { margin: 0; color: var(--ink); font-size: 16px; font-weight: 650; letter-spacing: -0.35px; }
+.card-title-link:hover h3 { color: #618044; }
+.card-summary { display: -webkit-box; overflow: hidden; min-height: 40px; margin: 8px 0 14px; color: var(--ink-soft); font-size: 11px; line-height: 1.65; -webkit-line-clamp: 2; -webkit-box-orient: vertical; }
+.repo-line { display: flex; align-items: center; gap: 7px; overflow: hidden; color: #839087; font-family: var(--font-jetbrains-mono), monospace; font-size: 9px; text-overflow: ellipsis; white-space: nowrap; }
+.github-mark { width: 15px; height: 15px; display: inline-grid; flex: 0 0 auto; place-items: center; border: 1px solid #d7ded7; border-radius: 50%; color: #55645d; font-size: 8px; }
+.card-footer { display: flex; align-items: center; justify-content: space-between; gap: 8px; margin-top: auto; padding-top: 14px; border-top: 1px solid var(--line); }
+.rating-control { display: inline-flex; align-items: center; gap: 6px; min-width: 0; }
+.rating-stars { display: inline-flex; align-items: center; gap: 1px; }
+.star-button { display: inline-grid; place-items: center; padding: 1px; border: 0; background: transparent; color: #d7ddd4; transition: transform 120ms ease, color 120ms ease; }
+.star-button:hover:not(:disabled) { transform: scale(1.12); color: #d6a53f; }
+.star-button.is-filled { color: #d5a747; }
+.star-button:disabled { cursor: wait; opacity: 0.65; }
+.rating-count { color: var(--muted); font-family: var(--font-jetbrains-mono), monospace; font-size: 9px; white-space: nowrap; }
+.card-view-link { display: inline-flex; align-items: center; gap: 5px; color: #718b60; font-size: 10px; font-weight: 650; transition: color 140ms ease; }
+.card-view-link:hover { color: #3b6337; }
+.empty-state { min-height: 240px; display: flex; flex-direction: column; align-items: center; justify-content: center; gap: 9px; border: 1px dashed var(--line); border-radius: 10px; color: var(--muted); text-align: center; }
+.empty-state h3 { margin: 4px 0 0; color: var(--ink); font-size: 16px; }
+.empty-state p { margin: 0 0 8px; font-size: 12px; }
+.directory-foot { display: flex; align-items: center; justify-content: space-between; margin-top: 21px; color: var(--muted); font-size: 10px; }
+.directory-foot strong { color: var(--ink-soft); font-family: var(--font-jetbrains-mono), monospace; font-weight: 550; }
+.directory-foot .button { min-height: 36px; font-size: 11px; }
+
+.community-section {
+  width: min(1200px, calc(100% - 64px)); min-height: 176px; display: flex; align-items: center; gap: 20px;
+  margin: 0 auto 75px; padding: 29px 34px; border: 1px solid #dce5d5; border-radius: 13px;
+  background: linear-gradient(110deg, #f3f8ed 0%, #f9fbf6 55%, #eef5e7 100%);
+}
+.theme-dark .community-section { background: linear-gradient(110deg, #1d2b20 0%, #19241d 55%, #223023 100%); }
+.community-icon { width: 43px; height: 43px; display: grid; flex: 0 0 auto; place-items: center; border: 1px solid #dce9cf; border-radius: 12px; background: var(--surface); color: #72964e; }
+.community-copy { flex: 1; }
+.community-copy h2 { margin: 7px 0 4px; font-size: 22px; }
+.community-copy p { max-width: 520px; font-size: 11px; }
+.community-cta { flex: 0 0 auto; }
+.site-footer {
+  min-height: 69px; display: flex; align-items: center; justify-content: space-between; gap: 20px;
+  padding: 0 max(calc((100vw - 1200px) / 2), 32px); border-top: 1px solid var(--line);
+  background: var(--surface); color: var(--muted); font-size: 10px;
+}
+.footer-brand { color: var(--ink); font-size: 15px; }
+.footer-brand .brand-icon { width: 26px; height: 26px; border-radius: 7px; }
+.site-footer > a:last-child { display: inline-flex; align-items: center; gap: 5px; color: var(--ink-soft); }
+
+.modal-backdrop { position: fixed; inset: 0; z-index: 100; display: grid; overflow-y: auto; place-items: center; padding: 24px; background: rgba(15, 25, 18, 0.48); backdrop-filter: blur(4px); }
+.submit-modal { width: min(100%, 510px); position: relative; padding: 31px; border: 1px solid var(--line); border-radius: 14px; background: var(--surface); box-shadow: 0 30px 90px rgba(9, 20, 12, 0.25); }
+.modal-close { width: 34px; height: 34px; position: absolute; top: 16px; right: 16px; display: grid; place-items: center; border: 0; border-radius: 7px; background: transparent; color: var(--muted); transition: background 150ms ease; }
+.modal-close:hover { background: var(--surface-soft); color: var(--ink); }
+.submit-modal h2 { margin: 8px 0 5px; font-size: 27px; letter-spacing: -1px; }
+.modal-intro { margin: 0 0 21px; color: var(--muted); font-size: 12px; line-height: 1.6; }
+.submit-form { display: flex; flex-direction: column; gap: 13px; }
+.submit-form label { display: flex; flex-direction: column; gap: 6px; color: var(--ink-soft); font-size: 10px; font-weight: 650; }
+.submit-form input, .submit-form textarea, .submit-form select {
+  width: 100%; min-height: 40px; padding: 9px 11px; border: 1px solid var(--line); border-radius: 7px;
+  outline: 0; background: var(--surface); color: var(--ink); font-size: 11px; font-weight: 450;
+  transition: border-color 150ms ease, box-shadow 150ms ease;
+}
+.submit-form textarea { resize: vertical; line-height: 1.5; }
+.submit-form input:focus, .submit-form textarea:focus, .submit-form select:focus { border-color: #9ab67e; box-shadow: 0 0 0 3px rgba(143, 180, 111, 0.11); }
+.submit-form input::placeholder, .submit-form textarea::placeholder { color: #9aa39d; }
+.form-row { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; }
+.optional-label { color: #99a39b; font-weight: 450; }
+.form-error { margin: -1px 0 0; color: #bd4d43; font-size: 11px; }
+.form-submit { width: 100%; min-height: 44px; margin-top: 1px; }
+.form-disclaimer { margin: -5px 0 0; color: #929c94; font-size: 9px; line-height: 1.5; text-align: center; }
+.success-panel { display: flex; flex-direction: column; align-items: flex-start; padding: 18px 0 3px; }
+.success-icon { width: 45px; height: 45px; display: grid; place-items: center; margin-bottom: 21px; border-radius: 50%; background: #edf6e4; color: #5c8845; }
+.success-panel h2 { margin: 9px 0 6px; }
+.success-panel p { margin: 0 0 21px; color: var(--muted); font-size: 12px; }
+
+.detail-page { min-height: calc(100vh - 74px); padding: 55px 24px 80px; background: var(--page); }
+.detail-wrap { width: min(900px, 100%); margin: 0 auto; }
+.back-link { display: inline-flex; align-items: center; gap: 7px; margin-bottom: 19px; color: var(--muted); font-size: 12px; transition: color 140ms ease; }
+.back-link:hover { color: var(--ink); }
+.detail-card { padding: clamp(24px, 5vw, 48px); border: 1px solid var(--line); border-radius: 13px; background: var(--surface); box-shadow: var(--shadow); }
+.detail-topline { display: flex; align-items: center; justify-content: space-between; gap: 12px; }
+.detail-date { color: var(--muted); font-family: var(--font-jetbrains-mono), monospace; font-size: 9px; }
+.detail-card h1 { margin: 24px 0 12px; font-size: clamp(34px, 6vw, 52px); letter-spacing: -2.2px; line-height: 1.1; }
+.detail-summary { max-width: 670px; margin: 0; color: var(--ink-soft); font-size: 15px; line-height: 1.7; }
+.detail-rating { display: flex; align-items: center; gap: 7px; margin-top: 19px; color: #d0a03e; }
+.detail-rating strong { color: var(--ink); font-size: 13px; }
+.detail-rating span { color: var(--muted); font-size: 11px; }
+.detail-actions { display: flex; flex-wrap: wrap; gap: 10px; margin-top: 24px; }
+.detail-rating-panel { display: flex; align-items: center; justify-content: space-between; gap: 15px; margin-top: 36px; padding: 18px 19px; border: 1px solid var(--line); border-radius: 9px; background: var(--surface-soft); }
+.detail-rating-panel h2 { margin: 0 0 3px; font-size: 13px; }
+.detail-rating-panel p { margin: 0; color: var(--muted); font-size: 10px; }
+.rating-large { flex-direction: column; align-items: flex-end; gap: 4px; }
+.rating-large .rating-message { min-height: 13px; color: var(--muted); font-size: 9px; }
+.detail-meta { display: grid; grid-template-columns: 1fr 2fr; gap: 14px; margin: 25px 0 0; padding-top: 20px; border-top: 1px solid var(--line); }
+.detail-meta div { min-width: 0; }
+.detail-meta dt { margin-bottom: 7px; color: var(--muted); font-size: 9px; text-transform: uppercase; letter-spacing: 0.8px; }
+.detail-meta dd { overflow: hidden; margin: 0; color: var(--ink-soft); font-size: 11px; text-overflow: ellipsis; white-space: nowrap; }
+.detail-meta a { color: #6a8c50; }
+.detail-note { display: flex; align-items: center; justify-content: space-between; padding: 18px 2px; color: var(--muted); font-size: 10px; }
+.text-link { display: inline-flex; align-items: center; gap: 5px; color: var(--green); font-weight: 600; }
+
+@media (max-width: 900px) {
+  .hero-art { right: -85px; opacity: 0.48; }
+  .hero-content { z-index: 2; }
+  .tool-grid { grid-template-columns: repeat(2, minmax(0, 1fr)); }
+}
+@media (max-width: 620px) {
+  .site-header { height: 64px; }
+  .header-inner, .hero-content, .hero-bottom-line, .directory-section, .community-section { width: calc(100% - 36px); }
+  .header-nav { display: none; }
+  .header-inner { justify-content: space-between; }
+  .brand { font-size: 17px; }
+  .header-actions { gap: 6px; }
+  .theme-toggle { width: 34px; height: 34px; }
+  .header-submit { min-height: 34px; padding: 0 10px; font-size: 10px; }
+  .hero { min-height: 489px; }
+  .hero-content { padding: 63px 0 68px; }
+  .eyebrow { font-size: 8px; letter-spacing: 0.65px; }
+  .hero h1 { margin-top: 22px; font-size: clamp(39px, 11vw, 56px); letter-spacing: -2.4px; }
+  .hero-copy { max-width: 380px; font-size: 13px; }
+  .hero-actions { flex-wrap: wrap; gap: 6px; margin-top: 21px; }
+  .hero-actions .button { min-height: 40px; padding: 0 12px; font-size: 11px; }
+  .hero-proof { margin-top: 29px; font-size: 9px; }
+  .hero-art { width: 330px; height: 330px; top: 155px; right: -150px; opacity: 0.14; }
+  .art-core { top: 136px; left: 136px; }
+  .art-node { display: none; }
+  .hero-bottom-line { bottom: 17px; font-size: 8px; }
+  .directory-section { padding: 57px 0 54px; }
+  .section-heading { align-items: flex-end; gap: 10px; }
+  .section-heading h2 { font-size: 25px; letter-spacing: -0.9px; }
+  .section-heading p { max-width: 260px; font-size: 11px; }
+  .directory-count { gap: 6px; font-size: 8px; }
+  .count-number { font-size: 24px; }
+  .directory-toolbar { align-items: stretch; flex-direction: column; gap: 9px; }
+  .search-field { width: 100%; height: 43px; }
+  .sort-control { width: fit-content; height: 36px; align-self: flex-end; }
+  .category-list { margin-top: 14px; }
+  .tool-grid { grid-template-columns: minmax(0, 1fr); gap: 10px; }
+  .tool-card { min-height: 224px; padding: 16px; }
+  .directory-foot { align-items: flex-start; gap: 10px; }
+  .directory-foot .button { min-height: 33px; padding: 0 9px; font-size: 9px; }
+  .community-section { align-items: flex-start; flex-wrap: wrap; gap: 13px; margin-bottom: 45px; padding: 22px 18px; }
+  .community-icon { width: 36px; height: 36px; }
+  .community-copy { flex: 1 1 calc(100% - 55px); }
+  .community-copy h2 { font-size: 18px; }
+  .community-copy p { font-size: 10px; }
+  .community-cta { margin-left: 49px; }
+  .site-footer { min-height: 63px; flex-wrap: wrap; gap: 4px 12px; padding: 12px 18px; font-size: 8px; }
+  .site-footer > span { display: none; }
+  .submit-modal { padding: 27px 19px 21px; }
+  .form-row { grid-template-columns: 1fr; }
+  .detail-page { min-height: calc(100vh - 64px); padding: 31px 18px 50px; }
+  .detail-card { padding: 23px 18px; }
+  .detail-card h1 { margin-top: 20px; }
+  .detail-summary { font-size: 13px; }
+  .detail-actions .button { width: 100%; }
+  .detail-rating-panel { align-items: flex-start; flex-direction: column; }
+  .rating-large { align-items: flex-start; }
+  .detail-meta { grid-template-columns: 1fr; }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  *, *::before, *::after { scroll-behavior: auto !important; transition-duration: 0.01ms !important; animation-duration: 0.01ms !important; }
+}

src/app/layout.tsx

@@ -0,0 +1,33 @@
+import type { Metadata } from "next";
+import { DM_Sans, JetBrains_Mono } from "next/font/google";
+import "./globals.css";
+
+const dmSans = DM_Sans({
+  variable: "--font-dm-sans",
+  subsets: ["latin"],
+});
+
+const jetBrainsMono = JetBrains_Mono({
+  variable: "--font-jetbrains-mono",
+  subsets: ["latin"],
+});
+
+export const metadata: Metadata = {
+  metadataBase: new URL(process.env.NEXT_PUBLIC_SITE_URL ?? "https://chainkit.community"),
+  title: {
+    default: "Chainkit — Supply chain AI, in one place",
+    template: "%s | Chainkit",
+  },
+  description:
+    "Discover, compare, and rate open-source AI tools for planning, procurement, logistics, warehousing, and supply chain visibility.",
+  applicationName: "Chainkit",
+  robots: { index: true, follow: true },
+};
+
+export default function RootLayout({ children }: LayoutProps<"/">) {
+  return (
+    <html lang="en" className={`${dmSans.variable} ${jetBrainsMono.variable} h-full antialiased`}>
+      <body className="min-h-full flex flex-col">{children}</body>
+    </html>
+  );
+}

src/app/page.tsx

@@ -0,0 +1,23 @@
+import type { Metadata } from "next";
+import { Directory } from "@/app/directory";
+import { getTools } from "@/lib/tools";
+
+export const dynamic = "force-dynamic";
+
+export const metadata: Metadata = {
+  title: "Open-source AI tools for supply chains",
+  description:
+    "Discover, compare, and rate open-source AI tools for supply chain planning, procurement, logistics, warehousing, and visibility.",
+  alternates: { canonical: "/" },
+  openGraph: {
+    title: "Chainkit — Supply chain AI, in one place",
+    description:
+      "A community-built directory of open-source AI projects for the supply chain.",
+    type: "website",
+  },
+};
+
+export default async function Home() {
+  const tools = await getTools();
+  return <Directory initialTools={tools} />;
+}

src/app/robots.ts

@@ -0,0 +1,11 @@
+import type { MetadataRoute } from "next";
+
+export const dynamic = "force-dynamic";
+
+export default function robots(): MetadataRoute.Robots {
+  const siteUrl = process.env.NEXT_PUBLIC_SITE_URL ?? "https://chainkit.community";
+  return {
+    rules: { userAgent: "*", allow: "/" },
+    sitemap: `${siteUrl}/sitemap.xml`,
+  };
+}

src/app/sitemap.ts

@@ -0,0 +1,18 @@
+import type { MetadataRoute } from "next";
+import { getTools } from "@/lib/tools";
+
+export const dynamic = "force-dynamic";
+
+export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+  const siteUrl = process.env.NEXT_PUBLIC_SITE_URL ?? "https://chainkit.community";
+  const tools = await getTools();
+  return [
+    { url: siteUrl, changeFrequency: "daily", priority: 1 },
+    ...tools.map((tool) => ({
+      url: `${siteUrl}/tools/${tool.slug}`,
+      lastModified: new Date(tool.createdAt),
+      changeFrequency: "weekly" as const,
+      priority: 0.7,
+    })),
+  ];
+}

src/app/tool-rating.tsx

@@ -0,0 +1,89 @@
+"use client";
+
+import { useState } from "react";
+import { Star } from "lucide-react";
+
+type Props = {
+  toolId: string;
+  initialRating: number;
+  initialCount: number;
+  size?: "small" | "large";
+};
+
+function getVoterId() {
+  const storageKey = "chainkit-voter-id";
+  let voterId = window.localStorage.getItem(storageKey);
+  if (!voterId) {
+    voterId = window.crypto.randomUUID();
+    window.localStorage.setItem(storageKey, voterId);
+  }
+  return voterId;
+}
+
+export function ToolRating({
+  toolId,
+  initialRating,
+  initialCount,
+  size = "small",
+}: Props) {
+  const [rating, setRating] = useState(initialRating);
+  const [count, setCount] = useState(initialCount);
+  const [selected, setSelected] = useState(0);
+  const [busy, setBusy] = useState(false);
+  const [message, setMessage] = useState("");
+
+  async function submitRating(value: number) {
+    setBusy(true);
+    setMessage("");
+    try {
+      const response = await fetch("/api/ratings", {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({ toolId, rating: value, voterId: getVoterId() }),
+      });
+      const data = (await response.json()) as {
+        averageRating?: number;
+        ratingCount?: number;
+        error?: string;
+      };
+      if (!response.ok) throw new Error(data.error ?? "Could not save your rating.");
+      setRating(data.averageRating ?? rating);
+      setCount(data.ratingCount ?? count);
+      setSelected(value);
+      setMessage("Thanks for rating!");
+    } catch (error) {
+      setMessage(error instanceof Error ? error.message : "Could not save your rating.");
+    } finally {
+      setBusy(false);
+    }
+  }
+
+  return (
+    <div className={`rating-control rating-${size}`}>
+      <div className="rating-stars" role="group" aria-label="Rate this tool from 1 to 5 stars">
+        {[1, 2, 3, 4, 5].map((value) => (
+          <button
+            key={value}
+            type="button"
+            aria-label={`Rate ${value} out of 5`}
+            aria-pressed={selected === value}
+            disabled={busy}
+            onClick={() => void submitRating(value)}
+            className={(selected || rating) >= value ? "star-button is-filled" : "star-button"}
+          >
+            <Star size={size === "large" ? 22 : 15} fill="currentColor" aria-hidden="true" />
+          </button>
+        ))}
+      </div>
+      {size === "small" ? (
+        <span className="rating-count" aria-live="polite">
+          {rating ? rating.toFixed(1) : "New"} · {count}
+        </span>
+      ) : (
+        <span className="rating-message" aria-live="polite">
+          {message || (selected ? "Your rating is saved" : "Choose 1–5 stars")}
+        </span>
+      )}
+    </div>
+  );
+}

src/app/tools/[slug]/page.tsx

@@ -0,0 +1,101 @@
+import type { Metadata } from "next";
+import Link from "next/link";
+import { ArrowLeft, ArrowUpRight, ExternalLink, Star } from "lucide-react";
+import { notFound } from "next/navigation";
+import { getToolBySlug } from "@/lib/tools";
+import { ToolRating } from "@/app/tool-rating";
+
+type Props = { params: Promise<{ slug: string }> };
+
+export const dynamic = "force-dynamic";
+
+export async function generateMetadata({ params }: Props): Promise<Metadata> {
+  const { slug } = await params;
+  const tool = await getToolBySlug(slug);
+  if (!tool) return { title: "Tool not found" };
+  return {
+    title: tool.name,
+    description: tool.summary,
+    alternates: { canonical: `/tools/${tool.slug}` },
+    openGraph: {
+      title: `${tool.name} | Chainkit`,
+      description: tool.summary,
+      type: "article",
+    },
+  };
+}
+
+export default async function ToolPage({ params }: Props) {
+  const { slug } = await params;
+  const tool = await getToolBySlug(slug);
+  if (!tool) notFound();
+
+  const date = new Intl.DateTimeFormat("en", {
+    dateStyle: "medium",
+    timeZone: "UTC",
+  }).format(new Date(tool.createdAt));
+
+  return (
+    <main className="detail-page">
+      <div className="detail-wrap">
+        <Link href="/" className="back-link">
+          <ArrowLeft size={16} aria-hidden="true" />
+          Back to directory
+        </Link>
+        <article className="detail-card">
+          <div className="detail-topline">
+            <span className="category-chip">{tool.category}</span>
+            <span className="detail-date">Added {date}</span>
+          </div>
+          <h1>{tool.name}</h1>
+          <p className="detail-summary">{tool.summary}</p>
+          <div className="detail-rating">
+            <Star size={17} fill="currentColor" aria-hidden="true" />
+            <strong>{tool.averageRating ? tool.averageRating.toFixed(1) : "New"}</strong>
+            <span>{tool.ratingCount} community ratings</span>
+          </div>
+          <div className="detail-actions">
+            <a className="button button-primary" href={tool.repoUrl} target="_blank" rel="noopener noreferrer">
+              View GitHub repository <ArrowUpRight size={16} aria-hidden="true" />
+            </a>
+            {tool.websiteUrl ? (
+              <a className="button button-secondary" href={tool.websiteUrl} target="_blank" rel="noopener noreferrer">
+                Project website <ExternalLink size={15} aria-hidden="true" />
+              </a>
+            ) : null}
+          </div>
+          <section className="detail-rating-panel" aria-labelledby="rate-heading">
+            <div>
+              <h2 id="rate-heading">Tried this tool?</h2>
+              <p>Share a quick rating with the community.</p>
+            </div>
+            <ToolRating
+              toolId={tool.id}
+              initialRating={tool.averageRating}
+              initialCount={tool.ratingCount}
+              size="large"
+            />
+          </section>
+          <dl className="detail-meta">
+            <div>
+              <dt>Submitted by</dt>
+              <dd>{tool.submittedBy}</dd>
+            </div>
+            <div>
+              <dt>Repository</dt>
+              <dd>
+                <a href={tool.repoUrl} target="_blank" rel="noopener noreferrer">
+                  {tool.repoUrl.replace("https://github.com/", "")}
+                </a>
+              </dd>
+            </div>
+          </dl>
+        </article>
+        <div className="detail-note">
+          <span>Independent projects, shared knowledge.</span>
+          <Link href="/" className="text-link">Explore more tools <ArrowUpRight size={14} /></Link>
+        </div>
+      </div>
+    </main>
+  );
+}

src/lib/tool-types.ts

@@ -0,0 +1,23 @@
+export const categories = [
+  "Planning",
+  "Procurement",
+  "Logistics",
+  "Warehousing",
+  "Visibility",
+] as const;
+
+export type ToolCategory = (typeof categories)[number];
+
+export type SupplyChainTool = {
+  id: string;
+  slug: string;
+  name: string;
+  summary: string;
+  category: ToolCategory;
+  repoUrl: string;
+  websiteUrl: string;
+  submittedBy: string;
+  createdAt: string;
+  averageRating: number;
+  ratingCount: number;
+};

src/lib/tools.ts

@@ -0,0 +1,348 @@
+import { randomUUID } from "node:crypto";
+import { BigQuery } from "@google-cloud/bigquery";
+import type { SupplyChainTool, ToolCategory } from "@/lib/tool-types";
+import { categories } from "@/lib/tool-types";
+
+type NewTool = Omit<
+  SupplyChainTool,
+  "id" | "slug" | "createdAt" | "averageRating" | "ratingCount"
+>;
+
+type DemoState = {
+  tools: SupplyChainTool[];
+  ratings: Map<string, number>;
+};
+
+declare global {
+  var __chainkitDemoState: DemoState | undefined;
+}
+
+const demoTools: SupplyChainTool[] = [
+  {
+    id: "intelligent-supply-chain",
+    slug: "intelligent-supply-chain-management",
+    name: "Intelligent Supply Chain Management",
+    summary:
+      "Azure ML accelerator using deep-learning forecasts and distributed computing to simulate inventory optimization.",
+    category: "Planning",
+    repoUrl: "https://github.com/MSUSAzureAccelerators/Intelligent-Supply-Chain-Management",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "scimai-gym",
+    slug: "scimai-gym",
+    name: "SCIMAI Gym",
+    summary:
+      "Python environment for supply-chain inventory management experiments with deep reinforcement learning.",
+    category: "Planning",
+    repoUrl: "https://github.com/frenkowski/SCIMAI-Gym",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "product-demand-forecasting",
+    slug: "product-demand-forecasting-ml",
+    name: "Product Demand Forecasting with ML",
+    summary:
+      "Machine-learning project exploring product demand forecasting for supply-chain planning.",
+    category: "Planning",
+    repoUrl: "https://github.com/trydoff/Product-Demand-Forecasting-Using-ML",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "timefold-solver",
+    slug: "timefold-solver",
+    name: "Timefold Solver",
+    summary:
+      "Open-source AI solver for vehicle routing, task assignment, and other operational planning problems.",
+    category: "Logistics",
+    repoUrl: "https://github.com/TimefoldAI/timefold-solver",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "late-delivery-prediction",
+    slug: "supply-chain-late-delivery-prediction",
+    name: "Late Delivery Prediction",
+    summary:
+      "Industrial ML pipeline for shipment-delay prediction with model comparisons and a Streamlit batch app.",
+    category: "Visibility",
+    repoUrl: "https://github.com/workkrishnpatel/supply-chain-late-delivery-prediction",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "ai-warehouse-slotting",
+    slug: "ai-warehouse-slotting",
+    name: "AI Warehouse Slotting",
+    summary:
+      "Warehouse-management prototype integrating ML demand forecasting and dynamic slotting optimization.",
+    category: "Warehousing",
+    repoUrl: "https://github.com/ArwaElsayed5/Graduation-Project",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+  {
+    id: "fraudlens-ai",
+    slug: "fraudlens-ai",
+    name: "FraudLens AI",
+    summary:
+      "Procurement audit prototype that applies anomaly detection and NLP to flag suspicious bid and vendor patterns.",
+    category: "Procurement",
+    repoUrl: "https://github.com/thenishantraj/fraudlens-ai",
+    websiteUrl: "",
+    submittedBy: "Chainkit demo",
+    createdAt: "2026-11-06T10:00:00.000Z",
+    averageRating: 0,
+    ratingCount: 0,
+  },
+];
+
+function getDemoState(): DemoState {
+  globalThis.__chainkitDemoState ??= {
+    tools: demoTools.map((tool) => ({ ...tool })),
+    ratings: new Map(),
+  };
+  return globalThis.__chainkitDemoState;
+}
+
+function getBigQueryConfig() {
+  const projectId = process.env.BIGQUERY_PROJECT_ID;
+  const dataset = process.env.BIGQUERY_DATASET;
+  if (!projectId && !dataset) return undefined;
+  if (!projectId || !dataset) {
+    throw new Error(
+      "Set both BIGQUERY_PROJECT_ID and BIGQUERY_DATASET to enable BigQuery.",
+    );
+  }
+  if (!/^[a-z][a-z0-9-]{4,28}[a-z0-9]$/.test(projectId)) {
+    throw new Error("BIGQUERY_PROJECT_ID is not a valid Google Cloud project ID.");
+  }
+  if (!/^[A-Za-z0-9_]{1,1024}$/.test(dataset)) {
+    throw new Error("BIGQUERY_DATASET contains unsupported characters.");
+  }
+  return { projectId, dataset };
+}
+
+let bigQueryClient: BigQuery | undefined;
+
+function getBigQuery() {
+  const config = getBigQueryConfig();
+  if (!config) return undefined;
+  bigQueryClient ??= new BigQuery({ projectId: config.projectId });
+  return { client: bigQueryClient, ...config };
+}
+
+function toolTable(projectId: string, dataset: string) {
+  return `\`${projectId}.${dataset}.tools\``;
+}
+
+function ratingTable(projectId: string, dataset: string) {
+  return `\`${projectId}.${dataset}.tool_ratings\``;
+}
+
+function isToolCategory(value: string): value is ToolCategory {
+  return categories.some((item) => item === value);
+}
+
+function mapBigQueryRow(row: Record<string, unknown>): SupplyChainTool {
+  const category = String(row.category);
+  if (!isToolCategory(category)) {
+    throw new Error(`BigQuery returned an unsupported category: ${category}`);
+  }
+  return {
+    id: String(row.id),
+    slug: String(row.slug),
+    name: String(row.name),
+    summary: String(row.summary),
+    category,
+    repoUrl: String(row.repoUrl),
+    websiteUrl: String(row.websiteUrl ?? ""),
+    submittedBy: String(row.submittedBy),
+    createdAt: new Date(String(row.createdAt)).toISOString(),
+    averageRating: Number(row.averageRating ?? 0),
+    ratingCount: Number(row.ratingCount ?? 0),
+  };
+}
+
+function buildToolQuery(
+  projectId: string,
+  dataset: string,
+  where = "",
+  order = "",
+) {
+  return `
+    SELECT
+      t.tool_id AS id,
+      t.slug,
+      t.name,
+      t.summary,
+      t.category,
+      t.repo_url AS repoUrl,
+      t.website_url AS websiteUrl,
+      t.submitted_by AS submittedBy,
+      t.created_at AS createdAt,
+      COALESCE(AVG(r.rating), 0) AS averageRating,
+      COUNT(r.rating) AS ratingCount
+    FROM ${toolTable(projectId, dataset)} AS t
+    LEFT JOIN ${ratingTable(projectId, dataset)} AS r
+      ON t.tool_id = r.tool_id
+    ${where}
+    GROUP BY
+      t.tool_id, t.slug, t.name, t.summary, t.category, t.repo_url,
+      t.website_url, t.submitted_by, t.created_at
+    ${order}
+  `;
+}
+
+export async function getTools(): Promise<SupplyChainTool[]> {
+  const bigQuery = getBigQuery();
+  if (!bigQuery) return getDemoState().tools;
+
+  const [rows] = await bigQuery.client.query({
+    query: buildToolQuery(
+      bigQuery.projectId,
+      bigQuery.dataset,
+      "",
+      "ORDER BY t.created_at DESC",
+    ),
+  });
+  return rows.map(mapBigQueryRow);
+}
+
+export async function getToolBySlug(slug: string) {
+  const bigQuery = getBigQuery();
+  if (!bigQuery) {
+    return getDemoState().tools.find((tool) => tool.slug === slug);
+  }
+  const [rows] = await bigQuery.client.query({
+    query: `${buildToolQuery(
+      bigQuery.projectId,
+      bigQuery.dataset,
+      "WHERE t.slug = @slug",
+    )} LIMIT 1`,
+    params: { slug },
+  });
+  return rows[0] ? mapBigQueryRow(rows[0]) : undefined;
+}
+
+async function getToolById(toolId: string) {
+  const bigQuery = getBigQuery();
+  if (!bigQuery) {
+    return getDemoState().tools.find((tool) => tool.id === toolId);
+  }
+  const [rows] = await bigQuery.client.query({
+    query: `${buildToolQuery(
+      bigQuery.projectId,
+      bigQuery.dataset,
+      "WHERE t.tool_id = @toolId",
+    )} LIMIT 1`,
+    params: { toolId },
+  });
+  return rows[0] ? mapBigQueryRow(rows[0]) : undefined;
+}
+
+export async function submitTool(input: NewTool) {
+  const createdAt = new Date().toISOString();
+  const id = randomUUID();
+  const slugBase =
+    input.name
+      .toLowerCase()
+      .normalize("NFKD")
+      .replace(/[\u0300-\u036f]/g, "")
+      .replace(/[^a-z0-9]+/g, "-")
+      .replace(/^-|-$/g, "")
+      .slice(0, 48) || "supply-chain-tool";
+  const tool: SupplyChainTool = {
+    ...input,
+    id,
+    slug: `${slugBase}-${id.slice(0, 8)}`,
+    createdAt,
+    averageRating: 0,
+    ratingCount: 0,
+  };
+  const bigQuery = getBigQuery();
+
+  if (!bigQuery) {
+    getDemoState().tools.unshift(tool);
+    return tool;
+  }
+
+  await bigQuery.client.query({
+    query: `
+      INSERT INTO ${toolTable(bigQuery.projectId, bigQuery.dataset)}
+        (tool_id, slug, name, summary, category, repo_url, website_url, submitted_by, created_at)
+      VALUES
+        (@id, @slug, @name, @summary, @category, @repoUrl, @websiteUrl, @submittedBy, TIMESTAMP(@createdAt))
+    `,
+    params: {
+      id: tool.id,
+      slug: tool.slug,
+      name: tool.name,
+      summary: tool.summary,
+      category: tool.category,
+      repoUrl: tool.repoUrl,
+      websiteUrl: tool.websiteUrl,
+      submittedBy: tool.submittedBy,
+      createdAt: tool.createdAt,
+    },
+  });
+  return tool;
+}
+
+export async function rateTool(toolId: string, voterId: string, rating: number) {
+  const bigQuery = getBigQuery();
+  if (!bigQuery) {
+    const state = getDemoState();
+    const tool = state.tools.find((candidate) => candidate.id === toolId);
+    if (!tool) return undefined;
+
+    const key = `${toolId}:${voterId}`;
+    const previousRating = state.ratings.get(key);
+    const total = tool.averageRating * tool.ratingCount;
+    const nextCount = tool.ratingCount + (previousRating === undefined ? 1 : 0);
+    const nextTotal = total - (previousRating ?? 0) + rating;
+    state.ratings.set(key, rating);
+    tool.averageRating = Number((nextTotal / nextCount).toFixed(1));
+    tool.ratingCount = nextCount;
+    return tool;
+  }
+
+  const tool = await getToolById(toolId);
+  if (!tool) return undefined;
+
+  await bigQuery.client.query({
+    query: `
+      MERGE ${ratingTable(bigQuery.projectId, bigQuery.dataset)} AS target
+      USING (SELECT @toolId AS tool_id, @voterId AS voter_id, @rating AS rating) AS source
+        ON target.tool_id = source.tool_id AND target.voter_id = source.voter_id
+      WHEN MATCHED THEN
+        UPDATE SET rating = source.rating, updated_at = CURRENT_TIMESTAMP()
+      WHEN NOT MATCHED THEN
+        INSERT (tool_id, voter_id, rating, created_at, updated_at)
+        VALUES (source.tool_id, source.voter_id, source.rating, CURRENT_TIMESTAMP(), CURRENT_TIMESTAMP())
+    `,
+    params: { toolId, voterId, rating },
+  });
+  return getToolById(toolId);
+}

tsconfig.json

@@ -0,0 +1,34 @@
+{
+  "compilerOptions": {
+    "target": "ES2017",
+    "lib": ["dom", "dom.iterable", "esnext"],
+    "allowJs": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "noEmit": true,
+    "esModuleInterop": true,
+    "module": "esnext",
+    "moduleResolution": "bundler",
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "jsx": "react-jsx",
+    "incremental": true,
+    "plugins": [
+      {
+        "name": "next"
+      }
+    ],
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "next-env.d.ts",
+    "**/*.ts",
+    "**/*.tsx",
+    ".next/types/**/*.ts",
+    ".next/dev/types/**/*.ts",
+    "**/*.mts"
+  ],
+  "exclude": ["node_modules"]
+}