Repository files navigation

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.

Get up and running in minutes:

# Install dependenciesnpm install# Start development servernpm run dev

Visithttp://localhost:8080 to see your local site. The dev server watches for changes and rebuilds automatically.

• Node.js 22+ (download)
• npm 10+ (comes with Node.js)

src/├── _data/          # Site metadata and configuration├── _includes/      # Nunjucks templates and partials├── assets/         # Static assets (icons, images)├── content/        # Markdown pages├── css/            # Stylesheets├── data/           # Graph data (nodes and links)└── js/             # TypeScript source files

Homepage

• Editsrc/index.njk for the main page structure
• Modify the hero section and CTA buttons here

Markdown Pages

• All.md files insrc/content/ become pages
• Front matter controls metadata and layout

Graph Data

• Editsrc/data/graph.json to add/remove nodes and links
• Runnpm run build after changes to regenerate the site

Styling

• src/css/base.css - Base styles and typography
• src/css/graph.css - Graph-specific styles

TypeScript

• All scripts insrc/js/ are compiled via esbuild
• Changes trigger rebuilds in watch mode

Editsrc/data/graph.json:

{"nodes": [    {"id":"unique-id","label":"Node Name","type":"topic","href":"/path/","description":"Short description for tooltips.","tags": ["tag1","tag2"],"pinned":false    }  ],"links": [    {"source":"hub","target":"unique-id","kind":"relates" }  ]}

Node Types:

• hub - Central navigation node
• topic - Topic or category
• asset - External resource or link

Link Kinds:

• relates - General relationship
• belongs - Hierarchical relationship
• references - Reference link

After editing graph data, rebuild withnpm run build.

This site is deployed toGitHub Pages:

• Custom domain:graphtech.dev (configured viaCNAME)
• Push tomain branch to trigger deployment
• Built site output:dist/

• Lighthouse: Target ≥ 90 mobile Performance/Accessibility
• Bundle Size: JS bundle budget ≤ 200KB gzipped
• Accessibility: Prefers-reduced-motion respected for graph interactions

Plausible Analytics tracks:

• Page views
• Custom events:graph_node_hover,graph_node_click,graph_filter_used

Connect with fellow graph technology developers:

• Join the X Community - Daily threads, pulses, and data drops. Share schemas, queries, datasets, and benchmarks.
• Follow @codegraphtheory - Personal GitHub profile with educational resources and projects
• Explore GraphTechnologyDevelopers - Organization hub for graph tech resources and templates

MIT License - seeLICENSE file for details.