create-gametau 0.1.0-alpha.2

package/dist/cli.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * create-gametau — Scaffold a Tauri game with web + desktop deployment.
+ *
+ * Usage:
+ *   bunx create-gametau my-game
+ *   bunx create-gametau my-game --template pixi
+ *   bunx create-gametau my-game --template vanilla
+ */
+declare const TEMPLATES: readonly ["three", "pixi", "vanilla"];
+type Template = (typeof TEMPLATES)[number];
+interface Options {
+    projectName: string;
+    template: Template;
+}
+export declare function scaffold(options: Options, cwd?: string): void;
+export {};

package/dist/cli.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+/**
+ * create-gametau — Scaffold a Tauri game with web + desktop deployment.
+ *
+ * Usage:
+ *   bunx create-gametau my-game
+ *   bunx create-gametau my-game --template pixi
+ *   bunx create-gametau my-game --template vanilla
+ */
+import { mkdirSync, writeFileSync, existsSync, readdirSync, readFileSync, cpSync } from "fs";
+import { join, resolve, dirname } from "path";
+import { fileURLToPath } from "url";
+const TEMPLATES = ["three", "pixi", "vanilla"];
+function parseArgs(args) {
+    const positional = [];
+    let template = "three";
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg === "--template" || arg === "-t") {
+            const next = args[++i];
+            if (!next || !TEMPLATES.includes(next)) {
+                console.error(`Invalid template: ${next}`);
+                console.error(`Available: ${TEMPLATES.join(", ")}`);
+                process.exit(1);
+            }
+            template = next;
+        }
+        else if (arg === "--help" || arg === "-h") {
+            printHelp();
+            process.exit(0);
+        }
+        else if (!arg.startsWith("-")) {
+            positional.push(arg);
+        }
+    }
+    if (positional.length === 0) {
+        console.error("Error: project name required.\n");
+        printHelp();
+        process.exit(1);
+    }
+    return { projectName: positional[0], template };
+}
+function printHelp() {
+    console.log(`
+create-gametau — Scaffold a Tauri game with web + desktop deployment
+
+Usage:
+  bunx create-gametau <project-name> [options]
+
+Options:
+  --template, -t   Template to use: three (default), pixi, vanilla
+  --help, -h       Show this help message
+
+Examples:
+  bunx create-gametau my-game
+  bunx create-gametau my-game --template pixi
+  bun create gametau my-game
+`.trim());
+}
+function getTemplatesDir() {
+    // Works both when running from source (dev) and from dist (published)
+    const thisFile = fileURLToPath(import.meta.url);
+    const packageRoot = resolve(dirname(thisFile), "..");
+    return join(packageRoot, "templates");
+}
+export function scaffold(options, cwd) {
+    const { projectName, template } = options;
+    const targetDir = resolve(cwd || process.cwd(), projectName);
+    if (existsSync(targetDir)) {
+        const contents = readdirSync(targetDir);
+        if (contents.length > 0) {
+            throw new Error(`directory "${projectName}" already exists and is not empty.`);
+        }
+    }
+    const templatesDir = getTemplatesDir();
+    const baseDir = join(templatesDir, "base");
+    const overlayDir = join(templatesDir, template);
+    if (!existsSync(baseDir)) {
+        throw new Error(`base template not found at ${baseDir}`);
+    }
+    // Copy base template
+    mkdirSync(targetDir, { recursive: true });
+    cpSync(baseDir, targetDir, { recursive: true });
+    // Copy template overlay (overwrites base files where applicable)
+    if (existsSync(overlayDir)) {
+        cpSync(overlayDir, targetDir, { recursive: true });
+    }
+    // Replace {{PROJECT_NAME}} placeholders
+    replaceInDir(targetDir, "{{PROJECT_NAME}}", projectName);
+}
+function replaceInDir(dir, search, replace) {
+    const entries = readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = join(dir, entry.name);
+        if (entry.isDirectory()) {
+            replaceInDir(fullPath, search, replace);
+        }
+        else {
+            try {
+                const content = readFileSync(fullPath, "utf-8");
+                if (content.includes(search)) {
+                    writeFileSync(fullPath, content.replaceAll(search, replace));
+                }
+            }
+            catch {
+                // Skip binary files
+            }
+        }
+    }
+}
+function isDirectExecution() {
+    // Bun exposes import.meta.main directly.
+    if (typeof Bun !== "undefined") {
+        return import.meta.main;
+    }
+    // Node 20 does not expose import.meta.main; compare current module to argv[1].
+    const entry = process.argv[1];
+    if (!entry)
+        return false;
+    try {
+        const currentFile = fileURLToPath(import.meta.url);
+        return resolve(entry) === currentFile;
+    }
+    catch {
+        return false;
+    }
+}
+// Main — only runs when executed directly (not when imported by tests)
+if (isDirectExecution()) {
+    const args = process.argv.slice(2);
+    const options = parseArgs(args);
+    try {
+        console.log(`Creating ${options.projectName} with ${options.template} template...`);
+        scaffold(options);
+        console.log(`
+Done! Your game is ready.
+
+  cd ${options.projectName}
+  bun install
+  bun run dev          # web dev server
+  bun run dev:tauri    # desktop dev (requires Tauri CLI)
+  bun run build:web    # build for web deployment
+  bun run build:desktop # build desktop app
+`);
+    }
+    catch (err) {
+        console.error(`Error: ${err instanceof Error ? err.message : err}`);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "create-gametau",
+  "version": "0.1.0-alpha.2",
+  "description": "Scaffold a Tauri game that deploys to web + desktop",
+  "license": "Apache-2.0",
+  "type": "module",
+  "bin": {
+    "create-gametau": "./dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "test": "bun test",
+    "typecheck": "tsc --noEmit"
+  },
+  "devDependencies": {
+    "@types/bun": "^1.2.0",
+    "typescript": "^5.8.0"
+  }
+}

package/templates/base/index.html

@@ -0,0 +1,32 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
+    <title>{{PROJECT_NAME}}</title>
+    <style>
+      * { margin: 0; padding: 0; box-sizing: border-box; }
+      html, body { width: 100%; height: 100%; overflow: hidden; background: #000; }
+      canvas { display: block; }
+      #app { width: 100%; height: 100%; }
+      #hud {
+        position: fixed;
+        top: 16px;
+        left: 16px;
+        color: #fff;
+        font-family: monospace;
+        font-size: 14px;
+        z-index: 10;
+        pointer-events: none;
+      }
+    </style>
+  </head>
+  <body>
+    <div id="hud">
+      <div>Score: <span id="score">0</span></div>
+      <div>Tick: <span id="tick">0</span></div>
+    </div>
+    <div id="app"></div>
+    <script type="module" src="/src/index.ts"></script>
+  </body>
+</html>

package/templates/base/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "dev:tauri": "tauri dev",
+    "build:web": "vite build",
+    "build:desktop": "tauri build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "webtau": "^0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0",
+    "vite": "^6.0.0",
+    "webtau-vite": "^0.1.0-alpha.2",
+    "@tauri-apps/cli": "^2.0.0",
+    "@tauri-apps/api": "^2.0.0"
+  }
+}

