The Complete Beginner’s Guide

GilRobo AI Learning Platform — Complete Guide
📘 Complete Platform Guide — Version 16.8

🤖 GilRobo AI Learning Platform

The definitive interactive guide covering every feature, setting, and capability — from young learners to university researchers, teachers to parents.

25+
Feature Chapters
9
AI Providers
50+
Languages
Learning Topics
🗺️

Platform Overview

GilRobo AI Learning is an integrated educational ecosystem — a synthesis of cutting-edge AI, game-based learning theory, and Universal Design for Learning (UDL) principles. Click any card below to jump to that section.

🏛️ Five Core Principles

🧩 Personalised Learning

Adjustable difficulty, custom topics, multiple question formats, and SEN-aware instructional styles tailored to every individual learner.

🎮 Active Engagement

Game-based multiplayer competitions, immediate feedback, visual progress indicators, achievement badges, and certificates for every milestone.

♿ Universal Design (UDL)

Text, images, spoken audio, video. Typing, speaking, drawing. Solo practice, global competition. Every learner represented.

📈 Formative Assessment

Real-time scoring, detailed explanations, historical performance tracking, and rich analytics for teachers and parents.

👩‍🏫 Teacher Empowerment

Lesson creation, student monitoring, homework assignment, AI-assisted parent consultations, and full data access across all devices.

🌍 Unlimited Languages

50+ languages for voice, 100+ for interface. The AI tutor can speak Welsh, Yoruba, Quechua — any language you need.

👥 Who Is This For?
AudienceAge / RoleKey Features Used
🧒 ChildrenAges 5–12Child Mode, colourful interface, offline maths games, voice commands
📚 Secondary StudentsAges 11–18IELTS practice, custom topics, detailed essay feedback
🎓 University Students18+Academic style, complex topics, essay analysis
👩‍🏫 TeachersEducatorsTeacher Dashboard, homework, student monitoring, lesson planning
👪 ParentsGuardiansParent Day consultations, email notifications, progress reports
🏢 Corporate TrainersProfessionalsBusiness subjects, compliance training, employee tracking
📑 All Platform Tabs at a Glance
⚙️
Setup
Configure & profile
🎯
Quiz Module
AI-generated quizzes
📝
Quiz 2 / IELTS
Advanced assessments
🎓
Tutorial
AI-generated lessons
🌐
Online Multiplayer
Global competitions
🏫
Classroom
Teacher management
📊
Teacher Dashboard
Student overview
📝
Homework
Assignments
👨‍👩‍👧
Parent Day
Consultations
📊
Reports
Analytics & charts
📝
Whiteboard
Draw & collaborate
🏅
Certificates
Awards & badges
☁️
Cloud Sync
Multi-device data
🔐
Admin Panel
Access control
🔔
Alarms & Alerts
Notifications
🔒
Focus Lock
Lesson focus mode
💻 System Requirements

🖥️ Hardware

  • Any modern device (phone, tablet, PC)
  • Modern browser: Chrome, Edge, Safari, Firefox
  • Microphone for voice features
  • Camera (optional) for profile photos
  • Internet for AI & multiplayer features

⚙️ Software

  • JavaScript enabled in browser
  • Local storage enabled
  • SpeechSynthesis API (text-to-speech)
  • Web Speech API (Chrome/Edge recommended)

🔑 Accounts

  • No registration needed for basic use
  • API key from DeepSeek (free), OpenAI, etc.
  • Optional Firebase for full multiplayer
⚙️

Setup & Configuration

The Setup Tab is your command centre. Configure player profiles, select subjects, set difficulty, choose voices, and get your AI teacher ready to go.

🔑 Step 1 — Your API Key (The AI Ticket)
🎟️

What is an API Key?

Think of it as a special ticket that brings your AI teacher to life. Get one free from deepseek.com, copy the long string of letters and numbers, paste it into the “Paste API key here” box, and click Save (session). Done!

👤 Step 2 — Player Profiles

