User Manual – Family 1 – 16 – GilRobo AI Learning

The GilRobo AI Learning Adventure: A Complete Beginner’s Guide

Your Personal Guide to Exploring, Learning, and Having Fun with GilRobo AI

A Note for Parents and Guardians

This guide is written to be read with a young learner. It explains the GilRobo AI Learning application, a powerful tool that helps students practice and learn any subject. Think of it as a magical tutor that lives inside your computer or tablet.

Every feature is explained step-by-step, from setting up a student profile to competing in online quizzes. You’ll find that this application is a complete learning world, with everything needed to practice, play, and grow.

Important Note: This application requires an internet connection and an API key to use the AI features. The API key is like a ticket that allows the AI tutor to work. You can get one from a provider like DeepSeek (the guide uses DeepSeek as the primary example), and you will paste it into the “API key” box on the main screen.

Chapter 1: Welcome to Your Learning World!

Hello, explorer! Welcome to GilRobo AI Learning. This is a very special place where you can learn about anything you want. You can practice your times tables, explore space, learn about history, or even get help with your homework. And the best part? A friendly AI (Artificial Intelligence) teacher is here to help you every step of the way.

Your AI teacher is like a super-smart robot. It can make quizzes just for you, read questions aloud, and even listen to your answers! All you need to do is tell it what you want to learn.

What’s Inside This Book?

This guide will take you on a tour of every part of the GilRobo world. We’ll call each part a “Tab,” like the tabs in a folder. By the end, you’ll know how to:

Set up your profile:Create your own player card with your name and a picture.
Pick what to learn:Choose from hundreds of topics or even make your own!
Take a quiz:Test your knowledge in a fun, timed quiz.
Compete with friends:Play against other people from all around the world in live multiplayer games.
Get reports:See your scores and how much you’ve improved.
And so much more!

Ready? Let’s begin our adventure!

Chapter 2: Getting Started (The Setup Tab)

The Setup Tab is your command center. It’s where you get everything ready before the fun begins. Think of it as putting on your uniform and picking up your gear before a big game.

2.1. Meet Your AI Teacher (The API Key)

The first thing you’ll see at the very top of the screen is the API Key section. This is how your AI teacher comes to life!

Find your ticket:You need a special “ticket” called an API key. A grown-up can help you get one from a website like com.
Paste your ticket:Copy the long string of letters and numbers and paste it into the box that says “Paste API key here.” Then click the Save (session)

Now, your AI teacher is ready to work!

2.2. Your Player Card (Adding Yourself)

Just like a video game, you need a player card.

Mode:You can play by yourself or

i need contents–chapters etc will writen like a phd publication

GilRobo AI Learning Platform: A Comprehensive Technical and Pedagogical Guide

Version 16.8 | Complete Documentation for Educators, Parents, and Young Learners

Foreword

This document serves as the definitive guide to the GilRobo AI Learning Platform, an integrated educational ecosystem designed to deliver personalised, AI-driven instruction across all subjects and age groups. Written for a broad audience—from primary school children to university researchers—this guide explains every feature, setting, and pedagogical principle underpinning the system.

The platform represents a synthesis of cutting-edge artificial intelligence, game-based learning theory, and universal design for learning (UDL) principles. It is built to be accessible to all learners, regardless of age, ability, or prior experience with technology.

Table of Contents

Volume I: Foundations & Platform Overview

Chapter 1: Introduction to GilRobo AI Learning
- 1 Philosophy and Pedagogical Approach
- 2 System Architecture Overview
- 3 Target Audience and Accessibility
- 4 Getting Started: System Requirements
Chapter 2: The AI Engine: How It Works
- 1 Artificial Intelligence Providers and API Integration
- 2 Prompt Engineering for Educational Content
- 3 Natural Language Processing and Response Generation
- 4 Text-to-Speech and Speech Recognition Technologies
- 5 Image Generation for Visual Learning
Chapter 3: User Interface and Navigation
- 1 The Tab System: A Conceptual Framework
- 2 Customising the Interface for Different Users
- 3 Accessibility Features and Assistive Technologies
- 4 Keyboard Navigation and Voice Commands

Volume II: Core Learning Modules

Chapter 4: Setup and Configuration (The Setup Tab)
- 1 Creating and Managing Player Profiles
- 2 Subject Selection and Custom Topic Creation
- 3 Difficulty Levels and Question Parameters
- 4 Timer and Accessibility Settings
- 5 Voice Selection and Testing
Chapter 5: Quiz Module (The Quiz Tab)
- 1 Quiz Generation Architecture
- 2 Question Formats and Structures
- 3 Real-time Player Feedback and Explanations
- 4 Timer Mechanics and Time Management
- 5 Score Tracking and Visual Progress Indicators
Chapter 6: Advanced Assessment Module (Quiz 2 Tab)
- 1 Reading and Writing Assessment
- 2 Speaking Assessment with Speech Analysis
- 3 Essay Writing and Automated Feedback
- 4 IELTS Test Simulation
- 5 Feedback Toggle Systems (Normal, Supportive, IELTS)
Chapter 7: Tutorial Module (The Tutorial Tab)
- 1 AI-Generated Tutorial Content
- 2 Text-to-Speech Integration for Reading Assistance
- 3 Tutorial History and Review
- 4 Voice-Controlled Topic Exploration

Volume III: Social and Competitive Learning

Chapter 8: Online Multiplayer System
- 1 Firebase Real-time Database Architecture
- 2 Game Room Creation and Management
- 3 Matchmaking Algorithms and Player Matching
- 4 Global Chat and Communication Systems
- 5 Leaderboard Structures and Ranking Algorithms
- 6 Tournament Systems and Knockout Mechanics
Chapter 9: Times Tables Rock Stars Modes
- 1 Festival Mode: Global Live Competition
- 2 Arena Mode: Classroom Live Races
- 3 Rock Slam: Asynchronous Head-to-Head Challenges
- 4 Battles: Group vs. Group Competitions
Chapter 10: Group Competition Engine
- 1 Student Selection and Group Formation
- 2 Comparison Algorithms and Metrics
- 3 Saved Competitions and Historical Data
- 4 Export Functionality for Reporting

Volume IV: Administrative and Reporting Systems

Chapter 11: Classroom Management (The Classroom Tab)
- 1 Student Registration and Approval Workflow
- 2 Lesson Planner and Scheduling
- 3 Live Classroom Session Management
- 4 Voice and Language Settings for AI Teacher
- 5 Curriculum Upload and Knowledge Integration
- 6 Safeguarding and Content Filtering
Chapter 12: Teacher Dashboard
- 1 Student Performance Overview
- 2 At-Risk Student Identification
- 3 Data Visualisation and Analytics
- 4 Individual Student Progress Tracking
Chapter 13: Homework System
- 1 Assignment Creation and Topic Selection
- 2 Student Assignment and Distribution
- 3 Submission Tracking and Completion Monitoring
- 4 Feedback Integration
Chapter 14: Parent Day Consultation System
- 1 Consultation Modes (Private, Family, Student-Led, Support, Celebration, Homework)
- 2 Multi-Parent Participation
- 3 Unlimited Language Support
- 4 AI-Powered Meeting Summaries
- 5 Action Point Generation and Follow-up Emails
- 6 Consultation History and Replay
Chapter 15: Reports and Analytics (The Reports Tab)
- 1 Data Aggregation and Filtering
- 2 Chart Generation (Bar, Line, Radar, Pie, Doughnut)
- 3 Drag-and-Drop Chart Customisation
- 4 Export Functionality (PDF, Email, CSV)
- 5 Performance Over Time Analysis

Volume V: Creative and Collaborative Tools

Chapter 16: Whiteboard System
- 1 Drawing Tools (Pen, Eraser, Highlighter, Text)
- 2 Colour Selection and Brush Size
- 3 Undo/Redo History and Clear Functions
- 4 Multi-Page Management
- 5 Zoom and Fullscreen Modes
- 6 Save and Load Functionality
Chapter 17: Certificates and Achievement Badges
- 1 Badge Definitions and Award Criteria
- 2 Certificate Template Library
- 3 Student Selection and Bulk Generation
- 4 PDF Generation and Print Functionality
- 5 Auto-Award System Based on Performance

Volume VI: Cloud Integration and Synchronisation

Chapter 18: Cloud Sync Engine
- 1 Supported Cloud Providers (Azure, AWS, WordPress, Dataverse, Custom REST API)
- 2 Bidirectional Synchronisation Architecture
- 3 Table Structure and Data Mapping
- 4 Authentication and Security
- 5 Auto-Sync Scheduler and Logging
Chapter 19: Firebase Integration
- 1 Real-time Database Structure
- 2 Public History and Leaderboard Synchronisation
- 3 Private History and Device-Specific Storage
- 4 Lesson Plan Distribution to Student Devices
- 5 Join Request and Approval Workflow

Volume VII: Advanced Features and Customisation

Chapter 20: Grading Profiles
- 1 Grade Band Definition (UK SATs, GCSE, A-Level, US Letter, IB, etc.)
- 2 Subject-Specific Grading
- 3 Active Profile Management
- 4 Preset Library and Custom Creation
Chapter 21: Custom Content Creation
- 1 Custom Topics: Structure and Storage
- 2 Custom Questions: Format and Integration
- 3 Knowledge Upload (PDF, Word, Text)
- 4 AI Generation from Custom Knowledge
Chapter 22: Admin Panel and Access Control
- 1 Tab Lock System and Role-Based Access
- 2 Access Code Generation (Admin, Trader, Viewer, Customer)
- 3 Password Management and Security
- 4 URL Embedding for Role-Specific Access

Volume VIII: Alerts, Notifications, and Engagement

Chapter 23: Alarm and Notification Engine
- 1 Lesson Plan Alarms (1st and 2nd Reminders)
- 2 Sound Synthesis (Bell, Chime, Beep, Silent)
- 3 Browser Notifications and Permission Handling
- 4 On-Screen Banner System
- 5 Spoken Alarm Messages with Text-to-Speech
Chapter 24: Email Notification System
- 1 WordPress REST API Integration
- 2 mailto: Fallback Mechanism
- 3 EmailJS Cloud Service Integration
- 4 Email List Management
- 5 Test Email Functionality
Chapter 25: Focus Lock System
- 1 Pre-Lesson Tab Blocking
- 2 Countdown Timer and Visual Feedback
- 3 Parent/Admin Unlock Mechanism
- 4 Automatic Lesson Launch