package/templates/base/src/game/loop.ts

@@ -0,0 +1,28 @@
+type TickFn = (dt: number) => void;
+type RenderFn = () => void;
+
+let running = false;
+let lastTime = 0;
+
+export function startGameLoop(tick: TickFn, render: RenderFn): void {
+  running = true;
+  lastTime = performance.now();
+
+  function frame(now: number) {
+    if (!running) return;
+
+    const dt = (now - lastTime) / 1000; // seconds
+    lastTime = now;
+
+    tick(dt);
+    render();
+
+    requestAnimationFrame(frame);
+  }
+
+  requestAnimationFrame(frame);
+}
+
+export function stopGameLoop(): void {
+  running = false;
+}

package/templates/base/src/index.ts

@@ -0,0 +1,55 @@
+import { configure, isTauri } from "webtau";
+import { getWorldView, tickWorld } from "./services/backend";
+import { startGameLoop } from "./game/loop";
+import { initScene, updateScene } from "./game/scene";
+
+async function main() {
+  // Configure webtau for web mode (no-op in Tauri)
+  if (!isTauri()) {
+    configure({
+      loadWasm: async () => {
+        const wasm = await import("./wasm/{{PROJECT_NAME}}_wasm");
+        await wasm.default(); // Initialize WASM
+        wasm.init(42); // Initialize game state
+        return wasm;
+      },
+    });
+  }
+
+  // Set up the renderer
+  const app = document.getElementById("app")!;
+  await initScene(app);
+
+  // Get initial state
+  const view = await getWorldView();
+  document.getElementById("score")!.textContent = String(view.score);
+  document.getElementById("tick")!.textContent = String(view.tick_count);
+
+  // Start game loop
+  let tickAccumulator = 0;
+  let tickInFlight = false;
+  const TICK_RATE = 1 / 10; // 10 ticks per second
+
+  startGameLoop(
+    (dt) => {
+      tickAccumulator += dt;
+      if (!tickInFlight && tickAccumulator >= TICK_RATE) {
+        tickAccumulator -= TICK_RATE;
+        tickInFlight = true;
+        tickWorld()
+          .then(() => getWorldView())
+          .then((view) => {
+            document.getElementById("score")!.textContent = String(view.score);
+            document.getElementById("tick")!.textContent = String(view.tick_count);
+          })
+          .catch(console.error)
+          .finally(() => { tickInFlight = false; });
+      }
+    },
+    () => {
+      updateScene();
+    },
+  );
+}
+
+main().catch(console.error);