🎮 Single Player Mode

  • Enter your name
  • Optionally add your school or location
  • Your name appears on leaderboards and reports

👥 Multiplayer Mode

  • Add multiple players (friends, classmates)
  • Each player gets a unique ID, name, location & avatar
  • Upload photo or take one with your camera
  • All players stored in the permanent Player Directory
📚 Step 3 — Subject Selection

🏫 Primary School

  • English Language
  • Mathematics
  • Basic Science
  • Social Studies
  • Times Tables 1× to 12× (offline!)
  • Addition, Subtraction, Division (P1–P6)

📖 Secondary School

  • English Literature
  • Mathematics
  • Physics, Chemistry, Biology
  • History & Geography
  • Business Studies

🏢 Corporate Training

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

Custom Topics

Go to the Custom Topics tab, enter a title (e.g. “The Solar System”), add your detailed text, and save. It appears in the subject dropdown as [Custom] Title and the AI will generate questions from YOUR content!

🎚️ Step 4 — Difficulty & Parameters
DifficultyDescriptionBest For
🟢 EasyBasic recall, simple 1-step thinkingYoung learners, new topics
🟡 MediumApplication, 2-step reasoning, connecting ideasRevision, general practice
🔴 HardAnalysis, critical thinking, abstract conceptsExam prep, advanced learners

⏱️ Timer Settings

  • 5 to 3600 seconds per question
  • Default: 60 seconds
  • Beginners: 90–120 seconds recommended
  • Advanced: 30–45 seconds for a challenge

❓ Number of Questions

  • Set between 1 and 9999 questions
  • Default: 30 questions
  • Young learners: start with 5–10
🔊 Step 5 — Voice Selection

🎙️ Voice Options

  • Choose from all voices on your device
  • Test voice before starting
  • UK English: “Google UK English Female” or “Microsoft Zira”
  • US English: “Google US English” or “Samantha”
  • Child-friendly: Higher pitch voices recommended

📖 Reading Options

  • Auto-read questions and answers aloud
  • Read Answers Only (for reading practice)
  • Show Read Controls (Replay Q, Replay A, Stop)
  • Show Question Images (visual learners)
🖥️ View Modes
ModeWho It’s ForTabs Hidden
🔬 AdvancedTeachers, researchersNone — full access
✨ SimpleNon-technical usersReports, Custom content, Multiplayer, Whiteboard, etc.
🧒 Child (Kids)Ages 5–12All except Setup, Quiz, Results, History, Tutorial
⌨️ Keyboard & Voice Commands
KeyboardAction
1–4Select answer A–D
SpaceRead question aloud
Ctrl + MToggle voice mode
EscapeStop speech / close modals
Tab / EnterNavigate / activate
Voice CommandAction
“Start Quiz”Begin the quiz
“Option A/B/C/D”Select answer
“Next Question”Proceed
“Repeat Question”Hear again
“Stop”End voice mode
🧠

The AI Engine

Under the hood, GilRobo connects to 9 different AI providers, uses carefully crafted prompts, and supports full text-to-speech, speech recognition, and image generation.

🤖 Supported AI Providers
ProviderModelBest ForFree Tier
🔵 DeepSeekdeepseek-chatGeneral education, cost-effective✅ Generous
🟢 OpenAIGPT-4o-miniHigh-quality + image generation❌ Paid
🟠 AnthropicClaude Opus 4.5Detailed explanations, safety❌ Paid
🔴 GoogleGemini ProQuick responses, integration✅ Limited
⚡ GroqLlama 3 70BVery fast responses✅ Yes
🔶 Together AIMixtral 8x7BOpen models, customisation✅ Yes
🌊 Mistral AIMistral LargeEuropean alternative✅ Yes
🟣 CohereCommand R+Enterprise features✅ Yes
🔥 Fireworks AILlama 3 70BFast inference✅ Yes
🔄 Quiz Generation Pipeline
1️⃣
User Input
📚
Topic Selection
🎚️
Difficulty Set
💾
Check Static DB
✏️
Check Custom Topics
🤖
AI Call
🔀
Shuffle Options
🎯
Present to User
💬 Text-to-Speech & Voice Recognition

