Merge branch 'main' into landing-page

Author: chenxin-yan

.github/workflows/convex.yaml .github/workflows/convex_prod.yaml.github/workflows/convex.yaml renamed to .github/workflows/convex_prod.yaml

@@ -1,9 +1,9 @@
-name: convex
+name: convex (prod)
 
 on:
   push:
     branches:
-      - main
+      - prod
     paths:
       - "packages/server/**"
 

.github/workflows/convex_staging.yaml

@@ -0,0 +1,42 @@
+name: convex (staging)
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "packages/server/**"
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    defaults:
+      run:
+        working-directory: ./packages/server
+    environment: deploy-convex-staging
+    env:
+      DOPPLER_TOKEN: ${{ secrets.DOPPLER_TOKEN }}
+      CONVEX_DEPLOY_KEY: ${{ secrets.CONVEX_DEPLOY_KEY }}
+
+    steps:
+      - name: 💾 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: 📦 Install dependencies
+        run: bun install
+
+      - name: 🔑 Install Doppler CLI
+        uses: dopplerhq/cli-action@v3
+
+      - name: 🔄 Sync environment variables to Convex
+        run: |
+          doppler secrets download --no-file --format env-no-quotes | \
+          while IFS='=' read -r key value; do
+            bunx convex env set "$key" "$value"
+          done
+
+      - name: 🚀 Deploy Convex
+        run: bunx convex deploy

.github/workflows/docs.yaml

@@ -3,7 +3,7 @@ name: docs
 on:
   push:
     branches:
-      - main
+      - prod
     paths:
       - "apps/docs/**"
 

.github/workflows/web.yaml .github/workflows/web-prod.yaml.github/workflows/web.yaml renamed to .github/workflows/web-prod.yaml

@@ -1,9 +1,9 @@
-name: web
+name: web (prod)
 
 on:
   push:
     branches:
-      - main
+      - prod
     paths:
       - "apps/web/**"
       - "packages/server/**"

.github/workflows/web-staging.yaml

@@ -0,0 +1,30 @@
+name: web (staging)
+
+on:
+  push:
+    branches:
+      - main
+    paths:
+      - "apps/web/**"
+      - "packages/server/**"
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    environment: deploy-web-staging
+    env:
+      VERCEL_ORG_ID: ${{ secrets.VERCEL_ORG_ID }}
+      VERCEL_PROJECT_ID: ${{ secrets.VERCEL_PROJECT_ID }}
+
+    steps:
+      - name: 💾 Checkout code
+        uses: actions/checkout@v4
+
+      - name: 📦 Setup bun
+        uses: oven-sh/setup-bun@v2
+
+      - name: 📦 Install Vercel CLI
+        run: bun add --global vercel@latest
+
+      - name: 🚀 Deploy Project to Vercel
+        run: vercel deploy --prod --token=${{ secrets.VERCEL_TOKEN }}

.vercelignore

@@ -1,2 +1,2 @@
-apps/chrome
+apps/browser
 apps/scraper

AGENTS.md

@@ -1,27 +1,19 @@
-# Development Guidelines for Albert Plus
+# Agent Development Guide
 
-## Build/Lint/Test Commands
+## Commands
 
-- **Build**: `bun run build` (builds all workspaces via turbo)
-- **Lint**: `bun run check` (runs Biome linter/formatter)
-- **Type check**: `bun run check:types` (type checks all workspaces)
-- **Test**: `bun run test` (runs all tests) or `bun test <file>` (single test)
-- **Test single file**: `cd apps/scraper && bun test src/modules/courses/index.test.ts`
-- **Test with pattern**: `bun test --test-name-pattern="<regex>"`
-- **Dev**: `bun run dev` (starts all dev servers with turbo)
+- **Lint/Format**: `bun check` (check) or `biome check --write` (fix)
+- **Type Check**: `bun check:types` (all) or `bun run --filter web check:types` (specific)
+- **Dev**: `bun dev` (starts all services with Turbo)
 
-## Code Style & Formatting
+## Code Style
 