package/templates/base/src/services/backend.ts

@@ -0,0 +1,18 @@
+import { invoke } from "webtau";
+
+export interface WorldView {
+  score: number;
+  tick_count: number;
+}
+
+export interface TickResult {
+  score_delta: number;
+}
+
+export async function getWorldView(): Promise<WorldView> {
+  return invoke<WorldView>("get_world_view");
+}
+
+export async function tickWorld(): Promise<TickResult> {
+  return invoke<TickResult>("tick_world");
+}

package/templates/base/src-tauri/Cargo.toml

@@ -0,0 +1,7 @@
+[workspace]
+resolver = "2"
+members = ["core", "commands", "app", "wasm"]
+
+[workspace.package]
+version = "0.1.0"
+edition = "2021"

package/templates/base/src-tauri/app/Cargo.toml

@@ -0,0 +1,19 @@
+[package]
+name = "{{PROJECT_NAME}}-app"
+version.workspace = true
+edition.workspace = true
+
+[lib]
+name = "app_lib"
+crate-type = ["staticlib", "cdylib", "rlib"]
+
+[build-dependencies]
+tauri-build = { version = "2", features = [] }
+
+[dependencies]
+tauri = { version = "2", features = [] }
+tauri-plugin-opener = "2"
+serde = { version = "1", features = ["derive"] }
+serde_json = "1"
+{{PROJECT_NAME}}-core = { path = "../core" }
+{{PROJECT_NAME}}-commands = { path = "../commands" }

package/templates/base/src-tauri/app/build.rs

@@ -0,0 +1,3 @@
+fn main() {
+    tauri_build::build();
+}

package/templates/base/src-tauri/app/src/lib.rs

@@ -0,0 +1,14 @@
+use std::sync::Mutex;
+
+use {{PROJECT_NAME}}_core::GameWorld;
+use {{PROJECT_NAME}}_commands::{get_world_view, tick_world};
+
+#[cfg_attr(mobile, tauri::mobile_entry_point)]
+pub fn run() {
+    tauri::Builder::default()
+        .plugin(tauri_plugin_opener::init())
+        .manage(Mutex::new(GameWorld::new(42)))
+        .invoke_handler(tauri::generate_handler![get_world_view, tick_world])
+        .run(tauri::generate_context!())
+        .expect("error while running tauri application");
+}

package/templates/base/src-tauri/app/src/main.rs

@@ -0,0 +1,6 @@
+// Prevents additional console window on Windows in release
+#![cfg_attr(not(debug_assertions), windows_subsystem = "windows")]
+
+fn main() {
+    app_lib::run();
+}