🔊 Text-to-Speech (TTS)

  • Uses browser’s built-in SpeechSynthesis API
  • Supports all system voices
  • Chunks long text into sentences to prevent cut-off
  • Adjustable rate and pitch
  • 50+ languages supported

🎙️ Speech Recognition

  • Uses webkitSpeechRecognition (Chrome) or SpeechRecognition
  • Continuous listening mode for conversation
  • Interim results for real-time feedback
  • Language matching — same 50+ languages
  • Chrome & Edge give best results
🖼️ Image Generation for Visual Learning
ProviderTypeDescription
📸 UnsplashFree stock photosHigh-quality educational images, no API key needed
🎨 DALL-E 3AI generationCustom educational illustrations (OpenAI key required)
🖌️ Stable DiffusionAI generationOpen-source image generation
🛡️ Safeguarding: Always Blocked
⚠️

Content Always Blocked by the AI

Violence & weapons · Adult content · Self-harm · Drugs & alcohol · Abuse · Radicalisation. Teachers can also add custom blocked words/phrases via the admin panel. A 3-strike system bans users for 5 days for profanity in chat.

🎯

Quiz Modules

Two powerful quiz systems: the main Quiz Tab for AI-generated multiple-choice, and Quiz 2 for advanced IELTS-style reading, writing, speaking and essay assessments.

🎯 Quiz Tab — How It Works

📋 Question Format

  • Multiple choice with 4 options (A, B, C, D)
  • Options shuffled to prevent memorisation
  • Correct answer + explanation shown after each answer
  • Skip function with answer reveal for learning

⏱️ Live Features

  • Countdown timer with visual progress bar
  • Red bar warning when time is running low
  • Live player scoreboard (multi-player)
  • Running correct/wrong totals per player

✅ When You Answer — Instant Feedback

  • Correct: Green highlight, positive message, educational explanation
  • Wrong: Red highlight, correct answer revealed, explanation shown
  • ⏭️ Skipped: Correct answer and explanation shown for learning
  • 🔊 All spoken aloud if voice mode is enabled
📝 Quiz 2 — Advanced Assessment Module
How It Works:
  • AI generates a 250–300 word IELTS Academic passage on your topic
  • Student reads the passage, then writes a 150–200 word summary
  • Timer tracks reading and writing time
  • AI evaluates using IELTS criteria: Task Achievement, Coherence & Cohesion, Lexical Resource, Grammatical Range & Accuracy
  • Returns overall band score (1.0–9.0) with detailed feedback
  • IELTS Part 2 style — 2-minute talk with task card and bullet points
  • Student clicks “Start Recording” and speaks
  • AI estimates band scores for: Fluency, Lexical Resource, Grammar, Pronunciation
  • Provides specific improvement suggestions
  • AI generates a thought-provoking essay prompt
  • Student writes in the text area (no length limit)
  • AI evaluates: Structure, Thesis, Grammar/Spelling, Evidence, Coherence
  • Score out of 10 with detailed improvement suggestions
Test Types: Academic (university) or General Training (work/migration)
Sections:
  • 🎧 Listening: Simulated audio with 10 multiple-choice questions
  • 📖 Reading: Passage with MC, True/False/Not Given, matching
  • ✍️ Writing: Task 1 (graph/letter) + Task 2 (essay)
  • 🗣️ Speaking: Introduction, Long turn, Discussion
  • 📊 Scores 1.0–9.0 per section + overall band score
💬 Feedback Modes
ModeToneBest For
⚖️ NormalBalanced, neutralGeneral practice
💚 SupportiveEncouraging, gentleLow-confidence learners
🎓 IELTSStrict, academicExam preparation
🎤 RudeBlunt, very directAdvanced learners wanting honest critique
🎓

Tutorial Module

Your personal AI teacher can generate comprehensive lessons on literally any topic — then read them aloud, save them for later, and let you navigate by voice.

