feat(website): add static project site

Create a dependency-free static website package with responsive landing page, validation and build scripts, GitHub Pages workflow, and professional project documentation.

Author: vamgan

.github/workflows/pages.yml

@@ -0,0 +1,39 @@
+name: Publish Website
+
+on:
+  push:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: pages
+  cancel-in-progress: true
+
+jobs:
+  build:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 22
+      - run: npm test
+      - run: npm run build
+      - uses: actions/upload-pages-artifact@v3
+        with:
+          path: dist
+
+  deploy:
+    needs: build
+    runs-on: ubuntu-latest
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    steps:
+      - id: deployment
+        uses: actions/deploy-pages@v4

.gitignore

@@ -0,0 +1,3 @@
+dist/
+node_modules/
+.DS_Store

LICENSE

@@ -0,0 +1,19 @@
+Apache License
+Version 2.0, January 2004
+http://www.apache.org/licenses/
+
+TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+Copyright 2026 AgentDispatch contributors.
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

README.md

@@ -0,0 +1,32 @@
+# AgentDispatch Website
+
+Static website package for AgentDispatch.
+
+AgentDispatch lets local lead agents spawn cloud subagents through a provider-neutral MCP control plane. This package contains the public landing page that explains the product, architecture, packages, and first AWS AgentCore runtime path.
+
+## Commands
+
+```bash
+npm run dev
+npm test
+npm run build
+```
+
+## Structure
+
+- `src/index.html` — single-page marketing site.
+- `src/styles.css` — responsive visual system, no external assets.
+- `src/main.js` — progressive enhancements only.
+- `scripts/validate.mjs` — static checks for local links, copy placeholders, and required sections.
+- `scripts/build.mjs` — copies `src` into `dist` for GitHub Pages or any static host.
+
+## Deploy
+
+The included GitHub Pages workflow builds `dist` and publishes it as a static artifact. No framework runtime or server is required.
+
+## Design constraints
+
+- No checked-in brand asset folder.
+- No generated images.
+- No runtime dependencies.
+- Fast, readable, and easy to fork into a richer docs site later.

package-lock.json

@@ -0,0 +1,21 @@
+{
+  "name": "@agent-dispatch/website",
+  "version": "0.1.0",
+  "description": "Static marketing website for AgentDispatch.",
+  "private": true,
+  "type": "module",
+  "license": "Apache-2.0",
+  "scripts": {
+    "build": "node scripts/build.mjs",
+    "test": "node scripts/validate.mjs",
+    "dev": "python3 -m http.server 4173 --directory src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agent-dispatch/website.git"
+  },
+  "bugs": {
+    "url": "https://github.com/agent-dispatch/website/issues"
+  },
+  "homepage": "https://agent-dispatch.github.io/website"
+}

package.json

@@ -0,0 +1,14 @@
+import { cp, mkdir, rm } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const root = dirname(fileURLToPath(import.meta.url));
+const repoRoot = resolve(root, "..");
+const srcDir = resolve(repoRoot, "src");
+const distDir = resolve(repoRoot, "dist");
+
+await rm(distDir, { recursive: true, force: true });
+await mkdir(distDir, { recursive: true });
+await cp(srcDir, distDir, { recursive: true });
+
+console.log(`Built AgentDispatch website into ${distDir}`);

scripts/build.mjs

@@ -0,0 +1,56 @@
+import { readFile, readdir, stat } from "node:fs/promises";
+import { existsSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const repoRoot = resolve(dirname(fileURLToPath(import.meta.url)), "..");
+const srcDir = resolve(repoRoot, "src");
+const indexPath = resolve(srcDir, "index.html");
+const requiredSections = [
+  "hero",
+  "how-it-works",
+  "packages",
+  "agentcore",
+  "quickstart",
+  "roadmap"
+];
+
+const index = await readFile(indexPath, "utf8");
+for (const section of requiredSections) {
+  if (!index.includes(`id="${section}"`)) {
+    throw new Error(`Missing required section #${section}`);
+  }
+}
+
+for (const placeholder of ["TODO", "lorem", "ipsum", "undefined"]) {
+  if (index.toLowerCase().includes(placeholder.toLowerCase())) {
+    throw new Error(`Found placeholder text: ${placeholder}`);
+  }
+}
+
+for (const match of index.matchAll(/(?:href|src)="([^"]+)"/g)) {
+  const target = match[1];
+  if (target.startsWith("http") || target.startsWith("#") || target.startsWith("mailto:")) continue;
+  const localPath = resolve(dirname(indexPath), target);
+  if (!existsSync(localPath)) {
+    throw new Error(`Broken local asset reference: ${target}`);
+  }
+}
+
+const css = await readFile(resolve(srcDir, "styles.css"), "utf8");
+if (!css.includes("@media") || !css.includes(":root")) {
+  throw new Error("CSS must include responsive rules and root design tokens.");
+}
+
+const files = [];
+async function walk(dir) {
+  for (const entry of await readdir(dir)) {
+    const path = resolve(dir, entry);
+    const metadata = await stat(path);
+    if (metadata.isDirectory()) await walk(path);
+    else files.push(path);
+  }
+}
+await walk(srcDir);
+
+console.log(`Validated AgentDispatch website (${files.length} source files).`);