package/templates/base/src-tauri/app/tauri.conf.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://raw.githubusercontent.com/nicholasgasior/tauri/tauri-v2/crates/tauri-config-schema/schema.json",
+  "productName": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "identifier": "com.gametau.{{PROJECT_NAME}}",
+  "build": {
+    "frontendDist": "../../../dist",
+    "devUrl": "http://localhost:1420",
+    "beforeDevCommand": "bun run dev",
+    "beforeBuildCommand": "bun run build:web"
+  },
+  "app": {
+    "windows": [
+      {
+        "title": "{{PROJECT_NAME}}",
+        "width": 1280,
+        "height": 720,
+        "resizable": true,
+        "fullscreen": false
+      }
+    ]
+  },
+  "bundle": {
+    "active": true,
+    "targets": "all",
+    "icon": []
+  }
+}

package/templates/base/src-tauri/commands/Cargo.toml

@@ -0,0 +1,16 @@
+[package]
+name = "{{PROJECT_NAME}}-commands"
+version.workspace = true
+edition.workspace = true
+
+[dependencies]
+{{PROJECT_NAME}}-core = { path = "../core" }
+webtau = "0.1.0-alpha.2"
+
+[target.'cfg(not(target_arch = "wasm32"))'.dependencies]
+tauri = { version = "2", features = [] }
+
+[target.'cfg(target_arch = "wasm32")'.dependencies]
+wasm-bindgen = "0.2"
+serde = { version = "1", features = ["derive"] }
+serde-wasm-bindgen = "0.6"

package/templates/base/src-tauri/commands/src/commands.rs

@@ -0,0 +1,20 @@
+use {{PROJECT_NAME}}_core::{GameWorld, WorldView, TickResult};
+
+#[cfg(target_arch = "wasm32")]
+webtau::wasm_state!(GameWorld);
+
+#[cfg(target_arch = "wasm32")]
+#[wasm_bindgen::prelude::wasm_bindgen]
+pub fn init(seed: u32) {
+    set_state(GameWorld::new(seed as u64));
+}
+
+#[webtau::command]
+pub fn get_world_view(state: &GameWorld) -> WorldView {
+    state.view()
+}
+
+#[webtau::command]
+pub fn tick_world(state: &mut GameWorld) -> TickResult {
+    state.tick()
+}

package/templates/base/src-tauri/commands/src/lib.rs

@@ -0,0 +1,7 @@
+mod commands;
+
+#[cfg(not(target_arch = "wasm32"))]
+pub use commands::{get_world_view, tick_world};
+
+#[cfg(target_arch = "wasm32")]
+pub use commands::{init, get_world_view, tick_world};

package/templates/base/src-tauri/core/Cargo.toml

@@ -0,0 +1,8 @@
+[package]
+name = "{{PROJECT_NAME}}-core"
+version.workspace = true
+edition.workspace = true
+
+[dependencies]
+serde = { version = "1", features = ["derive"] }
+rand = { version = "0.8", features = ["std_rng"] }

package/templates/base/src-tauri/core/src/lib.rs

@@ -0,0 +1,45 @@
+use rand::rngs::StdRng;
+use rand::SeedableRng;
+use serde::Serialize;
+
+#[derive(Serialize, Clone)]
+pub struct WorldView {
+    pub score: i32,
+    pub tick_count: u32,
+}
+
+#[derive(Serialize, Clone)]
+pub struct TickResult {
+    pub score_delta: i32,
+}
+
+pub struct GameWorld {
+    score: i32,
+    tick_count: u32,
+    rng: StdRng,
+}
+
+impl GameWorld {
+    pub fn new(seed: u64) -> Self {
+        Self {
+            score: 0,
+            tick_count: 0,
+            rng: StdRng::seed_from_u64(seed),
+        }
+    }
+
+    pub fn view(&self) -> WorldView {
+        WorldView {
+            score: self.score,
+            tick_count: self.tick_count,
+        }
+    }
+
+    pub fn tick(&mut self) -> TickResult {
+        use rand::Rng;
+        let delta = self.rng.gen_range(-1..=3);
+        self.score += delta;
+        self.tick_count += 1;
+        TickResult { score_delta: delta }
+    }
+}