📚 How to Generate a Tutorial
1

Enter Your Topic

Type anything — “photosynthesis”, “how computers work”, “the French Revolution”, “quadratic equations”. Or click the microphone and say it!

2

AI Generates the Tutorial

The AI creates a comprehensive lesson including key concepts, real-world examples, practice questions with answers, and a summary.

3

Read & Listen

Follow along on screen, or click 🔊 “Read Tutorial” to have it spoken aloud in your chosen voice and language.

4

Saved Automatically

Every tutorial is saved to Tutorial History. Up to 100 tutorials stored. Search, view, re-read, download, or email them anytime.

🌟

Great for Learners with Dyslexia

The text-to-speech integration means students can follow along while listening — improving reading skills and accessibility at the same time.

📜 Tutorial History Features

🔍 Search

Find any saved tutorial by topic name instantly.

📥 Download

Save tutorials as PDF or text files to keep offline.

✉️ Email

Send any tutorial directly to yourself or a student.

🔊 Re-listen

Have any saved tutorial read aloud again at any time.

🗑️ Delete

Remove tutorials you no longer need.

🎙️ Voice Search

Say the topic name to search hands-free.

🌐

Online Multiplayer & Competitions

Compete live against players worldwide, race classmates, challenge friends, and battle as classes — powered by Firebase real-time technology.

🎮 Times Tables Game Modes
🎪
Festival Mode — Global Live!
Compete live against players worldwide. Choose any times table (1× to 12×) or random. 60-second race. Answer as many as possible. See your global rank as you play!
🏟️
Arena Mode — Classroom Races
Teacher sets the table, all students play simultaneously. 90-second race, 20 questions. Most correct wins. Perfect for classroom energy!
🤜
Rock Slam — Head-to-Head
Set your best score for a friend to beat — asynchronously. Add a personal message. No time pressure. Share a link and let the battle begin!
⚔️
Battles — Class vs Class
Whole classes compete by average score. 120 seconds, 40 questions. Results appear in Location Rankings. The group effort that counts!
🏠 Game Room System
1

Create a Room

Enter a name, choose game mode (Classic Quiz, Speed Run, Trivia Battle), set max players (2, 4, or 8), time per question, optional password, optional private mode.

2

Players Join

Players find your room in the room list, or use Quick Match to find any open room automatically. They can also join by invitation link.

3

Host Starts the Game

Host clicks Start. All players compete live. Scores update in real-time for everyone.

🏆 Leaderboard & Rankings

👤 Player Rankings

  • Based on accuracy percentage
  • Weighted by games played
  • Updated after every public result
  • All-time points: Correct ×10 − Wrong ×2
  • Level = floor(points ÷ 50) + 1

🏫 Location Rankings

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

🥊 Tournament Bracket

  • 8-player knockout bracket
  • Quarter-finals → Semi-finals → Final
  • Highest scores advance to next round
💬 Global Chat System

🌍 Global Chat

  • All online players can see and reply
  • Real-time message delivery
  • Profanity filtering with 3-strike system
  • 3 strikes = 5-day ban
  • Voice messages: record and send audio clips
  • Transcribed for accessibility

🚪 Room Chat

  • Only players in the same room can see messages
  • Private to the room
  • Great for strategy and communication
📊 Group Competition Engine

🆚 Create Custom Group Competitions

  • Select any players from the public leaderboard
  • Drag players into custom groups (Team A, Team B, etc.)
  • Compare: Accuracy, Correct Answers, Wrong Answers, Games Played, Fastest Time, Total Questions
  • Save competitions and reload historical data
  • Export results as CSV for reporting
🏫

Classroom, Dashboard & Parent Systems

A complete school management suite: register students, plan lessons, run live sessions, assign homework, conduct parent consultations, and track every student’s progress.

🎒 Student Registration
1

Student Self-Registers

Student fills in: Full name, Age, Class/Year, Level (Primary/Secondary/University), Guardian name, Student ID, Device ID. Status = “pending”.

2

Teacher Approves

