Basic site buildout

Author: @bronzeagecto

.eleventy.js

@@ -0,0 +1,53 @@
+import { readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+
+const passthroughFiles = [
+  { from: 'src/assets', to: 'assets' },
+  { from: 'src/data/graph.json', to: 'data/graph.json' },
+  { from: 'src/css', to: 'css' },
+];
+
+/** @param {import('@11ty/eleventy').UserConfig} eleventyConfig */
+export default function (eleventyConfig) {
+  eleventyConfig.setServerOptions({
+    showAllHosts: true,
+  });
+
+  for (let i = 0; i < passthroughFiles.length; i += 1) {
+    const entry = passthroughFiles[i];
+    eleventyConfig.addPassthroughCopy({ [entry.from]: entry.to });
+  }
+
+  eleventyConfig.addWatchTarget('src/css/');
+  eleventyConfig.addWatchTarget('src/js/');
+
+  eleventyConfig.addNunjucksFilter('dateIso', (value) => {
+    if (!value) {
+      return '';
+    }
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime())) {
+      return '';
+    }
+    return date.toISOString().split('T')[0];
+  });
+
+  eleventyConfig.addGlobalData('graphData', async () => {
+    const file = resolve('src/data/graph.json');
+    const content = await readFile(file, 'utf-8');
+    return JSON.parse(content);
+  });
+
+  return {
+    dir: {
+      input: 'src',
+      includes: '_includes',
+      data: '_data',
+      output: 'dist',
+    },
+    templateFormats: ['njk', 'md', '11ty.js'],
+    htmlTemplateEngine: 'njk',
+    markdownTemplateEngine: 'njk',
+  };
+}
+

.github/workflows/pages.yml

@@ -0,0 +1,51 @@
+name: Deploy to GitHub Pages
+
+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:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: npm
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build
+        run: npm run build
+
+      - name: Upload artifact
+        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:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+

.gitignore

@@ -0,0 +1,7 @@
+node_modules/
+dist/
+.11tycache/
+.cache/
+.DS_Store
+
+

CNAME

@@ -0,0 +1,2 @@
+graphtech.dev
+

README.md

@@ -0,0 +1,93 @@
+# Graph Technology Developers — Hub
+
+Static site powered by Eleventy (11ty), TypeScript (esbuild), and D3.js. The site delivers an SEO-friendly hub with a progressively-enhanced graph navigation experience.
+
+## Prerequisites
+
+- Node.js 22+
+- npm 10+
+
+## Setup
+
+```sh
+npm install
+```
+
+## Development
+
+```sh
+npm run dev
+```
+
+- Runs esbuild in watch mode and Eleventy dev server at `http://localhost:8080`.
+- Source directories live in `src/`.
+
+## Build
+
+```sh
+npm run build
+```
+
+- Outputs static site to `dist/` for deployment.
+
+Preview the built site locally:
+
+```sh
+npm run preview
+```
+
+## Editing Content
+
+- Homepage: `src/index.njk`
+- Markdown pages: `src/content/*.md`
+- Graph data: `src/data/graph.json`
+- CSS: `src/css/base.css`, `src/css/graph.css`
+- Scripts: `src/js/*.ts`
+
+### Adding Nodes or Links
+
+Edit `src/data/graph.json`:
+
+```json
+{
+  "nodes": [
+    {
+      "id": "unique-id",
+      "label": "Name",
+      "type": "topic",
+      "href": "/path/",
+      "description": "Short description.",
+      "tags": ["tag1", "tag2"],
+      "pinned": false
+    }
+  ],
+  "links": [
+    { "source": "hub", "target": "unique-id", "kind": "relates" }
+  ]
+}
+```
+
+After updates, run `npm run build` to regenerate the site.
+
+## Deployment
+
+- GitHub Pages via `.github/workflows/pages.yml`
+- Custom domain `graphtech.dev` configured via `CNAME`
+
+Push to `main` to trigger the Pages workflow.
+
+## Testing & Performance
+
+- Run Lighthouse against `dist/` or deployed site (target ≥ 90 mobile Perf/Accessibility).
+- JS bundle budget: ≤ 200KB gzipped (D3 + modules bundled via esbuild).
+- Prefers-reduced-motion respected by graph interactions.
+
+## Analytics
+
+- Plausible (`data-domain="graphtech.dev"`) collects page views and custom events (`graph_node_hover`, `graph_node_click`, `graph_filter_used`).
+
+## License
+
+MIT
+
+

esbuild.config.mjs

@@ -0,0 +1,56 @@
+import { build, context } from 'esbuild';
+import { mkdir, rm, writeFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+
+const watch = process.argv.includes('--watch');
+
+const outdir = resolve('dist/assets/js');
+
+async function prepareOutDir() {
+  await rm(outdir, { recursive: true, force: true });
+  await mkdir(outdir, { recursive: true });
+}
+
+const baseConfig = {
+  entryPoints: ['src/js/graph.ts', 'src/js/search.ts', 'src/js/analytics.ts'],
+  outdir,
+  bundle: true,
+  sourcemap: true,
+  format: 'esm',
+  target: ['es2022'],
+  splitting: true,
+  chunkNames: 'chunks/[name]-[hash]',
+  metafile: true,
+  loader: {
+    '.json': 'json',
+  },
+  define: {
+    'process.env.NODE_ENV': JSON.stringify(watch ? 'development' : 'production'),
+  },
+  minify: !watch,
+};
+
+async function writeMetaFile(metafile) {
+  const metaPath = resolve(outdir, 'meta.json');
+  await writeFile(metaPath, JSON.stringify(metafile, null, 2), 'utf-8');
+}
+
+async function runBuild() {
+  await prepareOutDir();
+
+  if (watch) {
+    const ctx = await context(baseConfig);
+    await ctx.watch();
+    console.log('🔁 esbuild is watching for changes');
+  } else {
+    const result = await build(baseConfig);
+    await writeMetaFile(result.metafile);
+    console.log('✅ esbuild build complete');
+  }
+}
+
+runBuild().catch((error) => {
+  console.error(error);
+  process.exit(1);
+});
+