three.js Visual Hello World

A didactic showcase of LLM-assisted software development for IT Systems Engineering students.

The application is a static web page that renders an interactive 3D torus knot using three.js. Drag to orbit, scroll to zoom.

Run locally

No installation required. Serve the src/ directory with any static file server:

npx serve src
# or
python3 -m http.server 8080 --directory src

Then open http://localhost:8080 (or http://localhost:5000 for serve).

Alternatively, open src/index.html directly in a browser — most browsers allow ES module imports from file:// when using an import map.

Deploy

Push to main. GitHub Actions deploys src/ to GitHub Pages automatically.

Enable Pages in your repository settings: Settings → Pages → Source → GitHub Actions.

LLM tooling

This repository is set up for use with multiple LLM coding assistants:

Tool	Config file
Claude Code	CLAUDE.md → AGENTS.md
GitHub Copilot	.github/copilot-instructions.md
Cursor (new)	.cursor/rules/project.md
Cursor (legacy)	.cursorrules
Windsurf	.windsurfrules

AGENTS.md is the single source of truth. After editing it, run:

scripts/sync-llm-rules.sh

Structure

src/          Static web application
  index.html  Entry point + three.js import map
  main.js     Scene setup and render loop
  style.css   Full-screen canvas layout
scripts/      Maintenance scripts
.github/      GitHub Actions + Copilot instructions
.cursor/      Cursor IDE rules
AGENTS.md     Canonical LLM instructions (tool-agnostic)
CLAUDE.md     Claude Code entry point