Teacher sees pending list in the Admin panel. Clicks ✅ to approve or ❌ to reject. Approved students appear in the roster instantly.

3

Quick Register

Teacher can instantly register remote students by entering their Device ID and name — auto-approved, no waiting needed.

📅 Lesson Planning

📋 Lesson Plan Fields

  • Lesson title, subject, date/time, duration, type (Lesson/Quiz/Break/Assembly)
  • Number of questions, school level, teaching style
  • Unlimited topics, curriculum notes, teacher notes
  • Optional approval PIN, optional device lock
  • Set alarms: 15 and 5 minutes before lesson
  • Assign to specific students or make public
📡 Live Classroom Session Controls

🗣️ Speak

Teacher speaks to all students via TTS

🙋 Ask Student

Call on a specific student

🎯 Quiz

Launch a quick quiz mid-session

⏭️ Next Topic

Advance to the next lesson topic

🖼️ Image

Generate a relevant lesson image

🏆 Leaderboard

Show current student rankings

⏸️ Pause

Pause the live session

📹 Camera

Add a video feed to the session

🌍 AI Teacher Language Support
🗺️

50+ Languages for Voice, 100+ for Interface

European languages (Welsh, Irish, Catalan, Basque…), Asian languages (Hindi, Japanese, Korean, Thai, Vietnamese…), African languages (Yoruba, Amharic, Hausa, Zulu, Swahili…), and more. The AI teaches and speaks in the language you need.

📊 Teacher Dashboard

📈 Overview Cards

  • Total number of approved students
  • Average accuracy across all students
  • At-risk count: students with <50% accuracy
  • Total quizzes taken by all students

🆘 At-Risk Identification

  • Accuracy <50% on last 3 quizzes
  • Consistent performance decline
  • No recent quiz activity
  • Click student → assign targeted homework → schedule support
📝 Homework System
1

Create Assignment

Choose subject, topics (from past lessons, plans, custom topics, or type new), due date, time limit, number of questions, and optional instructions.

2

Assign to Students

Select individual students or use “All” to assign to everyone. Students see homework in their portal with a “Start Assignment” button.

3

Track Completion

Teacher sees: Pending (not started), Completed (with score), Overdue (past due date). Results automatically recorded and visible in dashboard.

👨‍👩‍👧 Parent Day Consultation System
ModeDescriptionAI Behaviour
🔒 PrivateParent & teacher onlyProfessional, honest, covers all data
👨‍👩‍👧 FamilyParent, child & AI togetherWarm, addresses both, involves child
🌟 Student-LedChild presents progressCoaching, prompting reflection
🆘 Support PlanUrgent interventionFocus on action plan, concrete steps
🎉 CelebrationRecognise achievementsHighlight success, set new goals
📚 Homework ReviewReview assignmentsAnalyse patterns, suggest adjustments
📋 AI-Generated Action Buttons

📋 Learning Plan

Personalised 4-week plan with SMART goals generated by AI.

📝 Adjust Homework

Calibrated assignment based on student’s current level.

🏠 Parent Guide

Daily home activities and support strategies for parents.

✅ Action Points

Structured list of agreed next steps from the consultation.

📊 Progress Report

Formal school report format document.

✉️ Follow-up Email

Professional follow-up email auto-drafted with all action points.

🎬

Consultation History & Replay

Every parent consultation is saved automatically. You can replay the entire conversation, jump to any point in the transcript, adjust playback speed (1×, 2×, 4×, Slow), download as text, or email the transcript directly.

📊

Reports & Analytics

Powerful data visualisation tools let you filter quiz history, generate beautiful charts, drag and drop data fields, and export everything as PDF, email, or CSV.

🔍 Filters Available

📅 Period

Last 7 days, 30 days, 90 days, 1 year, or all time

📚 Subject

Single or multiple subjects at once

👤 Player

Single player or compare all

🎚️ Difficulty

Easy, Medium, Hard, or all combined

📊 Accuracy %

Filter by min/max percentage range

🔎 Search