package/templates/base/src-tauri/wasm/Cargo.toml

@@ -0,0 +1,21 @@
+[package]
+name = "{{PROJECT_NAME}}-wasm"
+version.workspace = true
+edition.workspace = true
+
+[lib]
+crate-type = ["cdylib"]
+
+[dependencies]
+wasm-bindgen = "0.2"
+serde = { version = "1", features = ["derive"] }
+serde-wasm-bindgen = "0.6"
+webtau = "0.1.0-alpha.2"
+{{PROJECT_NAME}}-core = { path = "../core" }
+{{PROJECT_NAME}}-commands = { path = "../commands" }
+
+[profile.release]
+lto = true
+opt-level = "z"
+codegen-units = 1
+strip = true

package/templates/base/src-tauri/wasm/src/lib.rs

@@ -0,0 +1,2 @@
+// Link commands crate so its wasm_bindgen exports become part of this cdylib.
+use {{PROJECT_NAME}}_commands as _;

package/templates/base/tsconfig.json

@@ -0,0 +1,13 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "isolatedModules": true
+  },
+  "include": ["src"]
+}

package/templates/base/vite.config.ts

@@ -0,0 +1,22 @@
+import { defineConfig } from "vite";
+import webtauVite from "webtau-vite";
+
+const host = process.env.TAURI_DEV_HOST;
+
+export default defineConfig({
+  // webtauVite() auto-detects the standard layout (src-tauri/wasm,
+  // src-tauri/core, etc.) — no config needed for scaffolded projects.
+  plugins: [webtauVite()],
+  clearScreen: false,
+  server: {
+    port: 1420,
+    strictPort: true,
+    host: host || false,
+    hmr: host
+      ? { protocol: "ws", host, port: 1421 }
+      : { protocol: "ws", host: "localhost", port: 1421 },
+    watch: {
+      ignored: ["**/src-tauri/**"],
+    },
+  },
+});

package/templates/pixi/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "dev:tauri": "tauri dev",
+    "build:web": "vite build",
+    "build:desktop": "tauri build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "pixi.js": "^8.0.0",
+    "webtau": "^0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "typescript": "^5.8.0",
+    "vite": "^6.0.0",
+    "webtau-vite": "^0.1.0-alpha.2",
+    "@tauri-apps/cli": "^2.0.0",
+    "@tauri-apps/api": "^2.0.0"
+  }
+}

package/templates/pixi/src/game/scene.ts

@@ -0,0 +1,46 @@
+import { Application, Graphics, Text, TextStyle } from "pixi.js";
+
+let app: Application;
+let rect: Graphics;
+let angle = 0;
+
+export async function initScene(container: HTMLElement): Promise<void> {
+  app = new Application();
+  await app.init({
+    resizeTo: window,
+    background: 0x1a1a2e,
+    antialias: true,
+  });
+  container.appendChild(app.canvas);
+
+  // Spinning rectangle
+  rect = new Graphics();
+  drawRect();
+  rect.x = window.innerWidth / 2;
+  rect.y = window.innerHeight / 2;
+  rect.pivot.set(50, 50);
+  app.stage.addChild(rect);
+
+  // Title text
+  const style = new TextStyle({
+    fontFamily: "monospace",
+    fontSize: 16,
+    fill: 0x00d4aa,
+  });
+  const text = new Text({ text: "gametau + PixiJS", style });
+  text.x = window.innerWidth / 2;
+  text.y = window.innerHeight - 40;
+  text.anchor.set(0.5);
+  app.stage.addChild(text);
+}
+
+function drawRect(): void {
+  rect.clear();
+  rect.rect(0, 0, 100, 100);
+  rect.fill(0x00d4aa);
+}
+
+export function updateScene(): void {
+  angle += 0.02;
+  rect.rotation = angle;
+}

