Add Tutorial

Author: rcosta358

.github/workflows/pages.yml

@@ -0,0 +1,57 @@
+name: Deploy 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: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 22
+          cache: npm
+          cache-dependency-path: package-lock.json
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Check and build site
+        run: |
+          npm run check
+          npm run build
+
+      - name: Configure GitHub Pages
+        uses: actions/configure-pages@v5
+
+      - name: Upload GitHub Pages artifact
+        uses: actions/upload-pages-artifact@v4
+        with:
+          path: dist/client
+
+  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

README.md

@@ -0,0 +1,37 @@
+# LiquidJava Interactive Tutorial
+
+This repository contains a web-based, interactive introduction to LiquidJava. The tutorial has four short examples:
+
+1. RGB value refinements;
+2. Midpoint method contracts;
+3. External socket state refinements;
+4. Stack ghost variables.
+
+Learners can edit Java snippets, run lightweight in-browser checks, answer quick knowledge questions, and move freely between sections. The tutorial does not collect, persist, or export user data.
+
+## Preview Locally
+
+Run the local development server:
+
+```sh
+npm run dev
+```
+
+Then open `http://localhost:8000`.
+
+## Examples
+
+All tutorial content is in [`tutorial-data.js`](tutorial-data.js). The interface renders the lessons from that single configuration object.
+
+Each lesson contains:
+
+- Explanatory copy and a read-only example;
+- Starter and solution code;
+- Regular-expression checks for the coding task;
+- Automatically checked multiple-choice and short-answer questions.
+
+Add, remove, or reorder lesson objects to change the tutorial without editing `app.js` or `index.html`.
+
+## Checker Scope
+
+The browser checker is intentionally lightweight: it recognizes the requested annotations and values but does not run the LiquidJava compiler. Use the LiquidJava VS Code extension for real verification tasks.