Full-text search across subjects, players, questions

📈 Chart Types
ChartBest For
📊 Bar ChartComparing groups (e.g. subjects, players)
📈 Line ChartShowing accuracy trends over time
🕸️ Radar ChartComparing multiple metrics simultaneously
🥧 Pie ChartShowing proportions of correct/wrong
🍩 Doughnut ChartProportions with a centre value

🖱️ Drag-and-Drop Chart Builder

Available fields: Player Name, Subject, Difficulty, Games Played, Correct, Wrong, Accuracy %, Date, Fastest Time. Drag fields to the X or Y axis, select chart type, and click “Draw Chart”. Multiple Y-axis fields create combined charts (e.g. Accuracy + Correct Answers on the same chart).

📤 Export Options

📄 PDF

Full report with charts and summary, ready to print or share.

✉️ Email

Send the report directly to parents or colleagues.

📊 CSV

Raw data for Excel or Google Sheets analysis.

🎨

Creative & Achievement Tools

A full digital whiteboard for drawing, note-taking, and collaboration — plus a complete certificate and badge system to celebrate learner achievements.

📝 Whiteboard System

🖊️ Drawing Tools

  • ✏️ Pen — Freehand drawing (1–50px brush)
  • 🧹 Eraser — Remove parts of drawing
  • 📝 Text — Add text anywhere on canvas
  • 🖍️ Highlighter — Semi-transparent highlighting
  • 🎨 Colour picker with hex code input
  • ↩️ Undo / Redo (20-action history per page)

📄 Multi-Page & Display

  • Unlimited pages with sidebar navigation
  • Rename or delete any page
  • Zoom: 50% to 200% with full resolution preserved
  • Fullscreen mode for presentations
  • Save all pages to browser storage
  • Export current page as PNG image
🏅 Certificates & Achievement Badges
🎖️ Badge Award Criteria
BadgeIconHow to Earn
Perfect Score💯100% on any quiz
Star LearnerAverage accuracy ≥ 90%
Most Improved📈Rising trend in scores over time
Consistent🎯5 or more quizzes completed
Scholar📚Average accuracy ≥ 80%
First Steps🌟Completed first ever quiz
Decade🔟10 or more quizzes completed
Top of Class🥇Highest score in the class
🎨 Certificate Templates

🏅 Classic Gold

Gold gradient background, orange border. Timeless and prestigious.

👑 Royal Blue

Blue gradient background, dark blue border. Regal and impressive.

💎 Emerald

Green gradient background, green border. Fresh and vibrant.

✨ Midnight

Dark gradient background, purple border. Sleek and dramatic.

🌹 Rose Award

Pink gradient background, pink border. Warm and celebratory.

🔮 Purple Excellence

Purple gradient background, purple border. Bold and distinguished.

🖨️

Bulk Certificate Generation

Select multiple students (or use “Eligible Only” for ≥70% average), choose a template, and generate all certificates at once. Download as landscape PDF pages, ready to print. Auto-award system checks for new badges after every quiz!

☁️

Cloud Integration & Synchronisation

Bidirectional sync to Azure, AWS, WordPress, Dataverse, or any custom REST API — plus deep Firebase integration for real-time multiplayer and cross-device access.

🔄 Supported Cloud Providers
ProviderAuthenticationBest For
🔵 Custom REST APIAPI Key or Bearer TokenAny custom backend system
🔷 Microsoft AzureFunction Key + SAS TokenAzure Functions + Cosmos DB
🟣 Microsoft DataverseOAuth2 Client CredentialsPower Platform, Dynamics 365
🟠 Amazon AWSAPI Gateway KeyLambda + RDS/DynamoDB
🟢 WordPressApplication PasswordSchool websites and blogs
📊 What Gets Synced?

📤 Data Tables Synced

  • gs_students — Student records
  • gs_quiz_results — Classroom quiz results
  • gs_lectures — Classroom sessions
  • gs_settings — Teacher settings
  • qm_quiz_history — Quiz tab history
  • qm_quiz2_history — IELTS/Quiz2 history
  • qm_tutorial_history — Tutorials
  • gr_pd_history — Parent consultations