Volume IX: Technical Appendices

Appendix A: Data Storage Schema
- 1 localStorage Structure
- 2 Firebase Database Schema
- 3 Data Persistence and Backup Strategies
Appendix B: API Reference
- 1 Supported AI Providers and Endpoints
- 2 Request and Response Formats
- 3 Error Handling and Fallbacks
Appendix C: Offline Content Library
- 1 Times Tables (1× to 12×)
- 2 Addition (P1 to P6)
- 3 Subtraction (P1 to P6)
- 4 Division (P2 to P6)
- 5 Mixed Operations (P1 to P6)
- 6 Curriculum Subjects (Primary, Secondary, Corporate)
Appendix D: Accessibility Compliance
- 1 WCAG 2.1 AA Standards
- 2 Screen Reader Compatibility
- 3 Colour Contrast and Font Scaling
- 4 Keyboard Navigation Specifications
Appendix E: Troubleshooting Guide
- 1 Common Errors and Solutions
- 2 API Key Issues
- 3 Microphone and Camera Permissions
- 4 Connection and Synchronisation Problems
Appendix F: Glossary of Terms
- 1 Technical Terms Explained
- 2 Educational Terms Explained
- 3 Game Terms Explained
Appendix G: Sample Lesson Plans
- 1 Mathematics: Times Tables Festival
- 2 English: Reading Comprehension
- 3 Science: Photosynthesis Quiz

Volume I: Foundations & Platform Overview

Chapter 1: Introduction to GilRobo AI Learning

1.1 Philosophy and Pedagogical Approach

The GilRobo AI Learning Platform is built upon several foundational educational principles:

Personalised Learning
Every learner is unique. The platform adapts to individual needs through:

Adjustable difficulty levels (Easy, Medium, Hard)
Custom topic creation
Multiple question formats
AI-generated content tailored to specified subjects
SEN (Special Educational Needs) profiles that modify instructional style

Active Engagement
Learning is most effective when it is active and enjoyable. The platform incorporates:

Game-based learning through multiplayer competitions
Immediate feedback on quiz responses
Visual progress indicators and achievement badges
Certificates for milestone accomplishments

Universal Design for Learning (UDL)
The platform supports multiple means of:

Representation: Text, images, spoken audio, video
Action and Expression: Typing, speaking, drawing on whiteboard
Engagement: Solo practice, multiplayer competition, tutorial exploration

Formative Assessment
Continuous assessment drives improvement:

Real-time scoring during quizzes
Detailed results with explanations
Historical performance tracking
Reports and analytics for teachers and parents

Teacher Empowerment
Educators are given robust tools to:

Create and schedule lessons
Monitor student progress
Assign homework
Conduct parent consultations with AI assistance
Access all student data across devices

1.2 System Architecture Overview

The platform consists of several interconnected systems:

text

┌─────────────────────────────────────────────────────────────────┐

│ User Interface Layer │

│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │

│ │ Setup │ │ Quiz │ │Tutorial │ │Multi- │ │ Reports │ │

│ │ Tab │ │ Tab │ │ Tab │ │ player │ │ Tab │ │

│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │

└─────────────────────────────────────────────────────────────────┘

│

▼

│ Application Logic │

│ ┌──────────────────────────────────────────────────────────┐ │

│ │ State Management │ Event Handlers │ Data Persistence │ │

│ └──────────────────────────────────────────────────────────┘ │

│

┌───────────────────────────┼───────────────────────────┐

▼ ▼ ▼

┌───────────────────┐ ┌───────────────────┐ ┌───────────────────┐

│ AI Providers │ │ Firebase Cloud │ │ Local Storage │

│ ┌─────────────┐ │ │ ┌─────────────┐ │ │ ┌─────────────┐ │

│ │ DeepSeek │ │ │ │ Real-time │ │ │ │ Session/ │ │

│ │ OpenAI │ │ │ │ Database │ │ │ │ Local Data │ │

│ │ Anthropic │ │ │ └─────────────┘ │ │ └─────────────┘ │

│ │ Google │ │ └───────────────────┘ └───────────────────┘

│ │ Groq │ │

│ │ Together │ │

│ │ Mistral │ │

│ │ Cohere │ │

│ │ Fireworks │ │

│ └─────────────┘ │

└───────────────────┘

Key Components:

User Interface:HTML/CSS/JavaScript front-end with responsive design
Application Logic:Core JavaScript engine managing all interactions
AI Providers:Multiple third-party AI services for content generation
Firebase Cloud:Real-time database for multiplayer, leaderboards, and cross-device sync
Local Storage:Browser-based persistence for offline functionality

1.3 Target Audience and Accessibility

The platform is designed for:

Audience	Primary Use	Key Features
Children (5-12)	Fun learning games, times tables, basic subjects	Child Mode, colourful interface, voice commands, offline maths games
Secondary Students (11-18)	Exam preparation, subject mastery	IELTS practice, custom topics, detailed feedback
University Students	Advanced study, research support	Academic style, complex topics, essay analysis
Teachers	Classroom management, lesson planning	Teacher Dashboard, homework assignments, student monitoring
Parents	Home support, progress monitoring	Parent Day consultations, email notifications, child progress reports
Corporate Trainers	Professional development	Business subjects, compliance training, employee tracking

1.4 Getting Started: System Requirements

Hardware Requirements:

Any device with a modern web browser (Chrome, Edge, Safari, Firefox)
Microphone (for voice features)
Camera (optional, for profile photos)
Internet connection (required for AI features and multiplayer)

Software Requirements:

Modern browser with JavaScript enabled
Local storage enabled (for saving progress)
SpeechSynthesis API support (for text-to-speech)
Web Speech API support (for voice recognition, Chrome/Edge recommended)

Account Requirements:

No registration required for basic use
API key from a supported provider for AI features (free tier available from DeepSeek)
(Optional) Firebase account for full multiplayer features

Chapter 2: The AI Engine: How It Works

2.1 Artificial Intelligence Providers and API Integration

The platform supports multiple AI providers to ensure reliability and choice:

Provider	Model	Best For	Free Tier
DeepSeek	deepseek-chat	General education, cost-effective	Yes (generous limits)
OpenAI	GPT-4o-mini	High-quality responses, image generation	No (paid)
Anthropic	Claude Opus 4.5	Detailed explanations, safety	No
Google	Gemini Pro	Quick responses, integration	Yes (limited)
Groq	Llama 3 70B	Very fast responses	Yes
Together AI	Mixtral 8x7B	Open models, customisation	Yes
Mistral AI	Mistral Large	European alternative	Yes
Cohere	Command R+	Enterprise features	Yes
Fireworks AI	Llama 3 70B	Fast inference	Yes

API Request Structure (OpenAI-compatible format):

javascript

