Table of Contents

1. Introduction — Study From Any Browser

The AoK AI-Tutoring Web App brings your entire learning experience to the browser. You can access every feature of the system from a laptop, desktop computer, or large tablet — without installing anything. Just open your browser and go.

Figure 1: The Web App opens directly at tutor.academyofknowledge.org — nothing to install

The web app and the desktop app share the same account system, the same course library, and the same XP tracking. Progress made in one is immediately reflected in the other.

1.1 Why Use the Web App?

Figure 2: Four key benefits of the Web App

• Any Device — study from a laptop, library computer, or any modern device without installing anything.
• Auto-Sync — your progress, XP, and assessment history are always live and up to date.
• Instant Access — no downloads, no updates — just open your browser.
• Same Account — log in with the same username and password you use in the desktop app, or create a new one here.

1.2 Supported Browsers

Use a modern up-to-date browser for the best experience. Recommended in order of preference:

• Google Chrome (version 100 or later)
• Mozilla Firefox (version 100 or later)
• Microsoft Edge (version 100 or later)
• Safari 16 or later (macOS only)

Mobile phones (small screen) are not currently supported. Use a laptop, desktop, or large tablet.

1.3 Desktop App vs Web App — Full Comparison

2. Getting Started — Your First Visit

2.1 Opening the Web App

1. Open your browser.
2. Navigate to tutor.academyofknowledge.org
3. The login portal appears automatically.

Figure 3: The web login portal — same design as the desktop app

2.2 First-Time Registration — Web App

1. Click Create Account.
2. Make sure the Student role button is highlighted.
3. Enter a username, password, and email address.
4. Click Send Verification Code.
5. Go to your email inbox and find the message from AoK AI.

Figure 4: The verification email — it contains your 6-digit code

1. Copy the 6-digit code.
2. Return to the browser and enter the code in the verification screen.
3. Click Verify & Create Account.
4. Your account is created. The web workspace opens automatically.

2.3 Signing In (Returning Users)

1. Click Sign In (confirmed by the tab being active).
2. Make sure Student role is selected.
3. Enter your username and password.
4. Click Sign In.

3. The Web Workspace

The web workspace has the same three-panel layout as the desktop app, adapted for the browser environment. Navigation uses a top bar instead of a toolbar.

Figure 5: The full Web Workspace — Navigation Bar (top), Course Tree (left), Learning Dashboard (centre), AI Tutor (right)

3.1 Navigation Bar (Top)

The navigation bar runs across the top of the screen and replaces the desktop toolbar. It contains:

Figure 6: The Web Navigation Bar — breadcrumb, quick stats, and AI Tutor button

• AoK AI logo — click to go back to your course list.
• Breadcrumb trail — shows your current location: Course → Module → Lesson.
• My Courses button — jump to the course library.
• Cloud Repo button — browse and download published courses.
• Level & XP badge — shows your current engineer level and live XP.
• Streak badge — shows your current study streak.
• AI Tutor button — opens the AI Tutor panel on the right.
• Avatar / Username — access profile settings.

3.2 Course Tree (Left Sidebar)

The left sidebar shows the hierarchical structure of the currently open course:

• Click any item to navigate and open its content in the Learning Dashboard.
• Right-click items to access context menu options (if you have edit access to the course).
• Collapse or expand branches using the arrow icons.

3.3 Learning Dashboard (Centre)

The Learning Dashboard shows lesson cards with star ratings, content previews, and a Study Timer at the bottom. It works identically to the desktop app.

• Click a lesson card to open its content.
• Watch videos or read PDFs directly in the embedded viewer.
• Google Docs, Office files (DOCX/PPTX/XLSX), and YouTube links all open in the dashboard.

3.4 AI Tutor Panel (Right)

Click the AI Tutor button in the navigation bar to slide open the AI Tutor panel. It contains all four Quick Actions and the full Tutoring / Assessment interface.

4. Browsing & Opening Courses

4.1 My Courses

1. Click My Courses in the navigation bar.
2. All courses published by your professor appear as cards.
3. Click any card to open the course.

Courses are loaded from the cloud automatically. You do not need to download anything — the course data streams as you browse.

4.2 Cloud Repository

1. Click Cloud Repo in the navigation bar.
2. Browse publicly available courses across the platform.
3. Click any course to add it to your library and open it immediately.

5. Using the AI Tutor

The AI Tutor in the web app has every feature of the desktop version: full course context, Bloom's Taxonomy progression, Quick Actions, and Peer Debate mode.

Figure 7: The Web AI Tutor panel — identical features to the desktop app

5.1 Starting a Tutoring Session

1. Navigate to any lesson using the Course Tree.
2. Click AI Tutor in the navigation bar to open the panel.
3. Confirm the context label shows the correct lesson name.
4. Click TUTORING tab (active by default).
5. Type your question and press Enter or click Send.

5.2 Quick Actions Bar (All Four Buttons Available)