⏰ Auto-Sync Scheduler

  • Configure sync interval in minutes
  • 0 = off (manual only)
  • Maximum: 360 minutes
  • Full sync log: timestamp, table, direction, count, success/failure
  • Log stored locally and can be cleared
🔥 Firebase Real-time Features

👥 Online Players

Who’s online right now, their status (online/in-game), and when they were last active.

🏠 Game Rooms

Real-time room creation, player joining, game status updates for all participants simultaneously.

💬 Live Chat

Global chat and room-specific chat delivered instantly to all connected players.

🏆 Leaderboards

Public scores aggregated and ranked in real-time across all players worldwide.

📚 Lesson Plans

Teachers push lesson plans directly to student devices — students see them instantly.

✅ Join Requests

Students request to join lessons → teacher approves → student is unlocked, all in real-time.

🔧

Advanced Features & Admin Systems

Grading profiles, custom content creation, role-based access control, alarm systems, email notifications, and the Focus Lock system for distraction-free lessons.

📊 Grading Profiles
🎓

Convert Scores into Meaningful Grades

Create grade band profiles that turn percentage scores into UK SATs, GCSE 9-1, A-Level, US Letter Grades, IB 1-7, Scottish National 5, Distinction/Merit/Pass, or simple Pass/Fail. Each band has a label, minimum %, background colour, and text colour.

✏️ Custom Content Creation

📝 Custom Topics

  • Enter a title and detailed body text
  • Appears in dropdown as [Custom] Title
  • AI generates questions from your text

❓ Custom Questions

  • Write your own 4-option questions
  • Mark the correct answer and add explanation
  • Mixed into AI quizzes automatically

📚 Knowledge Upload

  • Upload PDF, Word (.docx), or Text (.txt) files
  • System extracts text content
  • AI generates questions from YOUR materials
  • Perfect for textbooks and syllabuses
🔐 Admin Panel & Role-Based Access
RoleAccess Level
👑 AdminFull access to all tabs and features
🤝 TraderSetup, Players, Custom content, Quiz, Multiplayer, Whiteboard, Reports, Dashboard, Homework
👁️ ViewerSetup, Quiz, Quiz 2, Tutorial, Homework
👤 CustomerSetup, Quiz, Tutorial, Homework only

🔗 URL-Based Role Access

Share a specific URL like https://gilrobo.2h2.co.uk/?role=Viewer&code=APS-XXXX-XXXX to give someone instant access with the correct role and permissions — no setup needed from them.

🔔 Alarm & Notification System

⏰ Lesson Alarms

  • 1st Reminder: 15 minutes before lesson (amber banner)
  • 2nd Reminder: 5 minutes before lesson (red banner)
  • Sound options: 🔔 Bell, 🎵 Chime, 📯 Beep, 🤫 Silent
  • Custom spoken message using TTS
  • Browser notification with title and time
  • All sounds built with Web Audio API — works offline!

✉️ Email Notifications

  • WordPress REST API — uses wp_mail() function
  • mailto: fallback — opens your email client
  • EmailJS — free, 200 emails/month
  • Manage email list with labels (e.g. “Mum”)
  • Test email function to verify settings
🔒 Focus Lock System
⏱️

Activates 5 Minutes Before Lesson

Focus Lock engages. Students can no longer switch browser tabs. Window blur events are captured. A “beforeunload” warning appears if they try to close.

Countdown Timer

A circular progress ring counts down. Changes colour: orange → red as lesson approaches. Icons change: 🔒 Normal → ⚠️ Warning (2 min) → 🚨 Urgent (0 min).

🚀

Auto-Launch at Zero

When countdown reaches zero, the system automatically navigates to the lesson and launches it. No student action required.

🔓

Parent/Admin Unlock

Click “Parent Unlock”, enter admin password, and Focus Lock is dismissed. Use this if the student finishes early or needs device access.

📚