{

model: “deepseek-chat”,

messages: [

{ role: “system”, content: “You are a helpful tutor…” },

{ role: “user”, content: “Generate 5 questions about photosynthesis…” }

temperature: 0.7,

max_tokens: 2000

}

2.2 Prompt Engineering for Educational Content

The system uses carefully crafted prompts to generate high-quality educational content:

Question Generation Prompt Template:

text

Generate exactly {count} multiple-choice questions about “{topic}”.

Difficulty: {difficulty}.

Rules:

– Return ONLY a valid JSON array

– Each item: {“question”:”…”,”options”:[“A”,”B”,”C”,”D”],”correct”:”A”,”reason”:”…”}

– Vary correct answer positions (A, B, C, D) across questions

– Questions must be appropriate for {age} level

– Include educational explanations

JSON array:

Tutorial Generation Prompt:

text

Create a comprehensive tutorial about “{topic}” for a student.

Include:

– Key concepts explained simply

– Real-world examples

– Practice questions with answers

– A summary of main points

2.3 Natural Language Processing and Response Generation

When the AI responds to a student’s question, the system:

Contextualisesthe query within the current lesson
Filtersfor prohibited content (safeguarding)
Generatesa response using the selected AI provider
Cleansthe response (removes markdown, simplifies language if needed)
Speaksthe response aloud (if voice enabled)
Logsthe interaction for later review

2.4 Text-to-Speech and Speech Recognition Technologies

Text-to-Speech (TTS):

Uses the browser’s SpeechSynthesisAPI
Supports all system voices
Chunks long text into sentences to prevent cut-off
Adjustable rate and pitch
Language selection (50+ languages supported)

Speech Recognition:

Uses webkitSpeechRecognition(Chrome) or SpeechRecognition
Continuous listening mode for conversational interaction
Interim results for real-time feedback
Language matching (supports the same 50+ languages)

2.5 Image Generation for Visual Learning

The platform supports multiple image providers:

Provider	Type	Description
Unsplash	Free stock photos	High-quality educational images, no API key needed
DALL-E 3	AI generation	Creates custom educational illustrations
Stable Diffusion	AI generation	Open-source image generation

Image Generation Prompt Structure:

text

Educational illustration for a school lesson about: “{topic}”.

Educational diagram, clear, colourful, suitable for students.

No text overlays.

Chapter 3: User Interface and Navigation

3.1 The Tab System: A Conceptual Framework

The application is organised into tabs, each serving a distinct purpose:

Tab Name	Icon	Primary Function	User Type
Setup	⚙️	Configure quiz, add players	All
Guide	📖	Help and instructions	All
Player List	👥	Manage player directory	Teacher/Parent
Custom Topics	📝	Create own subjects	Teacher/Advanced
Custom Questions	❓	Write own quiz questions	Teacher/Advanced
Custom Knowledge	📚	Upload documents for AI	Teacher
Quiz	🎯	Take AI-generated quizzes	All
Quiz 2	📝	IELTS-style assessments	Advanced
Online Multiplayer	🌐	Compete globally	All
Whiteboard	📝	Draw and take notes	All
Reports	📊	View progress analytics	Teacher/Parent
Results	🏆	View quiz results	All
History	📜	Past quiz sessions	All
Tutorial	🎓	AI-generated lessons	All
Tutorial History	📚	Saved tutorials	All
Classroom	🏫	Teacher management	Teacher
Teacher Dashboard	📊	Student overview	Teacher
Homework	📝	Assignments	Teacher/Student
Parent Day	👨‍👩‍👧	Parent consultations	Parent/Teacher
Certificates	🏅	Achievement awards	Teacher/Student

3.2 Customising the Interface for Different Users

View Modes:

Mode	Description	Hidden Tabs
Advanced	Full professional interface	None
Simple	Clean layout for non-technical users	Reports, Custom Topics, Custom Questions, Custom Knowledge, Multiplayer, Whiteboard, Teacher Dashboard, Parent Day, Certificates
Child (Kids)	Fun, colourful interface for ages 5-12	All except Setup, Quiz, Results, History, Tutorial

Tab Customisation:
Users can hide tabs they don’t use:

Click the “Customize Tabs” button
Uncheck tabs to hide
Click “Apply Settings”

3.3 Accessibility Features and Assistive Technologies

The platform includes comprehensive accessibility features:

Feature	Description	How to Access
Text-to-Speech	Reads content aloud	Click 🔊 buttons on questions, tutorials, reports
Voice Commands	Navigate and answer by voice	Say “Option A”, “Next Question”, etc.
Keyboard Navigation	Navigate without mouse	Tab, Enter, Arrow keys, Space
Font Size Control	Adjust text size	Font size selector in Setup
High Contrast	Improved visibility	Contrast button in toolbar
Screen Reader Support	Semantic HTML	Works with NVDA, VoiceOver, JAWS
Colour Customisation	Background and text colours	Colour pickers in Setup
Background Images	Visual customisation	Upload images or choose emoji patterns

3.4 Keyboard Navigation and Voice Commands

Keyboard Shortcuts:

Shortcut	Action
Tab	Navigate between interactive elements
Enter	Activate button or submit
1-4	Select answer options A-D
Space	Read current question aloud
Ctrl + M	Toggle voice mode
Escape	Stop speech, close modals

Voice Commands:

Command	Action
“Start Quiz”	Begin the quiz
“Option A” / “Answer A”	Select answer A
“Option B”	Select answer B
“Option C”	Select answer C
“Option D”	Select answer D
“Next Question”	Proceed to next question
“Repeat Question”	Hear the question again
“Stop”	End voice mode

Volume II: Core Learning Modules

Chapter 4: Setup and Configuration (The Setup Tab)

4.1 Creating and Managing Player Profiles

Single Player Mode:

Enter your name
(Optional) Enter your organisation/school/location
Your name appears on leaderboards and reports

Multiplayer Mode:

Add multiple players (friends, classmates, siblings)
Each player gets:
- A unique ID
- Name
- Location (optional)
- Avatar (upload photo or take with camera)

Player Directory (Player List Tab):

Stores all players permanently
Can be exported as CSV
Search and filter functionality
Edit or delete players

4.2 Subject Selection and Custom Topic Creation

Built-in Subjects:

Primary School:English, Mathematics, Basic Science, Social Studies
Secondary School:English Literature, Mathematics, Physics, Chemistry, Biology, History, Geography, Business Studies
Corporate:Microsoft Excel, IT & Cybersecurity, HR & Soft Skills, Finance & Accounting, Sales & Marketing, GDPR & Compliance, Diversity & Inclusion
Times Tables:1× to 12× tables (offline, no AI needed)

Custom Topics:

Go to “Custom Topics” tab
Enter a title (e.g., “The Solar System”)
Enter detailed text about the topic
Click “Save Topic”
The topic appears in the subject dropdown as “[Custom] Title”

Topic Search and Filter:

Type in the search box to filter subjects
Click the microphone button to search by voice
Check “Hide subjects already played above” to focus on new topics
Set a percentage threshold for what counts as “already played”

4.3 Difficulty Levels and Question Parameters

Difficulty	Description	Question Complexity
Easy	Basic recall, simple concepts	1-step thinking, common knowledge
Medium	Application, some reasoning	2-step thinking, connecting ideas
Hard	Analysis, critical thinking	Multiple steps, abstract concepts

Number of Questions:

Set between 1 and 9999 questions
Default: 30 questions
For younger learners, start with 5-10 questions

4.4 Timer and Accessibility Settings

Seconds per Question:

Set between 5 and 3600 seconds
Default: 60 seconds
For beginners, use 90-120 seconds
For advanced, use 30-45 seconds

Show Question Images:

When available, AI generates relevant images
Uses DALL-E 3 (requires OpenAI API key) or Unsplash (free)
Images help visual learners

Auto-read Aloud:

Questions and answers are spoken automatically
Can be disabled for silent practice

Read Answers Only by Default:

Only options are read aloud, not the full question
Useful for reading practice

Show Read Controls:

Display buttons for Replay Question, Replay Answers, Replay Q+A, Stop Reading
Can be hidden for a cleaner interface

4.5 Voice Selection and Testing

Speaker Voice:

Choose from all voices available on your device
Test voice to hear how it sounds
Default voice is stored in browser

Voice Recommendations:

English (UK):“Google UK English Female” or “Microsoft Zira”
English (US):“Google US English” or “Samantha”
Child-friendly:Higher pitch voices (e.g., “Google UK English Female”)

Chapter 5: Quiz Module (The Quiz Tab)

5.1 Quiz Generation Architecture

The quiz generation process follows a sophisticated pipeline:

text

│ Quiz Generation Pipeline │

├─────────────────────────────────────────────────────────────────┤

│ │

│ 1. User Input ──► 2. Topic Selection ──► 3. Difficulty Set │

│ │ │ │ │

│ ▼ ▼ ▼ │

│ 4. Check Static DB ──► 5. Check Custom Topics ──► 6. AI Call │

│ │ │ │ │

│ └─────────────────┼──────────────────────┘ │

│ ▼ │

│ 7. Parse Questions │

│ │ │

│ ▼ │

│ 8. Shuffle Options │

│ │ │

│ ▼ │

│ 9. Present to User │

│ │

Step-by-Step Explanation:

User Input:The student selects a subject, difficulty, and number of questions
Topic Selection:The system identifies the specific topic
Difficulty Set:Question complexity is configured
Check Static DB:If the subject is a times table or curriculum subject, offline questions are loaded
Check Custom Topics:If a custom topic exists, its text is used as source material
AI Call:If no offline questions exist, the AI is called to generate questions
Parse Questions:The AI’s response is parsed into structured question objects
Shuffle Options:The order of answer options is randomised to prevent memorisation
Present to User:The first question is displayed

5.2 Question Formats and Structures

Multiple Choice Questions:
Each question contains:

Question text:The question being asked
Options:4 possible answers (A, B, C, D)
Correct answer:Which option is correct (A, B, C, or D)
Explanation:Why the answer is correct (for learning)

Option Shuffling:

Correct answer position is randomised per question
Prevents students from memorising “A is always correct”
Shuffling occurs after AI generation but before display

5.3 Real-time Player Feedback and Explanations

When a student answers:

Correct:Green highlight, positive message, explanation shown
Wrong:Red highlight, correct answer revealed, explanation shown
Skipped:Correct answer and explanation shown

Explanation Content:

Brief, educational reason for the correct answer
May include additional facts or learning tips
Spoken aloud if voice mode is enabled

5.4 Timer Mechanics and Time Management

Per-Question Timer:

Countdown from configured seconds
Visual progress bar shows remaining time
Warning when time is running low (red bar)

Player Time Tracking:

Total time used across all questions
Time per question stored for analysis
Used in leaderboard ranking

Skip Function:

Allows student to move to next question without answering
Marked as “skipped” in results
Correct answer still shown for learning

5.5 Score Tracking and Visual Progress Indicators

Player Scoreboard:

Live display of each player’s correct and wrong answers
Current player is highlighted
Running total of all players’ scores

Progress Bar:

Shows completion of current question timer
Also shows overall quiz progress (questions answered)

Final Results:

Percentage score per player
Time taken per player
Question-by-question breakdown
Explanations for all answers

Chapter 6: Advanced Assessment Module (Quiz 2 Tab)

6.1 Reading and Writing Assessment

Purpose: Develop reading comprehension and summarisation skills

How It Works:

Generate Reading Text:
- AI creates a 250-300 word passage on chosen topic
- IELTS Academic style for advanced students
- Can use custom topics for specific subjects
Read and Summarise:
- Student reads the passage
- Writes a summary (150-200 words recommended)
- Timer tracks reading and writing time
Analyse Summary:
- AI evaluates using IELTS criteria:
  - Task achievement
  - Coherence and cohesion
  - Lexical resource
  - Grammatical range and accuracy
- Returns overall band score (1.0-9.0)
- Provides detailed feedback

Feedback Types:

Normal:Balanced, neutral feedback
Supportive:Encouraging, focuses on improvement
IELTS:Strict academic style with band scores

6.2 Speaking Assessment with Speech Analysis

Purpose: Practice and evaluate spoken English

How It Works:

Generate Speaking Prompt:
- IELTS Part 2 style (2-minute talk)
- Includes task card and bullet points
- Optional follow-up question
Record Response:
- Student clicks “Start Recording”
- Speaks for up to 2 minutes (configurable)
- Click “Stop Recording” when finished
Analyse Recording:
- AI estimates IELTS band scores for:
  - Fluency and coherence
  - Lexical resource
  - Grammatical range and accuracy
  - Pronunciation
- Provides specific improvement suggestions

6.3 Essay Writing and Automated Feedback

Purpose: Develop structured writing skills

How It Works:

Generate Essay Topic:
- AI creates thought-provoking prompt
- Topics across various subjects
Write Essay:
- Student writes in the text area
- Timer tracks writing time
- No length limit
Analyse Essay:
- AI evaluates:
  - Structure and organisation
  - Thesis statement and argument development
  - Grammar, spelling, and punctuation
  - Use of evidence and examples
  - Overall coherence and flow
- Provides score out of 10
- Offers detailed improvement suggestions

6.4 IELTS Test Simulation

Purpose: Full IELTS practice across all sections

Test Types:

Academic:For university admission
General Training:For work or migration

Sections:

Section	Description	Tasks
Listening	Simulated audio with questions	10 multiple-choice questions
Reading	Passage with comprehension questions	Various formats (MC, TFNG, matching)
Writing	Two tasks	Task 1: Graph/letter, Task 2: Essay
Speaking	Three parts	Introduction, Long turn, Discussion

Scoring:

Section scores (1.0-9.0)
Overall band score (average of sections)
Detailed feedback for each section

6.5 Feedback Toggle Systems

Feedback Types:

Type	Tone	Best For
Normal	Balanced, neutral	General practice
Supportive	Encouraging, gentle	Low confidence learners
IELTS	Strict, academic	Exam preparation
Rude	Blunt, direct	Advanced learners who want honest critique

Chapter 7: Tutorial Module (The Tutorial Tab)

7.1 AI-Generated Tutorial Content

Purpose: Create personalised lessons on any topic

How It Works:

Enter Topic:Type any subject (e.g., “photosynthesis”, “how computers work”)
Generate:AI creates a comprehensive tutorial
Content Structure:
- Key concepts explained simply
- Real-world examples
- Practice questions
- Summary of main points

Example Tutorial Output:

text

PHOTOSYNTHESIS

What is Photosynthesis?

Photosynthesis is how plants make their own food. It’s like a plant’s kitchen!

The Recipe:

– Sunlight (energy)

– Water (from the ground)

– Carbon dioxide (from the air)

The Plant Makes:

– Glucose (sugar for energy)

– Oxygen (for us to breathe)

Where It Happens:

Inside the leaves, in tiny parts called chloroplasts.

Practice Question:

What three things do plants need for photosynthesis?

(Answer: Sunlight, water, and carbon dioxide)

7.2 Text-to-Speech Integration for Reading Assistance

Features:

Read Tutorial:Whole tutorial is spoken aloud
Stop Reading:Cancel speech at any time
Voice Selection:Uses the same voice as quiz mode

Benefits for Young Learners:

Follow along while listening
Improves reading skills
Supports learners with dyslexia

7.3 Tutorial History and Review

Storage:

All generated tutorials are saved automatically
Stored in browser local storage
Up to 100 tutorials kept (older ones auto-delete)

Review Features:

Search:Find tutorials by topic
View:See full tutorial content
Read:Listen to tutorial again
Download:Save as PDF or text file
Email:Send to someone else
Delete:Remove unwanted tutorials

7.4 Voice-Controlled Topic Exploration

How to Use:

Click the microphone button next to the topic input
Say your topic clearly
The text appears in the box
Click “Generate Tutorial”

Supported Commands:

Any topic name (e.g., “dinosaurs”, “fractions”)
Follow-up questions after tutorial generation

Volume III: Social and Competitive Learning

Chapter 8: Online Multiplayer System

8.1 Firebase Real-time Database Architecture

Firebase provides the real-time infrastructure for multiplayer features:

text

│ Firebase Structure │

│ │

│ /onlinePlayers/ │

│ ├── {playerId}: { name, location, status, lastActive } │

│ │

│ /rooms/ │

│ ├── {roomId}: { name, host, players, status, createdAt } │

│ │

│ /chat/ │

│ ├── global/: { messages } │

│ └── room-{roomId}/: { messages } │

│ │

│ /leaderboard/ │

│ ├── {playerId}: { score, accuracy, gamesPlayed, lastUpdated }│

│ │

│ /publicHistory/ │

│ └── {sessionId}: { subject, scores, playedAt } │

│ │

│ /privateHistory/ │

│ └── {deviceId}/{sessionId}: { full session data } │

│ │

8.2 Game Room Creation and Management

Creating a Room:

Click “Create Room” in the Game Rooms section
Enter a room name
Select game mode (Classic Quiz, Speed Run, Trivia Battle)
Set maximum players (2, 4, or 8)
Set time per question
(Optional) Add a password
(Optional) Make room private (requires host approval to join)

Room Statuses:

Waiting:Accepting players
Playing:Game in progress
Full:Maximum players reached

Room Management:

Host:Can start game, delete room
Players:Can ready up, leave room
Chat:Room-specific chat for strategy

8.3 Matchmaking Algorithms and Player Matching

Quick Match:

Automatically finds an available room
Matches based on:
- Open rooms with waiting status
- Similar skill level (when enough data)
- Geographic region (for latency)

Tournament Mode:

8-player bracket
Rounds: Quarter-finals → Semi-finals → Final
Highest scores advance

8.4 Global Chat and Communication Systems

Global Chat:

All online players can see and reply
Real-time message delivery
Profanity filtering with strike system
3 strikes = 5-day ban

Room Chat:

Only players in the same room
Private to the room
Useful for strategy during games

Voice Messages:

Record and send audio clips
Playback in chat
Transcribed for accessibility

8.5 Leaderboard Structures and Ranking Algorithms

Player Rankings:

Based on accuracy percentage
Weighted by games played
Updated after each public result

Location Rankings:

Groups players by organisation/school/location
Combined score = (total games × 2) + average accuracy
Like TT Rockstars but for all subjects

All-Time Leaderboard:

Cumulative points across all quizzes
Points = correct × 10 – wrong × 2
Level = floor(points / 50) + 1

8.6 Tournament Systems and Knockout Mechanics

Tournament Flow:

text

Round 1 (Quarter-finals):

Match 1: Player A vs Player B → Winner 1

Match 2: Player C vs Player D → Winner 2

Match 3: Player E vs Player F → Winner 3

Match 4: Player G vs Player H → Winner 4

Round 2 (Semi-finals):

Match 5: Winner 1 vs Winner 2 → Winner 5

Match 6: Winner 3 vs Winner 4 → Winner 6

Round 3 (Final):

Match 7: Winner 5 vs Winner 6 → Tournament Champion

Chapter 9: Times Tables Rock Stars Modes

9.1 Festival Mode: Global Live Competition

Concept: Like a music festival for times tables!

Features:

Compete live against players worldwide
Choose any table (1× to 12×) or random
60-second race
Unlimited questions until time ends
Live ranking shown as you play

How to Play:

Click “Festival” in Game Modes
Choose your table (or random)
Click “Join Festival”
Answer as many questions as possible in 60 seconds
See your rank against all global players

9.2 Arena Mode: Classroom Live Races

Concept: Race your classmates!

Features:

Teacher sets the table
All students play simultaneously
90-second race
20 questions
Most correct answers wins

How to Play:

Teacher creates a room with the chosen table
Students join with room code
Teacher clicks “Start”
Students race to answer fastest

9.3 Rock Slam: Asynchronous Head-to-Head Challenges

Concept: Set a score for a friend to beat

Features:

Challenge any specific player
Set a score (your best)
Friend sees your score and tries to beat it
No time limit
Can add a personal message

How to Play:

Click “Rock Slam”
Choose your table
Enter challenge message
Play to set your score
Share the link with your friend

9.4 Battles: Group vs. Group Competitions

Concept: Classes compete against each other

Features:

Whole classes or year groups
Average score determines winner
120 seconds, 40 questions
Results appear in Location Rankings

How to Play:

Click “Battles”
Enter your class name
Choose subject/table
Play as many games as you want
Your class’s average is compared to others

Chapter 10: Group Competition Engine

10.1 Student Selection and Group Formation

Purpose: Create custom groups for competitions

How It Works:

Select Players:
- From public leaderboard
- Filter by name
- Select multiple players
Create Groups:
- Add group names (e.g., “Team A”, “Team B”)
- Drag players into groups
- Unlimited groups
Assign:
- Click “Run Comparison” to see results
- Groups are compared side-by-side

10.2 Comparison Algorithms and Metrics

Metrics Compared:

Accuracy:Percentage of correct answers
Correct Answers:Raw count
Wrong Answers:Raw count
Games Played:Number of sessions
Fastest Time:Best response time
Total Questions:Sum of all questions attempted

Group Summary:

Average accuracy
Total correct/wrong
Total games played
Best time

Sorting Options:

By accuracy (highest to lowest)
By correct answers
By games played
By name
By fastest time

10.3 Saved Competitions and Historical Data

Saving:

Click “Save” to store current groups
Title your competition
Saves all group assignments and scores

Loading:

Click “Load Saved” to see previous competitions
Restore any saved competition
Re-run comparisons

10.4 Export Functionality for Reporting

Export Options:

CSV:Spreadsheet format
Contains: Group, Rank, Name, Subject, Difficulty, Shared Results, Correct, Wrong, Total Q, Last Played, Accuracy %, Fastest Time

Use Cases:

Email results to parents
Print for classroom wall
Import into Excel for analysis

Volume IV: Administrative and Reporting Systems

Chapter 11: Classroom Management (The Classroom Tab)

11.1 Student Registration and Approval Workflow

Student Self-Registration:

Student fills in registration form:
- Full name
- Age
- Class/year/grade
- Level (Primary, Secondary, University)
- Guardian name (optional)
- Student ID (optional)
- Device ID (auto-filled or entered)
Submits registration
Status = “pending”

Admin Approval:

Teacher goes to Admin panel
Sees list of pending students
Clicks “✅” to approve or “❌” to reject
Approved students appear in roster

Quick Register by Device ID:

Teacher enters Device ID and name
Student auto-approved
Useful for remote students

11.2 Lesson Planner and Scheduling

Creating a Lesson Plan:

Go to Lesson Planner section
Click “+ New Lesson Plan”
Enter:
- Lesson title
- Subject
- Date and time
- Duration
- Type (Lesson, Quiz, Break, Assembly)
- Number of questions (for quizzes)
- School level
- Teaching style
- Topics (unlimited)
- Curriculum notes
- Teacher notes
- Approval PIN (optional)
- Device lock (optional)
Click “Save Lesson Plan”

Lesson Plan Features:

Alarms:Set reminders 15 and 5 minutes before lesson
Assign to Students:Select which students get this lesson
Make Public:Allow students to discover and request to join
Device Lock:Restrict to specific device ID

11.3 Live Classroom Session Management

Starting a Live Session:

Select a lesson plan
Click “Launch This Lesson”
Students appear in live panel
AI teacher begins speaking

Live Session Controls:

Speak:Teacher can speak to students
Ask Student:Call on a specific student
Quiz:Launch a quick quiz
Next Topic:Move to next lesson topic
Image:Generate a lesson image
Leaderboard:Show current rankings
Pause:Pause the session
Add Camera:Add video feed

Student Interaction:

Students can type or speak questions
AI responds in real-time
All interactions saved to transcript

11.4 Voice and Language Settings for AI Teacher

Voice Configuration:

Language:50+ languages supported
Gender:Female, Male, Any
Age:Adult, Child, Senior
Speed:5× to 2.0×
Pitch:5 to 2.0
Specific Voice:Choose from available system voices

Language Support:

European: English, Spanish, French, German, Italian, Portuguese, Dutch, Polish, Swedish, Danish, Finnish, Norwegian, Greek, Czech, Slovak, Romanian, Hungarian, Bulgarian, Croatian, Serbian, Ukrainian, Catalan, Basque, Galician, Latvian, Lithuanian, Estonian, Slovenian, Albanian, Macedonian, Maltese, Welsh, Irish, Scottish Gaelic
Asian: Mandarin, Japanese, Korean, Hindi, Urdu, Bengali, Tamil, Telugu, Kannada, Malayalam, Gujarati, Marathi, Punjabi, Sinhalese, Nepali, Persian, Hebrew, Kurdish, Pashto, Azerbaijani, Uzbek, Kazakh, Mongolian, Burmese, Khmer, Lao, Georgian, Armenian, Indonesian, Malay, Tagalog, Thai, Vietnamese
African: Amharic, Hausa, Yoruba, Igbo, Zulu, Xhosa, Afrikaans, Somali, Tigrinya, Shona, Kinyarwanda, Lingala, Wolof
Americas: Haitian Creole, Quechua, Guarani, Nahuatl

11.5 Curriculum Upload and Knowledge Integration

Upload Formats:

PDF files
Word documents (.doc, .docx)
Text files (.txt)
Images (PNG, JPG)

How It Works:

Upload files via drag-and-drop or file selector
System extracts text content
Text is added to AI context
AI uses this content for generating questions and lessons

Use Cases:

Upload textbooks for customised lessons
Add school syllabuses for aligned content
Include teacher’s own notes and materials

11.6 Safeguarding and Content Filtering

Always Blocked Topics:

Violence and weapons
Adult content and sexual material
Self-harm and suicide
Drugs and alcohol
Abuse
Radicalisation and extremism

Custom Blocked Topics:

Teachers can add their own blocked words/phrases
AI will refuse to engage with these topics
Admin password required to modify

Strike System:

Profanity in chat = strike
3 strikes = 5-day ban
Teacher can review strikes in admin panel

Chapter 12: Teacher Dashboard

12.1 Student Performance Overview

Summary Cards:

Students:Number of approved students
Avg Accuracy:Average across all students
At Risk:Students with <50% accuracy on recent quizzes
Total Quizzes:All quizzes taken

Student Grid:

Each student card shows:
- Name and class
- Accuracy percentage
- Number of quizzes taken
- Recent performance trend
- Grade (from active grading profile)

12.2 At-Risk Student Identification

Criteria:

Accuracy < 50% on last 3 quizzes
Consistent decline in performance
No recent quiz activity

Intervention Options:

Click student card to see details
Assign targeted homework
Schedule support class
Contact parent via Parent Day

12.3 Data Visualisation and Analytics

Performance Over Time:

Line chart showing accuracy trend
Filter by subject, date range
Compare multiple students

Subject Breakdown:

Bar chart showing performance by subject
Identify strengths and weaknesses

Player Comparison:

Compare multiple students side-by-side
Identify outliers and patterns

12.4 Individual Student Progress Tracking

Student Details:

Quiz history with scores and times
Homework completion status
Classroom session attendance
Tutorial history
Individual feedback notes

Chapter 13: Homework System

13.1 Assignment Creation and Topic Selection

Creating an Assignment:

Click “+ Assign New”
Enter:
- Subject
- Topics (select from lessons, plans, custom topics, or type new)
- Due date and time
- Time limit (minutes)
- Number of questions
- Instructions (optional)
Click “Assign”

Topic Selection Tools:

Quick-add from sources:
- Lessons Taken: Topics from past sessions
- Lesson Plans: Topics from scheduled lessons
- Custom Topics: Saved custom topics
- Active Session Topics: Currently used subjects
Free-text entry:Type any topic
Bulk add:Add multiple topics at once

13.2 Student Assignment and Distribution

Assign To:

Select individual students
“All” button selects all approved students
“Clear” button deselects all

Assignment Delivery:

Students see assignments in their Student Portal
Click “Start Assignment” to begin
Results automatically recorded

13.3 Submission Tracking and Completion Monitoring

Teacher View:

List of all assignments
Submission progress bar
Per-student status:
- Pending: Not started
- Completed: Submitted with score
- Overdue: Past due date

Student View:

Pending homework list
Start button
Timer visible during quiz

13.4 Feedback Integration

After Submission:

Student sees immediate score and feedback
Teacher can view results in dashboard
Notes can be added per student

Chapter 14: Parent Day Consultation System

14.1 Consultation Modes

Mode	Description	AI Behaviour
Private	Parent and teacher only	Professional, honest, covers all data
Family	Parent, child, AI together	Warm, addresses both, involves child
Student-Led	Child presents progress	Coaching, prompting reflection
Support Plan	Urgent intervention	Focus on action plan, concrete steps
Celebration	Recognise achievements	Highlight success, set new goals
Homework Review	Review assignments	Analyse patterns, suggest adjustments

14.2 Multi-Parent Participation

Adding Parents:

Type parent name
Select role (Mother, Father, Guardian, Grandparent, etc.)
Click “+ Add”
Multiple parents can be added

Speaker Selection:

Each message can be tagged with speaker
AI addresses each parent by name
Supports family meetings with multiple attendees

14.3 Unlimited Language Support

Language Selection:

Dropdown with 100+ languages
Type any language name (e.g., “Yoruba”, “Welsh”)
AI automatically translates all responses

How It Works:

System prompt includes: “Respond entirely in {language}”
All questions, answers, and explanations translated
Voice uses matching language if available

14.4 AI-Powered Meeting Summaries

Snapshot Panel:

Shows student’s overall performance
Includes data from ALL activities:
- Classroom quizzes
- History Quiz tab
- IELTS/Quiz 2
- Tutorials
- Classroom sessions
- Homework

System Prompt Includes:

Student name, class, age
Combined accuracy across all activities
Strengths and weaknesses by topic
Trend analysis
Parent concerns
Goals

14.5 Action Point Generation and Follow-up Emails

Action Buttons:

Button	Output
📋 Learning Plan	Personalised 4-week plan with SMART goals
📝 Adjust Homework	Calibrated assignment based on current level
🏠 Parent Guide	Daily home activities and support strategies
✅ Action Points	Structured list of agreed next steps
📊 Progress Report	Formal school report format
🧠 Behaviour Note	Confidential note for school file
✉️ Next Steps Email	Professional follow-up email to parents

Email Generation:

Automatic email draft
Includes all action points
Can be sent directly from the system

14.6 Consultation History and Replay

Storage:

All consultations saved automatically
Stores: student, parents, mode, language, date, transcript

Replay Features:

Replay the entire conversation
Click any point to jump to that message
Speech synthesis replays audio
Adjust playback speed (1×, 2×, 4×, Slow)

Export:

Download transcript as text file
Email transcript directly
Action points extracted automatically

Chapter 15: Reports and Analytics (The Reports Tab)

15.1 Data Aggregation and Filtering

Filters:

Period:Last 7 days, 30 days, 90 days, 1 year, All time
Subject:Single or multiple subjects
Player:Single player or all
Min/Max %:Filter by accuracy range
Difficulty:Easy, Medium, Hard, All
Search:Full-text search across subjects, players, questions

Data Sources:

All quiz history (from all tabs)
All players
All subjects

15.2 Chart Generation

Chart Types:

Type	Best For
Bar	Comparing groups (e.g., subjects)
Line	Showing trends over time
Radar	Comparing multiple metrics
Pie	Showing proportions
Doughnut	Showing proportions with centre value

15.3 Drag-and-Drop Chart Customisation

How It Works:

Available Fields:Player Name, Subject, Difficulty, Games Played, Correct, Wrong, Accuracy, Date, Fastest Time
Drag to X Axis:Defines categories (e.g., Subject, Name)
Drag to Y Axis:Defines values (e.g., Accuracy, Correct)
Select Chart Type
Click “Draw Chart”

Multiple Y Axes:

Can drag multiple fields to Y axis
Creates combined chart (e.g., Accuracy + Correct)

15.4 Export Functionality

Export Formats:

PDF:Full report with charts and summary
Email:Send report directly
CSV:Raw data for spreadsheet analysis

15.5 Performance Over Time Analysis

Time Series Chart:

Shows accuracy across dates
Identifies improvement or decline
Overlay multiple students for comparison

Volume V: Creative and Collaborative Tools

Chapter 16: Whiteboard System

16.1 Drawing Tools

Tool	Icon	Function
Pen	✏️	Draw freehand lines
Eraser	🧹	Remove parts of drawing
Text	📝	Add text anywhere
Highlighter	🖍️	Semi-transparent highlighting

16.2 Colour Selection and Brush Size

Colour Picker:

Click on colour box
Choose any colour from the palette
Hex code can be typed directly

Brush Size:

Slider from 1px to 50px
Live preview of size
Eraser uses the same size

16.3 Undo/Redo History and Clear Functions

Undo/Redo:

Undo: Reverses last action
Redo: Restores undone action
History limited to 20 actions per page

Clear:

Removes everything on current page
Asks for confirmation
Cannot be undone

16.4 Multi-Page Management

Pages Sidebar:

List of all pages
Click to switch pages
Unlimited pages

Page Actions:

Add New Page:Creates new blank page
Rename:Edit page name
Delete:Remove page (cannot delete last page)

16.5 Zoom and Fullscreen Modes

Zoom:

Zoom In (+): Magnifies view
Zoom Out (-): Shrinks view
Zoom level shown as percentage (50% to 200%)
Canvas remains full resolution

Fullscreen:

Maximises whiteboard to window size
Great for presentations
Exit by clicking button again

16.6 Save and Load Functionality

Save:

Saves all pages to browser storage
Includes all drawings, text, and page structure

Load:

Loads previously saved whiteboard
Replaces current content

Export:

Download current page as PNG image
Useful for sharing or printing

Chapter 17: Certificates and Achievement Badges

17.1 Badge Definitions and Award Criteria

Badge	Icon	Criteria
Perfect Score	💯	100% on any quiz
Star Learner	⭐	Average ≥90%
Most Improved	📈	Rising trend in scores
Consistent	🎯	≥5 quizzes taken
Scholar	📚	Average ≥80%
First Steps	🌟	Completed first quiz
Decade	🔟	10+ quizzes done
Homework Hero	📝	Registered via quiz tab
Multilingual	🌍	Has class/location set
Top of Class	🥇	Highest score in class

17.2 Certificate Template Library

Templates:

Template	Background	Border	Icon
Classic Gold	Gold gradient	Orange	🏅
Royal Blue	Blue gradient	Dark blue	👑
Emerald	Green gradient	Green	💎
Midnight	Dark gradient	Purple	✨
Rose Award	Pink gradient	Pink	🌹
Purple Excellence	Purple gradient	Purple	🔮

17.3 Student Selection and Bulk Generation

Select Students:

Click student cards to select
“Select All” selects all students
“Eligible Only” selects students with ≥70% average
“Clear” deselects all

Bulk Generation:

Select multiple students
Choose template
Generate all certificates at once
Download as PDFs

17.4 PDF Generation and Print Functionality

PDF Generation:

Each certificate on separate page
Landscape orientation
High-quality vector graphics
Ready for printing

Printing:

Click “Print All”
Print directly from browser
Use printer settings for colour/b&w

17.5 Auto-Award System Based on Performance

When Auto-Awarded:

After each quiz, system checks if student qualifies for new badges
New badges shown in results
Badges appear on certificates

Updating Certificates:

Regenerate certificate to include latest badges
Old certificates remain unchanged

Volume VI: Cloud Integration and Synchronisation

Chapter 18: Cloud Sync Engine

18.1 Supported Cloud Providers

Provider	Authentication	Best For
Custom REST API	API Key or Bearer Token	Any custom backend
Microsoft Azure	Function Key + SAS Token	Azure Functions + Cosmos DB
Microsoft Dataverse	OAuth2 Client Credentials	Power Platform, Dynamics 365
Amazon AWS	API Gateway Key	Lambda + RDS/DynamoDB
WordPress	Application Password	School websites, blogs

18.2 Bidirectional Synchronisation Architecture

text

┌─────────────────┐ ┌─────────────────┐

│ Local Device │ │ Cloud Server │

│ │ │ │

│ ┌───────────┐ │ │ ┌───────────┐ │

│ │ localStorage│◄─ Push ──►│ │ Database │ │

│ └───────────┘ │ │ └───────────┘ │

│ │ │ │

│ ┌───────────┐ │ │ │

│ │ State │◄─ Pull ────│ │

│ └───────────┘ │ │ │

└─────────────────┘ └─────────────────┘

Push: Local → Cloud (send changes)

Pull: Cloud → Local (receive updates)

Merge: Combine both sets with conflict resolution

18.3 Table Structure and Data Mapping

Table Key	Description	Fields
gs_students	Student records	id, name, age, class, status, deviceId, score, quizHistory
gs_quiz_results	Classroom quiz results	id, subject, scores, players, isPublic
gs_lectures	Classroom sessions	label, subject, topics, transcript, students
gs_settings	Teacher settings	teacherName, schoolName, blocked, teachingStyle
qm_quiz_history	Quiz tab history	id, date, subject, players, questions, isPublic
qm_quiz2_history	IELTS/Quiz2 history	type, topic, score, feedback, text
qm_tutorial_history	Tutorials	topic, content, date
qm_custom_topics	Custom subjects	title, body
qm_custom_questions	Custom questions	question, options, correct
gr_pd_history	Parent consultations	student, parents, mode, transcript
pd_admin_settings	Parent Day admin	blocked, phrases, instructions

18.4 Authentication and Security

API Key Authentication:

X-API-Key header
Stored locally, never shared

Bearer Token:

Authorization: Bearer {token}
For OAuth2 and JWT

WordPress Application Passwords:

Base64(username:app-password)
Generated in WordPress user profile

18.5 Auto-Sync Scheduler and Logging

Auto-Sync Interval:

Configure in minutes (0 = off)
Default: off
Maximum: 360 minutes

Sync Log:

Records all sync operations
Timestamp, table, direction, count
Success/failure status
Stored locally, can be cleared

Chapter 19: Firebase Integration

19.1 Real-time Database Structure

text

/gilrobomultiplayer-f926d-default-rtdb/

│

├── onlinePlayers/

│ └── {playerId}/

│ ├── id

│ ├── name

│ ├── location

│ ├── status (online/in_game)

│ └── lastActive (timestamp)

│

├── rooms/

│ └── {roomId}/

│ ├── name

│ ├── host

│ ├── players/{playerId}

│ ├── status (waiting/playing)

│ └── createdAt

│

├── chat/

│ ├── global/

│ └── room-{roomId}/

│

├── leaderboard/

│ └── {playerId}/

│ ├── name

│ ├── score

│ ├── accuracy

│ └── gamesPlayed

│

├── publicHistory/

│ └── {sessionId}/

│ ├── subject

│ ├── players

│ ├── playedAt

│ └── scoreLocked

│

├── privateHistory/

│ └── {deviceId}/{sessionId}/

│

├── gsStudents/

│ └── {studentId}/

│ ├── name

│ ├── deviceId

│ └── status

│

├── lessonPlans/

│ └── {planId}/

│ ├── title

│ ├── assignedTo

│ └── isPublic

│

└── gs_join_requests/

└── {requestId}/

├── studentId

├── planId

└── status (pending/approved/denied)

19.2 Public History and Leaderboard Synchronisation

Public History:

Automatically created when user makes a result public
Contains anonymised data (names visible, but no IDs)
Used for global leaderboard

Leaderboard Calculation:

Aggregates all public history
Groups by player name
Calculates: total correct, total wrong, accuracy, games played, fastest time

19.3 Private History and Device-Specific Storage

Purpose: Store complete session data for every device

Structure:

Root: privateHistory/{deviceId}/{sessionId}
Also mirrored in allPrivateHistory/{sessionId}for admin

Contents:

Full session details
Player answers
Question text
Timing data

Access:

Admin can view all devices
Students can view their own device’s history
Parents can view child’s device with Device ID

19.4 Lesson Plan Distribution to Student Devices

Teacher Side:

Create lesson plan
Assign to students (by student ID)
Save → auto-syncs to Firebase

Student Side:

Student logs in with Device ID
System fetches lessonPlans from Firebase
Filters by assignedTo containing student ID
Shows in student portal

19.5 Join Request and Approval Workflow

text

Student Teacher

│ │

├─ “Request to Join” ─────────►│

│ │

│ ├─ Review request

│ │

│ ├─ Click “Approve”

│ │

│◄─ Firebase status=”approved”─┤

│ │

├─ Lesson unlocked ────────────┤

│ │

└─ Start lesson ───────────────┘

Volume VII: Advanced Features and Customisation

Chapter 20: Grading Profiles

20.1 Grade Band Definition

Purpose: Convert percentage scores into meaningful grades

Structure:

text

Grade Band:

– Label: “A*” or “9” or “Distinction”

– Min %: 90%

– Background colour: #dcfce7

– Text colour: #15803d

Predefined Profiles:

UK SATs (Primary): Greater Depth, Expected Standard, Working Towards
GCSE 9–1 (England): 9,8,7,6,5,4,3,2,1,U
A-Level (A–E): A,A,B,C,D,E,U
US Letter Grades: A+,A,A-,B+,B,B-,C+,C,C-,D,F
IB (1–7): 7,6,5,4,3,2,1
Scotland (National 5): A,B,C,D,No Award
Distinction/Merit/Pass: Distinction*, Distinction, Merit, Pass, Refer
Simple Pass/Fail: Pass (≥50%), Fail (<50%)

20.2 Subject-Specific Grading

How It Works:

Create separate profiles for different subjects
Example: Maths GCSE profile, English GCSE profile
System checks subject match first, then falls back to global profile

20.3 Active Profile Management

Activating a Profile:

Profiles list shows all saved profiles
Click “Activate” next to profile
Active profile highlighted
Grade column appears in leaderboard and results

Deactivating:

Click “Deactivate” to remove grade column
Grades still stored, just not displayed

20.4 Preset Library and Custom Creation

Loading Presets:

Click “Load Preset”
Select from list
Automatically adds to profiles

Creating Custom Profiles:

Click “Create New Profile”
Enter profile name
(Optional) Enter subject
Add grade bands:
- Label (e.g., “A+”)
- Min %
- Background colour
- Text colour
Click “Save Profile”

Chapter 21: Custom Content Creation

21.1 Custom Topics: Structure and Storage

Creating a Custom Topic:

Go to “Custom Topics” tab
Enter a title (e.g., “The Industrial Revolution”)
Enter detailed body text (can be multiple paragraphs)
Click “Save Topic”

Storage:

Stored in localStorage as qm_custom_topics
Each topic has: id, title, body
Used for generating AI questions

Using Custom Topics:

Appears in subject dropdown as “[Custom] Title”
AI generates questions based on body text
Can be used in any quiz

21.2 Custom Questions: Format and Integration

Creating a Custom Question:

Go to “Custom Questions” tab
Enter question text
Enter 4 options (A, B, C, D)
Select correct answer
Click “Save Question”

Format:

json

{

“id”: “cq_123456”,

“question”: “What is photosynthesis?”,

“options”: [

“The process of making food using sunlight”,

“The process of breathing”,

“The process of reproduction”,

“The process of digestion”

“correct”: “A”,

“reason”: “Photosynthesis is how plants make food from sunlight, water, and carbon dioxide.”

}

Integration:

Custom questions are mixed with AI-generated questions
Used in quizzes automatically
Appear in results and history

21.3 Knowledge Upload (PDF, Word, Text)

Supported Formats:

PDF files (.pdf)
Microsoft Word (.doc, .docx)
Text files (.txt)

How to Upload:

Go to “Custom Knowledge Upload” tab
Drag files into drop zone OR click to browse
Multiple files can be uploaded
Files appear in list with remove option

Processing:

System extracts text content
Text is added to knowledge context
AI uses this content for generating questions

21.4 AI Generation from Custom Knowledge

Process:

User uploads files and/or pastes text
Click “Generate Questions from Knowledge”
System sends knowledge content to AI
AI generates questions based on the content
Questions are presented as a quiz

Use Cases:

Upload textbook chapters for custom quizzes
Add teacher’s notes for class-specific content
Generate questions from any educational material

Chapter 22: Admin Panel and Access Control

22.1 Tab Lock System and Role-Based Access

Roles:

Role	Permissions
Admin	Full access to all tabs
Trader	Access to Setup, Players, Custom Topics, Custom Questions, Custom Knowledge, Quiz, Quiz 2, Multiplayer, Whiteboard, Reports, Results, History, Tutorial, Tutorial History, Teacher Dashboard, Homework
Viewer	Access to Setup, Quiz, Quiz 2, Tutorial, Tutorial History, Homework
Customer	Access to Setup, Quiz, Tutorial, Homework

Locking Tabs:

Admin can lock any tab
Locked tabs require access code
Some tabs are never locked (Guide)

22.2 Access Code Generation

Generating Codes:

Admin unlocks panel
Select role
Set expiry (days)
Click “Generate Code”
Code appears as “APS-XXXX-XXXX”

Code Features:

Expires after set days
Can be used once (single-use)
Role assigned on redemption
Can be deleted by admin

22.3 Password Management and Security

Default Password: admin2024

Changing Password:

Unlock admin panel
Enter new password in “Change Admin Password”
Click “Save”
Password stored in localStorage

Security Notes:

Password is stored in browser storage
Not encrypted
Change default password immediately

22.4 URL Embedding for Role-Specific Access

URL Format:

text

Home

Parameters:

role: Admin, Trader, Viewer, Customer
code: Generated access code

How It Works:

When URL is opened, system reads parameters
Automatically applies role and code
User sees only permitted tabs

Volume VIII: Alerts, Notifications, and Engagement

Chapter 23: Alarm and Notification Engine

23.1 Lesson Plan Alarms

Reminder Types:

1st Reminder:15 minutes before lesson
2nd Reminder:5 minutes before lesson

Per-Lesson Settings:

Enable/disable alarms
Set custom reminder times
Choose alarm sound
Add custom spoken message

Global Settings:

Master on/off
Default reminder times
Default sound
Default spoken message

23.2 Sound Synthesis

Sound Types:

Sound	Description	Use Case
Bell	Double ding, rich timbre	General reminder
Chime	Ascending pentatonic notes	Gentle reminder
Beep	Triple beep	Urgent reminder
Silent	No sound	Notification only

Implementation:

Web Audio API
No external files needed
Works offline
Cross-browser compatible

23.3 Browser Notifications and Permission Handling

Permission Request:

First alarm triggers permission request
User must click “Allow”
Stored for future sessions

Notification Content:

Title: “🔔 Lesson Reminder: [Lesson Title]”
Body: “Starting in [X] minutes — [Time]”
Icon: (if set)

Mobile Considerations:

Requires browser to be open
Some browsers require site to be pinned
May need device settings to allow notifications

23.4 On-Screen Banner System

Banner Appearance:

Slides down from top of screen
Amber for 1st reminder
Red for 2nd reminder
Dismiss button

Content:

Lesson title
Time until start
Dismiss option

Auto-dismiss:

After 15 seconds
Or user clicks “Dismiss”

23.5 Spoken Alarm Messages with Text-to-Speech

Message Format:

If custom text provided: “Reminder. [Custom text]”
If no custom text: “Reminder: your lesson, ‘[Lesson Title]’, starts in [X] minutes at [Time].”

Voice Settings:

Uses selected TTS voice
Adjustable speed (0.6× to 1.6×)
Pitch adjustment

Urgency:

2nd reminder adds “Urgent reminder: ” prefix
Reduces time between alarm and lesson start

Chapter 24: Email Notification System

24.1 WordPress REST API Integration

Requirements:

WordPress site with REST API enabled
Application password generated in user profile
Custom endpoint or plugin

WordPress Setup:

In WordPress admin, go to Users → Your Profile
Scroll to “Application Passwords”
Add new application (e.g., “GilRobo”)
Copy generated password
Paste into GilRobo settings

Sending Emails:

Uses wp_mail() function
Subject: “🔔 Lesson Reminder: [Lesson Title]”
Body: Contains lesson details and reminder message

24.2 mailto: Fallback Mechanism

How It Works:

Opens user’s default email client
Pre-populates to, subject, and body
User clicks send manually

Pros:

No configuration needed
Works on all devices
Privacy-friendly

Cons:

User must click send
Not automatic

24.3 EmailJS Cloud Service Integration

Setup:

Create free account at com
Create email service (Gmail, Outlook, etc.)
Create email template
Get Service ID, Template ID, Public Key
Paste into GilRobo settings

Sending:

Uses EmailJS API
No server-side code needed
Free tier: 200 emails/month

24.4 Email List Management

Adding Emails:

Enter email address
(Optional) Add label (e.g., “Mum”)
Click “+ Add”

Managing List:

View all emails with labels
Remove emails with delete button
First email marked as primary

Saving:

All settings saved to localStorage
Password required to view/edit

24.5 Test Email Functionality

Test Features:

Send test email to all addresses
Uses selected method (WordPress, mailto:, EmailJS)
Shows success/failure for each address

Troubleshooting:

Check API keys and settings
Verify network connection
Check email spam folder

Chapter 25: Focus Lock System

25.1 Pre-Lesson Tab Blocking

Purpose: Keep students focused on the lesson

How It Works:

Activates 5 minutes before lesson
Detects when user switches tabs
Brings focus back to lesson tab
Shows warning message

Blocking:

Tab switching is prevented
Window blur events are captured
Beforeunload warning when closing

25.2 Countdown Timer and Visual Feedback

Timer Display:

Circular progress ring
Minutes remaining
Colour changes: orange → red as time runs out

Ring Progress:

Full circle at 5 minutes
Empty circle at 0 minutes
Smooth transition

Icon Changes:

🔒 Normal lock (5+ minutes)
⚠️ Warning (2 minutes)
🚨 Urgent (0 minutes)

25.3 Parent/Admin Unlock Mechanism

Unlocking:

Click “Parent Unlock”
Enter admin password
Focus Lock dismissed

Why Unlock?

Student finishes early
Technical issue
Parent needs to use device

25.4 Automatic Lesson Launch

Auto-Launch:

When countdown reaches 0
System automatically navigates to lesson
Launches the lesson plan
No user action required

If Lesson Starts:

Focus Lock dismissed
Student enters lesson automatically

Volume IX: Technical Appendices

Appendix A: Data Storage Schema

A.1 localStorage Structure

Key	Description	Format
qm_api	API key	String
qm_players	Current quiz players	Array of player objects
qm_custom_topics	Custom topics	Array of {id, title, body}
qm_custom_questions	Custom questions	Array of question objects
qm_quiz_history	Quiz history	Array of session objects
qm_quiz2_history	Quiz 2 history	Array of assessment objects
qm_tutorial_history	Tutorial history	Array of tutorial objects
gs_students	Student records	Array of student objects
gs_quiz_results	Classroom results	Array of result objects
gs_lectures	Classroom sessions	Array of session objects
gs_lesson_plans	Lesson plans	Array of plan objects
gs_settings	Teacher settings	Object with configuration
gr_pd_history	Parent consultations	Array of consultation objects
whiteboardData	Whiteboard state	Object with pages, current page

A.2 Firebase Database Schema

See Chapter 19.1 for complete schema.

A.3 Data Persistence and Backup Strategies

Local Storage:

Persists across browser sessions
Not shared across devices
Size limit: ~5-10MB

Firebase:

Cross-device sync
Real-time updates
Limited to 1GB free

Backup Recommendations:

Use cloud sync regularly
Export CSV for critical data
Keep offline copies of certificates

Appendix B: API Reference

B.1 Supported AI Providers and Endpoints

Provider	Endpoint	Model
DeepSeek	https://api.deepseek.com/chat/completions	deepseek-chat
OpenAI	https://api.openai.com/v1/chat/completions	gpt-4o-mini
Anthropic	https://api.anthropic.com/v1/messages	claude-opus-4-5
Google	https://generativelanguage.googleapis.com/v1beta/models/gemini-pro:generateContent	gemini-pro
Groq	https://api.groq.com/openai/v1/chat/completions	llama-3.1-70b-versatile
Together	https://api.together.xyz/v1/chat/completions	meta-llama/Llama-3-70b-chat-hf
Mistral	https://api.mistral.ai/v1/chat/completions	mistral-large-latest
Cohere	https://api.cohere.ai/v1/chat	command-r-plus
Fireworks	https://api.fireworks.ai/inference/v1/chat/completions	accounts/fireworks/models/llama-v3p1-70b-instruct

B.2 Request and Response Formats

OpenAI-Compatible Request:

json

{

“model”: “deepseek-chat”,

“messages”: [

{“role”: “system”, “content”: “System prompt”},

{“role”: “user”, “content”: “User message”}

“temperature”: 0.7,

“max_tokens”: 2000

}

OpenAI-Compatible Response:

json

{

“choices”: [

{

“message”: {

“content”: “Response text”,

“role”: “assistant”

}

]

}

B.3 Error Handling and Fallbacks

Common Errors:

401: Invalid API key → Prompt user to check key
429: Rate limit → Wait and retry
500: Server error → Fallback to cached content
Network error → Retry with exponential backoff

Fallback Strategies:

Use offline static questions if available
Show cached content
Display user-friendly error message

Appendix C: Offline Content Library

C.1 Times Tables (1× to 12×)

Each table contains 12 questions, one for each multiplier 1-12.

Example: 2× Table Questions:

What is 2 × 1? (2)
What is 2 × 2? (4)
…
What is 2 × 12? (24)

C.2 Addition (P1 to P6)

Level	Description	Example
P1	1-digit addition	5 + 3 = 8
P2	2-digit addition	25 + 48 = 73
P3	3-digit addition	153 + 621 = 774
P4-P6	Mixed multi-digit	266 + 4273 = 4539

C.3 Subtraction (P1 to P6)

Level	Description	Example
P1	1-digit subtraction	5 – 2 = 3
P2	2-digit subtraction	78 – 7 = 71
P3	3-digit subtraction	370 – 123 = 247
P4-P6	Mixed multi-digit	981 – 365 = 616

C.4 Division (P2 to P6)

Level	Description	Example
P2-P3	Basic division	2 ÷ 2 = 1
P4-P6	Long division	16 ÷ 8 = 2

C.5 Mixed Operations (P1 to P6)

Level	Description	Example
P1-P2	Mixed addition/subtraction (1-20)	17 – 13 = 4
P3-P4	Mixed operations with multiplication	28 + 46 = 74
P5-P6	Mixed operations with all four	12 ÷ 1 = 12

C.6 Curriculum Subjects

Primary:

English Language
Mathematics
Basic Science
Social Studies

Secondary:

English Literature
Mathematics
Physics
Chemistry
Biology
History & Geography
Business Studies

Corporate:

Microsoft Excel
IT & Cybersecurity
HR & Soft Skills
Finance & Accounting
Sales & Marketing
GDPR & Compliance
Diversity & Inclusion

Appendix D: Accessibility Compliance

D.1 WCAG 2.1 AA Standards

The platform meets or exceeds the following WCAG 2.1 AA requirements:

Guideline	Compliance	Implementation
1.1.1 Non-text Content	✅	All images have alt text
1.2.1 Audio-only and Video-only	✅	All audio has text alternative
1.3.1 Info and Relationships	✅	Semantic HTML structure
1.3.2 Meaningful Sequence	✅	Logical reading order
1.4.1 Use of Colour	✅	Colour not sole indicator
1.4.3 Contrast (Minimum)	✅	Customisable colours
1.4.4 Resize Text	✅	Font size adjustable
1.4.5 Images of Text	✅	No images of text
1.4.10 Reflow	✅	Responsive design
1.4.11 Non-text Contrast	✅	High contrast mode
1.4.12 Text Spacing	✅	Supports custom spacing
2.1.1 Keyboard	✅	Full keyboard navigation
2.1.2 No Keyboard Trap	✅	Focus never trapped
2.2.1 Timing Adjustable	✅	Timer configurable
2.3.1 Three Flashes	✅	No flashing content
2.4.1 Bypass Blocks	✅	Skip to content links
2.4.2 Page Titled	✅	Descriptive titles
2.4.3 Focus Order	✅	Logical tab order
2.4.4 Link Purpose	✅	Descriptive link text
2.4.6 Headings and Labels	✅	Clear headings
2.4.7 Focus Visible	✅	Visible focus indicators
3.1.1 Language of Page	✅	HTML lang attribute
3.1.2 Language of Parts	✅	Language changes marked
3.2.1 On Focus	✅	No context changes
3.2.2 On Input	✅	Predictable behaviour
3.3.1 Error Identification	✅	Clear error messages
3.3.2 Labels or Instructions	✅	Labels provided
3.3.3 Error Suggestion	✅	Error suggestions
4.1.1 Parsing	✅	Valid HTML
4.1.2 Name, Role, Value	✅	ARIA attributes

D.2 Screen Reader Compatibility

Tested Screen Readers:

NVDA (Windows)
VoiceOver (macOS, iOS)
TalkBack (Android)
JAWS (Windows)

Features:

ARIA landmarks for navigation
Role attributes for custom controls
Live regions for dynamic updates
Announcements for quiz feedback

D.3 Colour Contrast and Font Scaling

Colour Contrast:

Default contrast ratio: 7.2:1
User can adjust background and text colours
High contrast mode available

Font Scaling:

Small: 13px base
Medium: 15px base (default)
Large: 18px base
X-Large: 22px base

D.4 Keyboard Navigation Specifications

Focus Order:

Accessibility toolbar
Main navigation tabs
Tab content
Action buttons
Form elements

Focus Indicators:

Blue outline for keyboard focus
Thick border for active elements
Visible at all zoom levels

Appendix E: Troubleshooting Guide

E.1 Common Errors and Solutions

Error	Cause	Solution
“API key not set”	No API key entered	Paste valid API key in Setup
“Network error”	Internet disconnected	Check internet connection
“Cannot parse questions”	AI response malformed	Try again, use different provider
“Microphone not working”	Permission denied	Allow microphone access in browser
“Whiteboard not saving”	Storage full	Clear browser cache

E.2 API Key Issues

API Key Not Working:

Check key is correctly copied (no spaces)
Verify provider is selected correctly
Check provider service status
Try a different provider

Rate Limiting:

Wait 30-60 seconds
Reduce number of questions
Use offline questions for practice

E.3 Microphone and Camera Permissions

Chrome/Edge:

Click lock icon in address bar
Find “Microphone” / “Camera”
Select “Allow”
Reload page

Safari:

Go to Settings → Websites → Microphone
Find site
Select “Allow”
Reload page

E.4 Connection and Synchronisation Problems

Firebase Not Connecting:

Check internet connection
Disable VPN/Proxy
Allow third-party cookies
Try in incognito mode

Cloud Sync Failing:

Verify endpoint URL
Check API key/credentials
Test connection in sync panel
Check network logs

Appendix F: Glossary of Terms

F.1 Technical Terms Explained

Term	Explanation
API Key	A secret code that lets the AI work; like a ticket to enter a special room
Backend	The part of the system that runs behind the scenes (not visible to users)
Cache	Temporary storage that makes things load faster
Cookie	Small file that remembers your preferences
Database	A place where information is stored
Endpoint	A specific address where the AI waits for questions
Firebase	A Google service that helps with real-time multiplayer
JSON	A format for organising data (like a list of questions and answers)
Local Storage	Space in your browser where the app saves your progress
Modal	A pop-up window that appears on top of the main page
Provider	The company that provides the AI service (like DeepSeek)
REST API	A way for apps to talk to servers over the internet
Session	One period of using the app (like one quiz or one lesson)
State	All the current information about what’s happening (like which question you’re on)
Token	A piece of information used to prove who you are

F.2 Educational Terms Explained

Term	Explanation
Accuracy	How many questions you got right, shown as a percentage
Bloom’s Taxonomy	A way to measure how deep your thinking is (remember, understand, apply, analyse, evaluate, create)
Cognitive Load	How much your brain has to work to understand something
Differentiation	Teaching the same thing in different ways for different learners
Formative Assessment	Checking understanding during learning (like quizzes)
IELTS	International English Language Testing System; a test for people who want to study or work where English is used
Lexical Resource	How many words you know and how well you use them (for IELTS)
Pedagogy	The method and practice of teaching
Scaffolding	Providing support that is gradually removed as the learner improves
Summative Assessment	Testing at the end of a learning period (like final exams)
Universal Design for Learning (UDL)	Designing things so everyone can use them, regardless of ability

F.3 Game Terms Explained

Term	Explanation
Bracket	The structure of a tournament (who plays who)
Knockout	If you lose one match, you’re out of the tournament
Leaderboard	A list showing who has the highest scores
Matchmaking	Finding another player for you to compete against
Rank	Your position compared to others (1st, 2nd, 3rd)
Spawn	When you appear in the game (like at the start)
TT Rockstars	A popular times tables game (our modes are inspired by it)

Appendix G: Sample Lesson Plans

G.1 Mathematics: Times Tables Festival

Lesson Plan:

Title:Times Tables Festival
Subject:Mathematics
Level:Primary (ages 7-11)
Duration:30 minutes
Topics:2×, 5×, 10× tables
Mode:Festival (global competition)
Setup:Festival mode, 60-second rounds

Objectives:

Recall 2×, 5×, and 10× tables quickly
Build speed and accuracy
Experience global competition

Procedure:

Student logs in and goes to Online Multiplayer tab
Clicks “Festival” in Game Modes
Selects table or random
Plays 60-second round
Sees global ranking
Repeats with other tables

Assessment:

Highest score (correct answers in 60 seconds)
Accuracy percentage
Ranking compared to global players

G.2 English: Reading Comprehension

Lesson Plan:

Title:Reading Comprehension Practice
Subject:English
Level:Secondary (ages 11-14)
Duration:25 minutes
Topics:Summarisation, inference
Mode:Quiz 2 → Reading & Writing

Objectives:

Read and understand a passage
Identify main ideas
Write a clear summary

Procedure:

Student goes to Quiz 2 tab
Selects Reading & Writing sub-tab
Clicks “Generate Reading Text” on chosen topic
Reads the passage (timer starts)
Writes a summary (150-200 words)
Clicks “Analyse My Summary”

Assessment:

IELTS-style band score (1.0-9.0)
Feedback on:
- Task achievement
- Coherence and cohesion
- Lexical resource
- Grammatical range and accuracy

G.3 Science: Photosynthesis Quiz

Lesson Plan:

Title:Photosynthesis Quiz
Subject:Science (Biology)
Level:Secondary (ages 11-14)
Duration:15 minutes
Topics:Photosynthesis
Mode:Quiz tab (AI-generated)

Objectives:

Understand the process of photosynthesis
Identify key components (sunlight, water, carbon dioxide)
Know the products (glucose, oxygen)

Procedure:

Student goes to Setup tab
Selects “Science (General)” or “Biology”
Enters “photosynthesis” in custom topic or uses built-in subject
Sets difficulty to Medium
Sets questions to 10
Clicks “Start Quiz”
Answers 10 multiple-choice questions
Reviews results and explanations

Assessment:

Score percentage
Correct/wrong breakdown
Explanations for each question

Afterword

The GilRobo AI Learning Platform represents a significant step forward in educational technology, combining the power of artificial intelligence with proven pedagogical principles to create a truly personalised learning experience. Whether used in a classroom with 30 students, at home with a single child, or across a global network of learners, the platform adapts to meet the needs of every user.

This guide has documented every feature, every setting, and every capability of the platform. From the simplest times table quiz to the most complex IELTS simulation, from local solo practice to global multiplayer competitions, the tools are here to support learning at every level.

We invite you to explore, experiment, and discover the joy of learning with GilRobo AI.

GilRobo AI Learning
www.gilrobo.2h2.co.uk