Add build script and GitHub Actions workflow for automated releases

Author: diegochine

.github/workflows/release.yml

@@ -0,0 +1,51 @@
+name: Build and Release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  build-and-release:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          cache: 'npm'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build project
+        run: npm run build
+
+      - name: Create tarball
+        run: |
+          tar -czf linear-algebra-playground.tar.gz dist/
+
+      - name: Create or update release
+        uses: ncipollo/release-action@v1
+        with:
+          tag: latest
+          name: Latest Release
+          body: |
+            Latest build from main branch.
+
+            ## Installation
+
+            ```bash
+            wget https://github.com/${{ github.repository }}/releases/download/latest/linear-algebra-playground.tar.gz
+            tar -xzf linear-algebra-playground.tar.gz
+            cd dist && npm start
+            ```
+          artifacts: linear-algebra-playground.tar.gz
+          draft: false
+          prerelease: false
+          makeLatest: true
+          allowUpdates: true

.gitignore

@@ -1,3 +1,4 @@
 node_modules
 logs
-.claude
+.claude
+dist

build.js

@@ -0,0 +1,168 @@
+const esbuild = require('esbuild');
+const fs = require('fs');
+const path = require('path');
+
+const DIST_DIR = path.join(__dirname, 'dist');
+const DIST_CLIENT_DIR = path.join(DIST_DIR, 'client');
+
+// Ensure dist directories exist
+function ensureDirs() {
+  [DIST_DIR, DIST_CLIENT_DIR].forEach(dir => {
+    if (!fs.existsSync(dir)) {
+      fs.mkdirSync(dir, { recursive: true });
+    }
+  });
+}
+
+// JavaScript files in load order (from index.html)
+const jsFiles = [
+  'client/help-modal.js',
+  'client/logger.js',
+  'client/core/status.js',
+  'client/core/config.js',
+  'client/core/operation-schemas.js',
+  'client/core/help.js',
+  'client/core/mode-manager.js',
+  'client/core/color-utils.js',
+  'client/core/theme-service.js',
+  'client/core/results-panel.js',
+  'client/core/format-utils.js',
+  'client/core/vector.js',
+  'client/core/animator.js',
+  'client/core/coordinate-system.js',
+  'client/app.js',
+  'client/entities/matrix.js',
+  'client/modes/vector-sidebar.js',
+  'client/modes/vector-canvas.js',
+  'client/modes/vector-operations.js',
+  'client/modes/vector-mode.js',
+  'client/modes/matrix-operations.js',
+  'client/modes/matrix-mode.js',
+  'client/linear-algebra.js'
+];
+
+// CSS files
+const cssFiles = [
+  'client/bespoke.css',
+  'client/layout.css',
+  'client/vector-mode.css',
+  'client/matrix-mode.css'
+];
+
+// Minify content using esbuild transform API (no temp files needed)
+async function minify(content, loader = 'js') {
+  const result = await esbuild.transform(content, {
+    loader,
+    minify: true,
+    target: 'es2020',
+  });
+  return result.code;
+}
+
+// Bundle and minify files
+async function bundleFiles(files, outputPath, loader = 'js') {
+  const content = files
+    .map(file => fs.readFileSync(path.join(__dirname, file), 'utf8'))
+    .join('\n\n');
+
+  const minified = await minify(content, loader);
+  fs.writeFileSync(outputPath, minified);
+}
+
+// Copy directory recursively (simplified)
+function copyDir(src, dest) {
+  if (!fs.existsSync(src)) return false;
+
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      copyDir(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+  return true;
+}
+
+// Create production HTML
+function createProductionHtml() {
+  let html = fs.readFileSync(path.join(__dirname, 'client', 'index.html'), 'utf8');
+
+  // Remove all script tags
+  html = html.replace(/<script[^>]*src="[^"]+"[^>]*><\/script>\s*/g, '');
+
+  // Remove all CSS link tags
+  html = html.replace(/<link rel="stylesheet" href="[^"]+\.css"[^>]*\/>\s*/g, '');
+
+  // Insert bundled CSS before </head>
+  html = html.replace('</head>', '  <link rel="stylesheet" href="./styles.bundle.css" />\n</head>');
+
+  // Insert bundled script before </body>
+  html = html.replace('</body>', '  <script src="./app.bundle.js"></script>\n</body>');
+
+  fs.writeFileSync(path.join(DIST_CLIENT_DIR, 'index.html'), html);
+}
+
+async function build() {
+  console.log('Building production bundle...');
+
+  try {
+    ensureDirs();
+
+    // Bundle JavaScript
+    console.log('Bundling JavaScript files...');
+    await bundleFiles(jsFiles, path.join(DIST_CLIENT_DIR, 'app.bundle.js'), 'js');
+    console.log('✓ JavaScript bundled');
+
+    // Bundle CSS
+    console.log('Bundling CSS files...');
+    await bundleFiles(cssFiles, path.join(DIST_CLIENT_DIR, 'styles.bundle.css'), 'css');
+    console.log('✓ CSS bundled');
+
+    // Minify server.js
+    console.log('Minifying server.js...');
+    const serverContent = fs.readFileSync(path.join(__dirname, 'server.js'), 'utf8');
+    const minifiedServer = await minify(serverContent, 'js');
+    fs.writeFileSync(path.join(DIST_DIR, 'server.js'), minifiedServer);
+    console.log('✓ server.js minified');
+
+    // Copy static files
+    console.log('Copying static files...');
+    fs.writeFileSync(
+      path.join(DIST_DIR, 'package.json'),
+      fs.readFileSync(path.join(__dirname, 'package.json'), 'utf8')
+    );
+    fs.writeFileSync(
+      path.join(DIST_CLIENT_DIR, 'config.json'),
+      fs.readFileSync(path.join(__dirname, 'client', 'config.json'), 'utf8')
+    );
+    console.log('✓ Static files copied');
+
+    // Copy ws dependency
+    console.log('Copying ws dependency...');
+    const wsCopied = copyDir(
+      path.join(__dirname, 'node_modules', 'ws'),
+      path.join(DIST_DIR, 'node_modules', 'ws')
+    );
+    console.log(wsCopied ? '✓ ws dependency copied' : '⚠ ws dependency not found, skipping...');
+
+    // Create production HTML
+    console.log('Creating production index.html...');
+    createProductionHtml();
+    console.log('✓ Production index.html created');
+
+    console.log('\n✓ Build complete! Output in dist/');
+  } catch (error) {
+    console.error('Build failed:', error);
+    process.exit(1);
+  }
+}
+
+build();