From eb92029cb0db66e143f9e9887bfb67c317752f8a Mon Sep 17 00:00:00 2001
From: Adam Xu <contact@adamxu.net>
Date: Thu, 26 Feb 2026 10:23:33 -0800
Subject: [PATCH 1/2] add mobile onboarding route and bridge integration

---
 src/app/mobile/onboarding/page.tsx            |  7 ++
 src/app/onboarding/page.tsx                   |  2 +-
 src/components/LayoutWrapper.tsx              | 11 ++-
 src/components/onboarding/ConnectLmsStep.tsx  | 21 ++++-
 .../onboarding/OnboardingController.tsx       | 53 ++++++++++--
 src/lib/mobileBridge.ts                       | 80 +++++++++++++++++++
 src/types/mobileBridge.d.ts                   | 16 ++++
 7 files changed, 178 insertions(+), 12 deletions(-)
 create mode 100644 src/app/mobile/onboarding/page.tsx
 create mode 100644 src/lib/mobileBridge.ts
 create mode 100644 src/types/mobileBridge.d.ts

diff --git a/src/app/mobile/onboarding/page.tsx b/src/app/mobile/onboarding/page.tsx
new file mode 100644
index 0000000..408df0b
--- /dev/null
+++ b/src/app/mobile/onboarding/page.tsx
@@ -0,0 +1,7 @@
+'use client';
+
+import { OnboardingController } from '@/components/onboarding/OnboardingController';
+
+export default function MobileOnboardingPage() {
+  return <OnboardingController mode="mobile" />;
+}
diff --git a/src/app/onboarding/page.tsx b/src/app/onboarding/page.tsx
index ac35f64..8a861ef 100644
--- a/src/app/onboarding/page.tsx
+++ b/src/app/onboarding/page.tsx
@@ -3,5 +3,5 @@
 import { OnboardingController } from '@/components/onboarding/OnboardingController';
 
 export default function OnboardingPage() {
-  return <OnboardingController />;
+  return <OnboardingController mode="web" />;
 }
