Add CI check for UI builds

Author: huangsam

.github/workflows/ci.yml

@@ -49,7 +49,31 @@ jobs:
           files: ./coverage.xml
           token: ${{ secrets.CODECOV_TOKEN }}
 
-  deploy-ui:
+  ui-build:
+    name: Build Astro UI
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v7
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: '3.14'
+      - name: Set up Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: 24
+          cache: 'npm'
+          cache-dependency-path: ui/package-lock.json
+      - name: Install dependencies
+        run: npm ci
+        working-directory: ui
+      - name: Build site
+        run: npm run build
+        working-directory: ui
+
+  ui-deploy:
     name: Deploy Astro UI
     if: github.ref == 'refs/heads/main' && github.event_name == 'push'
     needs: python-build

AGENTS.md

@@ -35,3 +35,15 @@
 
 - `runner.py` — discovery and execution (pkgutil.walk_packages + `main` lookups)
 - `pyproject.toml` — formatting, linting, coverage rules
+
+## Category Charter
+
+Helpful guidance on where to place new Python module lessons:
+
+- `fundamentals/`: Core syntax and structural constructs of the language (variables, expressions, strings, lists, loops, functions, basic comprehensions).
+- `oop/`: Object-Oriented Programming concepts (classes, inheritance, encapsulation, abstract base classes, exception handling, custom iterators, mixins, MRO).
+- `stdlib/`: Python standard library modules (file handling, regular expressions, json/csv formats, date/time manipulation).
+- `advanced/`: Metaprogramming and advanced runtime behaviors (decorators, context managers, metaclasses, weak references, walrus operator, pattern matching).
+- `concurrency/`: Multitasking and non-blocking models (threading, async/await, multiprocessing, subinterpreters).
+- `engineering/`: Code quality, benchmarking, algorithm utilities, and data structures (mocking, benchmarking, deque, namedtuple, defaultdict, itertools, heaps).
+

ui/parse_lessons.py

@@ -155,6 +155,10 @@ def get_sort_key(filename, order_list=order_list):
     with open(output_file, "w", encoding="utf-8") as f:
         json.dump(lessons, f, indent=2, ensure_ascii=False)
 
+    categories_file = os.path.join(output_dir, "categories.json")
+    with open(categories_file, "w", encoding="utf-8") as f:
+        json.dump(CATEGORY_ORDER, f, indent=2, ensure_ascii=False)
+
     print(f"Successfully parsed {len(lessons)} lessons and saved to {output_file}")
 
 

ui/src/components/Sidebar.astro

@@ -1,5 +1,6 @@
 ---
 import lessons from '../data/lessons.json';
+import categoryOrder from '../data/categories.json';
 import { languages, useTranslations, type ui } from '../i18n/ui';
 import { ChevronLeft, ChevronRight } from '@lucide/astro';
 
@@ -27,8 +28,6 @@ const categoriesMap = lessons.reduce((acc, lesson) => {
   acc[cat].lessons.push(lesson);
   return acc;
 }, {} as Record<string, { name: string; lessons: typeof lessons }>);
-
-const categoryOrder = ["fundamentals", "oop", "stdlib", "advanced", "concurrency", "engineering"];
 ---
 
 <aside class="sidebar">