-- **Formatter**: Biome with 2-space indentation, double quotes for strings
-- **Imports**: Organize imports automatically (use `@/*` alias for apps/web src paths)
-- **Types**: Strict TypeScript enabled - use explicit types, avoid `any`
-- **Naming**: camelCase for variables/functions, PascalCase for components/types
-- **Error Handling**: Use `JobError` for scraper modules, return `null` for not found in queries
-
-## Architecture Notes
-
-- **Monorepo**: Turbo + Bun workspaces (`apps/*`, `packages/*`)
-- **Backend**: Convex (packages/server) for queries/mutations with Clerk auth
-- **Frontend**: Next.js 15 with App Router, Tailwind CSS v4, React 19
-- **Scraper**: Cloudflare Workers with Hono, Drizzle ORM for D1
-- **Testing**: Bun test runner with mocks in `__mocks__/` directories
+- **Package Manager**: Bun (v1.3.1+), use `bun install` not npm/yarn/pnpm
+- **Formatter**: Biome - 2 spaces, double quotes, organized imports
+- **TypeScript**: Strict mode, no implicit any, use explicit types for exports
+- **Imports**: Organize imports automatically via Biome, use `@/` for app imports, `workspace:*` for monorepo packages
+- **Naming**: camelCase for variables/functions, PascalCase for components/types, UPPER_SNAKE_CASE for constants
+- **Error Handling**: Use `ConvexError` for Convex functions, `JobError` for scraper jobs, typed errors preferred
+- **Async**: Use async/await, avoid callbacks, handle errors with try/catch or .catch()
+- **Components**: React 19 + Next.js 16, server components by default, use "use client" when needed
+- **Database**: Convex for main app, Drizzle ORM for scraper D1 database

README.md

@@ -22,11 +22,11 @@
 <div align="center">
 
 [![CI](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/ci.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/ci.yaml)
-[![Web Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/web.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/web.yaml)
+[![Web Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/web-prod.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/web-prod.yaml)
 [![Docs Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/docs.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/docs.yaml)
 [![Scraper Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/scraper.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/scraper.yaml)
 [![Browser Extension Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/browser.yml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/browser.yml)
-[![Convex Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/convex.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/convex.yaml)
+[![Convex Deploy](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/convex_prod.yaml/badge.svg)](https://github.com/TechAtNYU/AlbertPlus/actions/workflows/convex_prod.yaml)
 
 </div>
 
@@ -35,7 +35,6 @@
 ## Table of Contents
 
 - [About The Project](#about-the-project)
-  - [Built With](#built-with)
 - [Deployed Sites](#deployed-sites)
 - [Getting Started](#getting-started)
 - [Contributing](#contributing)
@@ -45,13 +44,6 @@
 
 AlbertPlus is a comprehensive, open-source platform designed to enhance the course registration experience for New York University (NYU) students. It provides a modern, intuitive interface and a suite of tools to help students plan their academic journey, build schedules, and navigate the complexities of course selection. The project is a monorepo that consists of a web application, a browser extension, a web scraper, and a documentation site, all powered by a Convex backend.
 
-### Built With
-
-This project is built with a modern and robust tech stack, including:
-
-- **Core:** TypeScript, React 19, Next.js 15, Convex, Bun, Turborepo
-- **Specialized:** Plasmo, Cloudflare Workers, Hono, Drizzle ORM, Astro, Starlight, Clerk
-
 For a full list of technologies, please refer to the [Tech Stack](https://docs.albertplus.com/getting-started/tech-stack/) documentation.
 
 ## Deployed Sites

apps/browser/biome.json

@@ -1,6 +1,6 @@
 {
   "root": false,
-  "$schema": "https://biomejs.dev/schemas/2.3.5/schema.json",
+  "$schema": "https://biomejs.dev/schemas/2.3.8/schema.json",
   "extends": "//",
   "files": {
     "includes": ["**", "!!build", "!src/components/ui", "!!.plasmo"]

apps/browser/package.json

@@ -11,17 +11,17 @@
     "check:types": "tsc -noEmit"
   },
   "dependencies": {
-    "@clerk/chrome-extension": "^2.8.0",
-    "convex": "^1.29.0",
+    "@clerk/chrome-extension": "^2.8.11",
+    "convex": "^1.31.0",
     "plasmo": "0.90.5",
-    "react": "19.2.0",
-    "react-dom": "19.2.0",
+    "react": "19.2.2",
+    "react-dom": "19.2.2",
     "tailwindcss": "3.4.1"
   },
   "devDependencies": {
-    "@types/chrome": "^0.1.28",
-    "@types/node": "^24.10.1",
-    "@types/react": "19.2.3",
+    "@types/chrome": "^0.1.32",
+    "@types/node": "^24.10.2",
+    "@types/react": "19.2.7",
     "@types/react-dom": "19.2.3",
     "postcss": "8.5.6",
     "typescript": "5.9.3"