Technical Appendix & Reference

Data storage schema, API reference, accessibility compliance, troubleshooting guide, glossary, and sample lesson plans.

💾 Data Storage Overview
💡

Where Is Your Data Stored?

Local Storage (browser) — Persists across sessions, not shared across devices, ~5–10MB limit. Firebase — Cross-device real-time sync, 1GB free tier. Cloud Sync — Your own server or Azure/AWS/WordPress.

Storage KeyWhat It Stores
qm_apiYour API key
qm_playersCurrent quiz players list
qm_custom_topicsYour custom topics
qm_custom_questionsYour custom questions
qm_quiz_historyAll quiz sessions
qm_quiz2_historyIELTS/Quiz 2 assessments
qm_tutorial_historyAll generated tutorials
gs_studentsStudent records
gs_lesson_plansLesson plans
gr_pd_historyParent consultation transcripts
whiteboardDataAll whiteboard pages and drawings
🛠️ Troubleshooting Guide
  • Check key is correctly copied (no extra spaces at start or end)
  • Verify correct provider is selected in the dropdown
  • Check the provider’s service status page
  • Try a different provider (e.g. switch to Groq which has a free tier)
  • For rate limiting: wait 30–60 seconds, reduce number of questions
Chrome/Edge:
  • Click the lock icon in the address bar
  • Find “Microphone” → Select “Allow”
  • Reload the page
Safari:
  • Go to Settings → Websites → Microphone
  • Find the GilRobo site → Select “Allow”
  • Reload the page
  • Check your internet connection
  • Disable any VPN or proxy
  • Allow third-party cookies in browser settings
  • Try in incognito/private mode
  • Verify the endpoint URL is correct
  • Check your API key / credentials
  • Use the “Test Connection” button in the sync panel
  • Check browser network logs (F12 → Network tab)
📖 Glossary
  • API Key — A secret code that lets the AI work; like a ticket to enter a special room
  • Firebase — A Google service that powers 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
  • Token — A piece of information used to prove who you are
  • REST API — A way for apps to talk to servers over the internet
  • Endpoint — A specific address where the AI waits for questions
  • Accuracy — How many questions you got right, shown as a percentage
  • Formative Assessment — Checking understanding during learning (like quizzes)
  • IELTS — International English Language Testing System for work/study abroad
  • Lexical Resource — How many words you know and how well you use them
  • UDL — Universal Design for Learning: designing for every learner
  • Scaffolding — Support gradually removed as the learner improves
  • SEN — Special Educational Needs
  • 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
  • Rock Slam — Asynchronous head-to-head challenge (set a score for a friend to beat)
  • Festival — Global live competition mode
📋 Sample Lesson Plans

🔢 Times Tables Festival (Maths)

  • Primary school, ages 7–11, 30 minutes
  • Topics: 2×, 5×, 10× tables
  • Mode: Festival (global competition)
  • 60-second rounds, see global rank
  • Assesses: speed, accuracy, global rank

📖 Reading Comprehension (English)

  • Secondary, ages 11–14, 25 minutes
  • Quiz 2 → Reading & Writing tab
  • Generate IELTS passage, write 150–200 word summary
  • AI returns full band score 1.0–9.0

🌿 Photosynthesis Quiz (Science)

  • Secondary, ages 11–14, 15 minutes
  • Setup → Biology → “photosynthesis”
  • Medium difficulty, 10 questions
  • Reviews results with explanations
♿ Accessibility Compliance

WCAG 2.1 AA Compliant

The platform meets or exceeds WCAG 2.1 AA standards including: full keyboard navigation, screen reader support (NVDA, VoiceOver, JAWS, TalkBack), adjustable font sizes (13px–22px), high contrast mode, customisable colours, colour contrast ratio 7.2:1, ARIA landmarks, and live regions for dynamic content updates.

🌐 Visit GilRobo
🤖
GilRobo AI Learning
The complete AI-powered learning adventure
🚀 Visit www.gilrobo.2h2.co.uk
Shopping Cart