diff --git a/src/components/LayoutWrapper.tsx b/src/components/LayoutWrapper.tsx
index bc3210d..17db1d7 100644
--- a/src/components/LayoutWrapper.tsx
+++ b/src/components/LayoutWrapper.tsx
@@ -13,10 +13,12 @@ type AuthState = {
 export function LayoutWrapper({ children }: { children: React.ReactNode }) {
   const pathname = usePathname();
   const [authState, setAuthState] = useState<AuthState>(null);
+  const isHelpRoute = pathname.startsWith('/help');
+  const isMobileOnboardingRoute = pathname.startsWith('/mobile/onboarding');
 
   useEffect(() => {
     // Skip auth check for help/docs routes
-    if (pathname.startsWith('/help')) {
+    if (isHelpRoute) {
       return;
     }
 
@@ -40,10 +42,10 @@ export function LayoutWrapper({ children }: { children: React.ReactNode }) {
     };
 
     checkAuth();
-  }, [pathname]);
+  }, [isHelpRoute, pathname]);
 
   // Bypass auth check for help/docs routes
-  if (pathname.startsWith('/help')) {
+  if (isHelpRoute) {
     return <>{children}</>;
   }
 
@@ -54,6 +56,9 @@ export function LayoutWrapper({ children }: { children: React.ReactNode }) {
 
   // If authenticated
   if (authState.isAuthenticated) {
+    if (isMobileOnboardingRoute) {
+      return <>{children}</>;
+    }
     // Check if onboarding is incomplete
     if (authState.onboardingStep && authState.onboardingStep !== 'completed') {
       return <OnboardingController />;
diff --git a/src/components/onboarding/ConnectLmsStep.tsx b/src/components/onboarding/ConnectLmsStep.tsx
index 2b16bde..4947c57 100644
--- a/src/components/onboarding/ConnectLmsStep.tsx
+++ b/src/components/onboarding/ConnectLmsStep.tsx
@@ -3,10 +3,17 @@
 import { useEffect, useRef, useState } from 'react';
 import { useSearchParams } from 'next/navigation';
 import { OnboardingSlide } from './OnboardingSlide';
+import { mobileBridge } from '@/lib/mobileBridge';
 
 const BACKGROUND_COLOR = '#2563eb';
 
-export function ConnectLmsStep() {
+type OnboardingMode = 'web' | 'mobile';
+
+interface ConnectLmsStepProps {
+  mode?: OnboardingMode;
+}
+
+export function ConnectLmsStep({ mode = 'web' }: ConnectLmsStepProps) {
   const searchParams = useSearchParams();
   const error = searchParams.get('error');
   const [overrideOpen, setOverrideOpen] = useState(false);
@@ -22,7 +29,13 @@ export function ConnectLmsStep() {
     };
   }, []);
 
-  const handleConnect = () => {
+  const handleConnect = async () => {
+    if (mode === 'mobile') {
+      const bridged = await mobileBridge.startSchoologyOAuth();
+      if (bridged) {
+        return;
+      }
+    }
     window.location.href = `${process.env.NEXT_PUBLIC_BACKEND_URL}/oauth/schoology/start`;
   };
 
@@ -87,7 +100,9 @@ export function ConnectLmsStep() {
         </p>
       )}
       <button
-        onClick={handleConnect}
+        onClick={() => {
+          void handleConnect();
+        }}
         className="px-10 py-4 bg-white text-blue-600 rounded-full font-semibold text-lg shadow-lg hover:shadow-xl hover:scale-105 transition-all duration-200 cursor-pointer"
       >
         Connect Schoology
diff --git a/src/components/onboarding/OnboardingController.tsx b/src/components/onboarding/OnboardingController.tsx
index 4e08ff6..3e8085f 100644
--- a/src/components/onboarding/OnboardingController.tsx
+++ b/src/components/onboarding/OnboardingController.tsx
@@ -6,16 +6,39 @@ import { api } from '../../../convex/_generated/api';
 import { WelcomeStep } from './WelcomeStep';
 import { ConnectLmsStep } from './ConnectLmsStep';
 import { SmartConsentStep } from './SmartConsentStep';
+import { mobileBridge } from '@/lib/mobileBridge';
 
-export function OnboardingController() {
+type OnboardingMode = 'web' | 'mobile';
+
+interface OnboardingControllerProps {
+  mode?: OnboardingMode;
+}
+
+export function OnboardingController({ mode = 'web' }: OnboardingControllerProps) {
   const user = useQuery(api.users.getUser);
 
   // Redirect to dashboard when onboarding completes
   useEffect(() => {
-    if (user?.onboardingStep === 'completed') {
-      window.location.href = '/dashboard';
+    if (user?.onboardingStep !== 'completed') {
+      return;
     }
-  }, [user?.onboardingStep]);
+
+    let cancelled = false;
+    const finalizeOnboarding = async () => {
+      if (mode === 'mobile') {
+        const bridged = await mobileBridge.onboardingComplete();
+        if (bridged || cancelled) {
+          return;
+        }
+      }
+      window.location.href = '/dashboard';
+    };
+
+    void finalizeOnboarding();
+    return () => {
+      cancelled = true;
+    };
+  }, [mode, user?.onboardingStep]);
 
   // Loading state
   if (user === undefined) {
@@ -27,6 +50,26 @@ export function OnboardingController() {
   }
 
   if (user === null) {
+    if (mode === 'mobile') {
+      return (
+        <div className="fixed inset-0 bg-[#0f172a] text-white flex items-center justify-center px-6">
+          <div className="max-w-md text-center space-y-4">
+            <h1 className="text-3xl font-semibold tracking-tight">Session Expired</h1>
+            <p className="text-base opacity-80">
+              This onboarding session is no longer authenticated. Return to the app and restart onboarding.
+            </p>
+            <button
+              onClick={() => {
+                window.location.href = '/';
+              }}
+              className="px-8 py-3 bg-white text-slate-900 rounded-full font-semibold text-base shadow-lg hover:shadow-xl hover:scale-105 transition-all duration-200 cursor-pointer"
+            >
+              Return Home
+            </button>
+          </div>
+        </div>
+      );
+    }
     return null;
   }
 
@@ -34,7 +77,7 @@ export function OnboardingController() {
     case 'welcome':
       return <WelcomeStep />;
     case 'connect_lms':
-      return <ConnectLmsStep />;
+      return <ConnectLmsStep mode={mode} />;
     case 'smart_consent':
       return <SmartConsentStep />;
     case 'completed':
diff --git a/src/lib/mobileBridge.ts b/src/lib/mobileBridge.ts
new file mode 100644
index 0000000..26d51fc
--- /dev/null
+++ b/src/lib/mobileBridge.ts
@@ -0,0 +1,80 @@
+export type MobileBridgeContext = {
+  platform?: string;
+  appVersion?: string;
+  buildNumber?: string;
+  bridgeVersion?: string;
+  [key: string]: unknown;
+};
+
+type MobileBridgeV1 = {
+  startSchoologyOAuth: () => void | Promise<void>;
+  openExternalURL: (url: string) => void | Promise<void>;
+  onboardingComplete: () => void | Promise<void>;
+  getContext: () => MobileBridgeContext | Promise<MobileBridgeContext>;
+};
+
+type PartialMobileBridgeV1 = Partial<MobileBridgeV1>;
+
+function getBridge(): PartialMobileBridgeV1 | null {
+  if (typeof window === 'undefined') {
+    return null;
+  }
+  return window.mobileBridge?.v1 ?? null;
+}
+
+export const mobileBridge = {
+  isAvailable(): boolean {
+    return getBridge() !== null;
+  },
+
+  async startSchoologyOAuth(): Promise<boolean> {
+    const bridge = getBridge();
+    if (!bridge?.startSchoologyOAuth) {
+      return false;
+    }
+    try {
+      await bridge.startSchoologyOAuth();
+      return true;
+    } catch {
+      return false;
+    }
+  },
+
+  async openExternalURL(url: string): Promise<boolean> {
+    const bridge = getBridge();
+    if (!bridge?.openExternalURL) {
+      return false;
+    }
+    try {
+      await bridge.openExternalURL(url);
+      return true;
+    } catch {
+      return false;
+    }
+  },
+
+  async onboardingComplete(): Promise<boolean> {
+    const bridge = getBridge();
+    if (!bridge?.onboardingComplete) {
+      return false;
+    }
+    try {
+      await bridge.onboardingComplete();
+      return true;
+    } catch {
+      return false;
+    }
+  },
+
+  async getContext(): Promise<MobileBridgeContext | null> {
+    const bridge = getBridge();
+    if (!bridge?.getContext) {
+      return null;
+    }
+    try {
+      return await bridge.getContext();
+    } catch {
+      return null;
+    }
+  },
+};
diff --git a/src/types/mobileBridge.d.ts b/src/types/mobileBridge.d.ts
new file mode 100644
index 0000000..e1cc1a5
--- /dev/null
+++ b/src/types/mobileBridge.d.ts
@@ -0,0 +1,16 @@
+import type { MobileBridgeContext } from '@/lib/mobileBridge';
+
+declare global {
+  interface Window {
+    mobileBridge?: {
+      v1?: {
+        startSchoologyOAuth?: () => void | Promise<void>;
+        openExternalURL?: (url: string) => void | Promise<void>;
+        onboardingComplete?: () => void | Promise<void>;
+        getContext?: () => MobileBridgeContext | Promise<MobileBridgeContext>;
+      };
+    };
+  }
+}
+
+export {};

From 0ccfa95b2bb8d736cc717e8963c434774abab2f6 Mon Sep 17 00:00:00 2001
From: Adam Xu <contact@adamxu.net>
Date: Thu, 26 Feb 2026 10:26:42 -0800
Subject: [PATCH 2/2] Add literature course mapping and icons

---
 public/icons/courses/pencil.line.svg      | 12 ++++++++++++
 public/icons/courses/text.book.closed.svg | 13 +++++++++++++
 public/meta/course-match.json             | 11 +++++++++++
 3 files changed, 36 insertions(+)
 create mode 100644 public/icons/courses/pencil.line.svg
 create mode 100644 public/icons/courses/text.book.closed.svg

diff --git a/public/icons/courses/pencil.line.svg b/public/icons/courses/pencil.line.svg
new file mode 100644
index 0000000..48589b8
--- /dev/null
+++ b/public/icons/courses/pencil.line.svg
@@ -0,0 +1,12 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--Generator: Apple Native CoreSVG 341-->
+<!DOCTYPE svg
+PUBLIC "-//W3C//DTD SVG 1.1//EN"
+       "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 21.5708 18.1761">
+ <g>
+  <rect height="18.1761" opacity="0" width="21.5708" x="0" y="0"/>
+  <path d="M19.8626 16.0754C19.8626 16.5051 19.511 16.8566 19.0813 16.8566L5.00026 16.8566L6.57858 15.2844L19.0813 15.2844C19.511 15.2844 19.8626 15.6457 19.8626 16.0754Z" fill="white" fill-opacity="0.85"/>
+  <path d="M4.01295 15.9582L14.677 5.31365L12.9583 3.5949L2.30397 14.2394L1.36647 16.4172C1.27858 16.6515 1.52272 16.925 1.75709 16.8273ZM15.5266 4.4738L16.513 3.50701C17.0208 3.00896 17.0501 2.47185 16.5911 2.02263L16.2688 1.6906C15.8196 1.25115 15.2825 1.29021 14.7942 1.77849L13.7981 2.75505Z" fill="white" fill-opacity="0.85"/>
+ </g>
+</svg>
diff --git a/public/icons/courses/text.book.closed.svg b/public/icons/courses/text.book.closed.svg
new file mode 100644
index 0000000..0ad9386
--- /dev/null
+++ b/public/icons/courses/text.book.closed.svg
@@ -0,0 +1,13 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!--Generator: Apple Native CoreSVG 341-->
+<!DOCTYPE svg
+PUBLIC "-//W3C//DTD SVG 1.1//EN"
+       "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd">
+<svg version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" viewBox="0 0 16.7871 20.9277">
+ <g>
+  <rect height="20.9277" opacity="0" width="16.7871" x="0" y="0"/>
+  <path d="M2.99805 20.9277L15.6445 20.9277C16.0742 20.9277 16.4258 20.5859 16.4258 20.1465C16.4258 19.8047 16.1914 19.502 15.8789 19.3945C14.6484 18.9062 14.3945 17.3145 15.6055 16.0938C15.9766 15.7227 16.4258 15.2441 16.4258 14.2676L16.4258 3.06641C16.4258 1.03516 15.4199 0 13.3984 0L3.02734 0C1.00586 0 0 1.02539 0 3.06641L0 17.9102C0 19.9219 1.01562 20.9277 2.99805 20.9277ZM1.57227 15.2832L1.57227 3.0957C1.57227 2.11914 2.08984 1.57227 3.0957 1.57227L13.3203 1.57227C14.3359 1.57227 14.8535 2.11914 14.8535 3.0957L14.8535 14.0527C14.8535 14.5801 14.5508 14.8828 14.0039 14.8828L3.16406 14.8828C2.5293 14.8828 2.00195 15.0195 1.57227 15.2832ZM3.08594 19.3555C2.09961 19.3555 1.57227 18.8281 1.57227 17.9004C1.57227 17.0215 2.19727 16.4551 3.17383 16.4551L13.1934 16.4551C13.3203 16.4551 13.4375 16.4453 13.5352 16.4258C13.0762 17.4414 13.1543 18.5156 13.6719 19.3555ZM2.72461 15.7227L4.00391 15.7227L4.00391 1.19141L2.72461 1.19141Z" fill="white" fill-opacity="0.85"/>
+  <path d="M5.75195 6.25977L13.0762 6.25977C13.4277 6.25977 13.7109 5.9668 13.7109 5.61523C13.7109 5.26367 13.4277 4.98047 13.0762 4.98047L5.75195 4.98047C5.40039 4.98047 5.11719 5.26367 5.11719 5.61523C5.11719 5.9668 5.40039 6.25977 5.75195 6.25977Z" fill="white" fill-opacity="0.85"/>
+  <path d="M5.75195 8.94531L11.3086 8.94531C11.6602 8.94531 11.9434 8.65234 11.9434 8.30078C11.9434 7.94922 11.6602 7.66602 11.3086 7.66602L5.75195 7.66602C5.40039 7.66602 5.11719 7.94922 5.11719 8.30078C5.11719 8.65234 5.40039 8.94531 5.75195 8.94531Z" fill="white" fill-opacity="0.85"/>
+ </g>
+</svg>
diff --git a/public/meta/course-match.json b/public/meta/course-match.json
index fc27657..6ad3918 100644
--- a/public/meta/course-match.json
+++ b/public/meta/course-match.json
@@ -64,6 +64,17 @@
             ],
             "icon": "/icons/courses/cs.svg",
             "color": "#00a3ff"
+        },
+        {
+            "subject": "Literature",
+            "keywords": [
+                {
+                    "keyword": "Literature",
+                    "weight": 1
+                }
+            ],
+            "icon": "/icons/courses/text.book.closed.svg",
+            "color": "#3662e3"
         }
     ],
     "catchAll": {