The Quick Actions bar is present at the top of the AI Tutor panel, identical to the desktop app:

• 📋 Daily Brief — personalised study agenda for today.
• 📊 Analytics — spoken and written 5-sentence performance summary.
• 💡 Hint — tiered hints during assessments (costs XP per level).
• ⚔️ Debate — Peer Debate mode for 3× XP rewards.

5.3 Text-to-Speech

Text-to-Speech is available in the web app using your browser's built-in speech synthesis. Click Read Latest next to any AI response to hear it read aloud.

6. AI Assessments

Assessments in the web app work identically to the desktop version — adaptive Bloom's Taxonomy questions, 0–100 scoring, XP rewards, and final report generation.

Figure 8: Assessment mode in the Web App — same Bloom's levels and XP rewards

6.1 Starting an Assessment

1. Select a lesson from the Course Tree.
2. Click AI Tutor in the navigation bar.
3. Click the ASSESSMENT tab.
4. The AI starts asking questions from Remembering level upward.
5. Answer in the input box and click Send.

6.2 Bloom's Taxonomy XP Table

Scores multiply with your streak (up to ×3.0). Higher streaks = more XP from the same performance.

6.3 Saving Your Report

1. When you are done, click Finish & Save Report.
2. The AI generates a full performance report and saves it to your account.
3. You earn +100 XP. The report is accessible from your assessment history.

7. Gamification — XP, Levels, and Streaks

The gamification system is fully shared between the desktop and web apps. XP you earn in the web app immediately appears in the desktop app and vice versa.

7.1 XP Rewards

7.2 Streak System

Your streak increases every day you study. Streaks multiply all XP you earn:

• 1–2 days: ×1.0 (normal XP)
• 3–6 days: ×1.5 XP
• 7–29 days: ×2.0 XP
• 30+ days: ×3.0 XP

7.3 Engineer Career Levels

You advance through ten engineer titles from Freshman Engineer (Level 1) up to Chief Engineer (Level 10) as you accumulate XP. Your current level and XP are shown in the navigation bar at all times.

Your current level badge is always visible in the navigation bar at the top of every page.

8. Study Timer

The Study Timer appears at the bottom of the Learning Dashboard, just as in the desktop app.

1. Select a duration from the dropdown (10, 15, or 25 minutes).
2. Click Start.
3. Study with focused attention during the countdown.
4. When the round ends, collect your +25 XP and any surprise reward.

9. Advanced AI Features

All four advanced AI features from the desktop app are available in the web app.

9.1 Daily Brief 📋

Figure 9: Daily Brief in the Web App — personalised study agenda for today

Click 📋 in the Quick Actions bar to generate your personalised study agenda for today. The brief lists your recent weak areas and recommended lessons, with clickable lesson links.

9.2 Hint Ladder 💡

During an active assessment session, click 💡 to request a hint for the current question:

• Level 1: gentle nudge (–5 XP)
• Level 2: key concept pointer (–10 XP)
• Level 3: full walkthrough (–20 XP)

Hints are disabled once all three levels are consumed for a question. The button reactivates on the next question.

9.3 Peer Debate Mode ⚔️

Click ⚔️ to enter Peer Debate mode. The AI argues the opposite position from your statements, challenging you to defend your reasoning. All answers during a debate earn 3× XP.

Click the ⚔️/🏳️ toggle again to exit Debate mode at any time.

9.4 Analytics Narrator 📊

Click 📊 to receive a spoken and written 5-sentence summary of your performance trends — including strongest topics, areas for improvement, and a motivational note.

10. Frequently Asked Questions

Q: I cannot find the web app. What is the address?

A: Open any browser and go to tutor.academyofknowledge.org — that is the full address.

Q: Do I need to create a new account for the web app?

A: No. If you already have a desktop account, log in with the same username and password. If this is your first time using either app, create a new account here.

Q: My XP from the desktop app is not showing in the web app.

A: Log out and log back in. Account data syncs from the cloud on login.

Q: The AI Tutor panel is overlapping my content. How do I close it?

A: Click the X button in the top-right corner of the AI Tutor panel to slide it closed.

Q: I can only see some of my courses.

A: Only courses your professor has published appear in the course list. Contact your professor if a course is missing.

Q: Videos are not playing.

A: Check your internet connection. Video streaming requires a stable connection. Try refreshing the page.

Q: I did not receive my verification email.

A: Check your spam/junk folder. Make sure you entered a valid email address. You can restart the registration process to try again.

Q: Can I use the web app on a mobile phone?

A: The web app requires at least a tablet-sized screen (10 inches or larger). Small phone screens are not supported.

Q: Does the Daily Brief cost XP?

A: No. The Daily Brief is free to generate. Only Hint Ladder hints cost XP.

Q: Will the web app save my work if my browser crashes?

A: Yes. All messages and XP are saved to the server in real time. Reopen the browser and log back in to continue where you left off.