package/templates/three/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "{{PROJECT_NAME}}",
+  "version": "0.1.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "dev": "vite",
+    "dev:tauri": "tauri dev",
+    "build:web": "vite build",
+    "build:desktop": "tauri build",
+    "preview": "vite preview"
+  },
+  "dependencies": {
+    "three": "^0.172.0",
+    "webtau": "^0.1.0-alpha.2"
+  },
+  "devDependencies": {
+    "@types/three": "^0.172.0",
+    "typescript": "^5.8.0",
+    "vite": "^6.0.0",
+    "webtau-vite": "^0.1.0-alpha.2",
+    "@tauri-apps/cli": "^2.0.0",
+    "@tauri-apps/api": "^2.0.0"
+  }
+}

package/templates/three/src/game/scene.ts

@@ -0,0 +1,54 @@
+import * as THREE from "three";
+
+let renderer: THREE.WebGLRenderer;
+let scene: THREE.Scene;
+let camera: THREE.PerspectiveCamera;
+let cube: THREE.Mesh;
+
+export async function initScene(container: HTMLElement): Promise<void> {
+  // Renderer
+  renderer = new THREE.WebGLRenderer({ antialias: true });
+  renderer.setSize(window.innerWidth, window.innerHeight);
+  renderer.setPixelRatio(window.devicePixelRatio);
+  container.appendChild(renderer.domElement);
+
+  // Scene
+  scene = new THREE.Scene();
+  scene.background = new THREE.Color(0x1a1a2e);
+
+  // Camera
+  camera = new THREE.PerspectiveCamera(
+    75,
+    window.innerWidth / window.innerHeight,
+    0.1,
+    1000,
+  );
+  camera.position.z = 3;
+
+  // Lighting
+  const ambient = new THREE.AmbientLight(0x404040, 2);
+  scene.add(ambient);
+
+  const directional = new THREE.DirectionalLight(0xffffff, 1);
+  directional.position.set(5, 5, 5);
+  scene.add(directional);
+
+  // Spinning cube
+  const geometry = new THREE.BoxGeometry(1, 1, 1);
+  const material = new THREE.MeshStandardMaterial({ color: 0x00d4aa });
+  cube = new THREE.Mesh(geometry, material);
+  scene.add(cube);
+
+  // Handle resize
+  window.addEventListener("resize", () => {
+    camera.aspect = window.innerWidth / window.innerHeight;
+    camera.updateProjectionMatrix();
+    renderer.setSize(window.innerWidth, window.innerHeight);
+  });
+}
+
+export function updateScene(): void {
+  cube.rotation.x += 0.01;
+  cube.rotation.y += 0.01;
+  renderer.render(scene, camera);
+}

package/templates/vanilla/src/game/scene.ts

@@ -0,0 +1,43 @@
+let canvas: HTMLCanvasElement;
+let ctx: CanvasRenderingContext2D;
+let angle = 0;
+
+export async function initScene(container: HTMLElement): Promise<void> {
+  canvas = document.createElement("canvas");
+  canvas.width = window.innerWidth;
+  canvas.height = window.innerHeight;
+  container.appendChild(canvas);
+
+  ctx = canvas.getContext("2d")!;
+
+  window.addEventListener("resize", () => {
+    canvas.width = window.innerWidth;
+    canvas.height = window.innerHeight;
+  });
+}
+
+export function updateScene(): void {
+  const w = canvas.width;
+  const h = canvas.height;
+
+  // Clear
+  ctx.fillStyle = "#1a1a2e";
+  ctx.fillRect(0, 0, w, h);
+
+  // Spinning square
+  const size = 80;
+  ctx.save();
+  ctx.translate(w / 2, h / 2);
+  ctx.rotate(angle);
+  ctx.fillStyle = "#00d4aa";
+  ctx.fillRect(-size / 2, -size / 2, size, size);
+  ctx.restore();
+
+  angle += 0.02;
+
+  // Label
+  ctx.fillStyle = "#00d4aa";
+  ctx.font = "16px monospace";
+  ctx.textAlign = "center";
+  ctx.fillText("gametau + Canvas2D", w / 2, h - 24);
+}