Welcome to Teacher AID

A complete guide to using the platform — for Admins, Teachers, and Students.

🛡️

Admin

Manage schools, users, AI settings, and platform configuration.

👩‍🏫

Teacher

Create subjects, build AI-powered lessons, and track student progress.

🎒

Student

Learn interactively with an animated AI teacher in your own language.

Platform Architecture

🛡️ Admin Configures platform Manages schools & users 👩‍🏫 Teacher Creates lessons & subjects Monitors students ✨ GenAI Generates content & chat 🎒 Student Learns interactively progress feedback 🗄️ Database Database

Getting Started

  1. A Super Admin or School Admin sets up the platform — creates schools, adds teachers, and configures the GenAI key.
  2. Teachers log in, create subjects, and build lessons using the AI-powered lesson editor.
  3. Students register (or are added by admin/teacher), log in, and start learning with the interactive AI teacher.
💡 Use the left navigation to jump to any section. Use the Ask me panel on the right to ask questions about this manual.

Admin Admin

Admins control the entire platform — schools, users, and AI configuration.

Two Admin Types

🌐

Super Admin (Global)

Full access to all schools, all users, and all platform settings. Can create other admins.

🏫

School Admin

Scoped to one or more assigned schools. Can manage students and teachers within those schools.

Admin Responsibilities

💡 Admin Management: Admins can change the "Creator" of any subject, add/remove contributors, and even edit "System" subjects that are normally read-only for teachers.

Admin Dashboard Overview

Schools Students Teachers Settings Admins Calendar 🏫 School List + Add School School Details & Admin Assignment Save Changes

Admin Account Setup Admin

How to create the first admin and log in to the platform.

First-Time Setup

When no admin exists yet, the login page enters Setup Mode automatically. You'll be prompted to enter your name, email, and password to create the first Super Admin account.

Admin Login — /admin/login
teacherAID.app/admin/login
Admin Login Email address Password Your name (first-time setup) Create Admin Account

Setup Steps

  1. Navigate to /admin/login.
  2. Enter your email and password. If no admin exists, a Name field appears automatically.
  3. Fill in your name and click Create Admin Account.
  4. You are redirected to the Admin Dashboard.
  5. From the Settings tab, add your AI API KEY before teachers can use AI features.
⚠️ Keep your admin credentials secure. There is no password recovery flow for admins — a Super Admin must reset it manually.

Creating Additional Admins

From the Admins tab in the dashboard, a Super Admin can create new admin accounts and assign them to specific schools or grant global access.

School Management Admin

Create and manage schools on the platform.

Creating a School

  1. Go to the Schools tab in the Admin Dashboard.
  2. Enter the school name in the input field and click Add School.
  3. The school appears in the list and is now available for teacher and student assignment.

School Workflow

1. Create Add school name 2. Assign Admin Link school admin 3. Add Teachers Register or bulk import 4. Add Students Register or bulk import

Editing & Deleting Schools

Click the edit icon next to any school to rename it. Deleting a school removes it from the platform — users assigned to that school will need to be reassigned.

⚠️ Deleting a school is permanent. Make sure to reassign or remove associated users first.

User Management Admin

Add, edit, search, and remove students and teachers.

Managing Students

The Students tab shows all students with search, sort, and pagination. You can:

Bulk Import via CSV

  1. Click Bulk Add in the Students or Teachers tab.
  2. Download the CSV template provided in the modal.
  3. Fill in the required columns: name, email, grade (students) or name, email (teachers).
  4. Upload the completed CSV file and click Import.
Bulk Add Modal
Admin Dashboard → Students → Bulk Add
Bulk Add Students ⬇ Download Template 📂 Drop CSV here or click to upload Supports .csv files only Import

Managing Teachers

The Teachers tab works the same way — search, sort, edit, delete, and bulk import. Teachers can be assigned to multiple schools.

Account Approval Workflow Admin

How to approve, suspend, or revoke access for students and teachers.

The Pending State

By default, all new teachers and students who register on the platform are placed in a Pending state. They will see a message after registration informing them that an admin must approve their account before they can log in.

Approving a User

  1. Go to the Students or Teachers tab.
  2. Use the status filter dropdown to select Pending.
  3. Find the user you wish to approve and click the ✅ Approve button in the Actions column.
  4. The user is now active and can log in immediately.

Suspending or Revoking Access

Admins can disable any account at any time without deleting it. This is useful for temporary suspensions or for revoking access if a student leaves.

Suspend

Click the Suspend icon in the table. The user is immediately blocked and kicked out of their current session.

✏️

Manual Override

Click Edit on a user and change the "Account Status" dropdown. You can move them back to Pending or Inactive.

💡 Role Scoping: School Admins can only approve or suspend users belonging to the schools they manage. Global Admins can manage everyone.

AI Settings Admin

Configure the AI API KEY and model used across the platform.

Why This Matters

All AI features — lesson generation, student chat, text-to-speech, translation, and diagram editing — rely on the AI API key. Without a valid key, these features will not work.

Configuring the API Key

  1. Go to the Settings tab in the Admin Dashboard.
  2. Paste your AI API key into the AI_API_KEY field.
  3. Optionally select an AI Model from the available options.
  4. Click Save Settings.
Settings Tab
Admin Dashboard → Settings
AI Configuration AI API KEY AIza•••••••••••••••••••••••••••••• AI MODEL model-default Save Settings
💡 You can get a AI API KEY from your AI provider at . The free tier is sufficient for small schools.

School Calendar Admin

Manage school events, holidays, and important dates.

Using the Calendar

The Calendar tab provides a visual school calendar where admins can add events, mark holidays, and schedule important dates visible to teachers and students.

💡 Calendar events are school-scoped — School Admins only see and manage events for their assigned schools.

Teacher Overview Teacher

Teachers create content, manage students, and monitor learning progress.

📚

Course Content

Create subjects and organize lessons into structured courses.

🤝

Permissions

Add contributors to your courses and share content with other teachers.

✏️

Lesson Editor

Build rich lessons with text, images, SVG diagrams, videos, and assessments.

🤖

AI Generation

Use GenAI to generate entire lessons or specific blocks from a prompt.

🎓

Student Management

View, add, link, and monitor your students' progress.

Teacher Workflow

1. Login /teacher/login 2. Dashboard Stats & overview 3. Create Subject Name, icon, color 4. Build Lesson Editor + AI generation 5. Publish Students can access Monitor Students Progress & grades ✨ AI AI assist

Teacher Account Setup Teacher

How to register and log in as a teacher.

Registering

  1. Go to /teacher/login or click I am a Teacher on the home page.
  2. Toggle to Register mode.
  3. Enter your name, email, and password.
  4. Click Register.
  5. Wait for Approval — You will see a "Pending Approval" screen. An admin from your school must activate your account before you can log in.
Teacher Login / Register — /teacher/login
teacherAID.app/teacher/login
Teacher Access Login Register Email address Password Login Don't have an account? Register
💡 Your session is stored locally. You'll stay logged in until you clear your browser data or log out.

Teacher Dashboard Teacher

Your classroom at a glance — stats, charts, and recent students.

Dashboard Sections

👥

Total Students

Count of all students linked to your account.

📚

Active Topics

Number of subjects you've created.

Avg Success Rate

Average assessment score across all students.

Teacher Dashboard — /teacher/dashboard
teacherAID.app/teacher/dashboard
Welcome back, Ms. Smith! 🍎 Here's your classroom overview. Total Students 24 Active Topics 7 Avg Success Rate 85% Class Progress Wk1 Wk2 Wk3 Wk4 Wk5 Wk6 Recent Students Aarav Sharma Grade 3 Priya Thapa Grade 4 Rajan Gurung Grade 2

Course Content Teacher

Organize your teaching material into subjects and lessons.

Creating a Subject

  1. Go to Course Content in the teacher navigation.
  2. Click + New Subject.
  3. Enter a subject name, choose an emoji icon, and pick a color.
  4. Click Save — the subject card appears in your grid.

Subject Card Grid

Course Content — /teacher/content
teacherAID.app/teacher/content
Course Content 📚 + New Subject Mathematics 5 lessons Public 🔬 Science 3 lessons 📖 English 8 lessons

Click any subject card to open it and manage its lessons — add, edit, reorder, or delete lessons within that subject.

Copying & Duplicating Courses

You can create a complete Copy of any course (subject) you have access to. This is useful for sharing content between schools while keeping student progress and contributors separate.

  1. Find the subject card in the Course Content grid.
  2. Click the 👯 Duplicate button on the card (this acts as a Copy feature).
  3. A new subject is created with the name "Copy of [Subject Name]".
  4. The copy includes all lessons, assessments, and pathways, but starts as Draft and has no contributors linked.
💡 Why Duplicate? If you have a great course for "School A" and want to use it in "School B" with different teachers as contributors, simply duplicate it, assign it to "School B", and add the new teachers as contributors.

Permissions & Collaboration Teacher

Control who can edit your content and collaborate with other teachers.

Content Ownership

Every subject and lesson is owned by the teacher who created it. By default:

Collaborating with Contributors

If you want other teachers to help you build or manage a course, you can add them as Contributors.

  1. Open the subject you own from the Course Content page.
  2. Click the 👥 Contributors button in the toolbar.
  3. In the modal, use the search box to find a teacher by name or email.
  4. Click the Add button next to their name.
  5. Contributors gain full "Manage" access to that specific subject and all its lessons.
Teacher A (Owner) MANAGE Teacher B (Contributor) MANAGE Teacher C (Other) VIEW ONLY Adds

Read-Only Mode

When you view content as a non-owner/non-contributor, the platform enters Read-Only Mode automatically:

💡 Collaborative Lesson Planning: Adding contributors is the best way for teachers in the same department to share the workload and build high-quality curricula together.

Lesson Pathways & Flow Teacher

Design the learning journey by connecting lessons into a visual flow graph.

🗺️

Visual Map

See your entire curriculum as a connected graph of learning nodes.

🔗

Dynamic Links

Define prerequisites and branching paths between lessons.

🔍

Smart Filters

Filter the view by grade level or skill difficulty (Beginner to Advanced).

1. Flow vs. List View

Inside any subject, use the toggle at the top to switch between 🗺️ Flow and 📋 List views.

2. Designing the Journey

Basics of DNA 📝 Document DNA Quiz ✅ Assessment Gene Splicing 🎨 Diagram

Designing a pathway is as simple as connecting nodes:

3. Filtering and Navigation

The flow graph can get complex, so use the built-in tools to manage the view:

4. Off-Flow Lessons

Any lesson not currently part of the visual path is listed as "Off-Flow" in the sidebar. To add them to the journey, simply drag them onto the canvas and connect them to existing nodes.

💡 Remember: Always click 💾 Save Flow after making changes to your graph to ensure the student's learning path is updated.

Lesson Editor Teacher

Build rich, interactive lessons using a block-based editor.

Lesson Block Types

📝

Text

Rich formatted text content — headings, paragraphs, lists.

🖼️

Image

Upload or link images to illustrate concepts.

🎨

SVG Diagram

AI-generated or hand-crafted vector diagrams.

🎬

Video

Embed YouTube or other video content.

📊

Table

Structured data in rows and columns.

Assessment

Multiple-choice questions with scoring and feedback.

Lesson Editor Layout

Lesson Editor
teacherAID.app/teacher/content/[topicId]
Blocks 📝 Introduction 🎨 Diagram ✅ Quiz 📊 Summary Table + Add Block Block Editor Type your content here… Supports markdown formatting B I | H1 H2 Visibility Rule Show if Quiz score ≥ 80% Target: Summary Table Save Lesson ✨ AI Assist Describe what you want… Generate Select blocks to focus AI on specific content

Conditional Block Visibility

You can set a visibility rule on any block so it only appears when a student meets a condition — for example, showing an advanced explanation only if they scored ≥ 80% on the quiz.

  1. Select a block in the editor.
  2. Enable Visibility Rule in the block settings.
  3. Choose the condition (e.g., score ≥ 80%) and the target assessment block.
  4. Save the lesson manually using the Save Lesson button in the header.

AI Lesson Generation Teacher

Use the built-in GenAI to generate complete lessons or individual blocks in seconds.

How AI Generation Works

Teacher Types a prompt ✨ GenAI Generates JSON blocks Lesson Editor Blocks rendered live Teacher Reviews & saves

Generating a Full Lesson

  1. Open a subject and click New Lesson or open an existing lesson.
  2. In the AI Assist panel, type a prompt like: "Create a lesson on fractions for Grade 3 with a diagram and a 5-question quiz."
  3. Click Generate. The AI returns structured blocks.
  4. Review the generated content, edit any blocks as needed, and click Save.

Focused Block Generation

Select one or more existing blocks before generating to tell the AI to modify or extend only those blocks — useful for refining a specific section without regenerating the whole lesson.

SVG Diagram Editing

For SVG diagram blocks, you can ask the AI to edit the diagram iteratively — e.g., "Add labels to the diagram" or "Change the colors to match the school theme." See the Advanced Diagram Editor section for more details on animation and logic.

💡 The AI uses the topic name and selected grade levels as context, so the more specific your prompt, the better the output.

Advanced Diagram Editor Teacher

Create interactive, animated vector diagrams with AI and visual blocks.

AI Assisted

Build and refine diagrams iteratively using natural language prompts.

🎬

Keyframe Animation

Record and play back smooth animations for any shape property.

🧩

Visual Coding

Add interactivity and logic using a block-based programming system.

1. AI-Powered Design

The Diagram Editor features a deep integration with Gemini AI, allowing you to create complex visuals without manual drawing.

2. Dynamic Animations

Bring your diagrams to life with a powerful keyframe-based animation system.

0s 2s 4.5s Interpolated Motion

3. Visual Logic & Interactivity

Turn your static diagrams into interactive "apps" using the built-in block editor.

Note: The coding environment uses a simplified block system. You don't need to write any JavaScript; just connect the logic blocks.
  1. Switch to the Code tab in the Diagram Editor.
  2. Drag an Event block (like "When [Shape] is clicked") onto the workspace.
  3. Snap Action blocks (like "Set [Shape] opacity to 0") into the event block.
  4. Click ▶ Run App to test the interactivity immediately.

My Students Teacher

View, add, link, and manage the students in your class.

Student List Features

My Students — /teacher/students
teacherAID.app/teacher/students
My Students 🎓 + Add 🔗 Link 🔍 Search name or roll… All Schools All Grades NAME GRADE SCHOOL ROLL NO. ACTIONS Aarav Sharma Grade 3 Sunrise School 001 Edit Priya Thapa Grade 4 Sunrise School 002 Edit Rajan Gurung Grade 2 Valley School 003 Edit

Linking Existing Students

If a student already has an account (registered themselves), use Link Student to associate them with your teacher account by searching their name or email.

Student Overview Student

Students learn interactively with an animated AI teacher, assessments, and multi-language support.

📖

Interactive Lessons

Text, images, diagrams, videos, and quizzes — all in one lesson.

🤖

AI Teacher

An animated teacher character answers questions in real time.

🌐

10 Languages

Lessons auto-translate to your preferred language.

🎤

Voice Input

Ask questions by speaking — no typing needed.

🔊

Text-to-Speech

Listen to lesson content read aloud by the AI teacher.

📈

Progress Tracking

Your scores and completed lessons are saved automatically.

Student Journey

Register Name, grade, lang Browse Topics Pick a subject Open Lesson Read, watch, listen Ask AI Teacher Voice or text Complete Quiz Score & progress

Student Registration Student

How students create an account and log in.

Registering as a New Student

  1. Go to the home page and click I am a Student, or navigate to /student/login.
  2. Select the New Student tab.
  3. Enter your name, email, password, grade, preferred language, and school.
  4. Click Register.
  5. Wait for Approval — Your account will be pending. A school admin must approve you before you can access lessons.
Student Registration — /student/login
teacherAID.app/student/login
Welcome Students! 🎓 New Student I have an Account FULL NAME Your full name EMAIL student@email.com GRADE Grade 3 ▾ LANGUAGE English ▾ SCHOOL Sunrise School ▾ Register

Supported Languages

Students can choose from 10 languages at registration and change it anytime from their profile:

💡 Lesson content is automatically translated to the student's selected language using the built-in AI.

Learning a Lesson Student

How to navigate and interact with lessons.

Lesson Player Layout

Lesson Player — /learn/[topic]/[lessonId]
teacherAID.app/learn/mathematics/12
Understanding Fractions A fraction represents a part of a whole. The top number is the numerator and the bottom number is the denominator. Fraction Diagram 1/2 shaded Quick Check ✅ What is 1/4 of 8? A) 2 B) 4 ✓ C) 6 AI Teacher Great question! A fraction shows parts 🎉 🎤 Tap to ask 🔊 Read Aloud

Navigating Lessons

AI Teacher Student

Your animated AI teacher answers questions, reads lessons, and keeps you on track.

AI Teacher Personas

👨‍🏫

Puck

Classic friendly male teacher with round glasses.

😎

Charcoal

Cool modern teacher with square glasses.

🟢

Fenrir

Energetic teacher with a green shirt.

👩‍🏫

Kore

Strict classic female teacher with cat-eye glasses.

🌟

Aoede

Artsy kind female teacher with long hair.

Asking a Question

  1. Click the microphone button on the AI teacher panel to speak your question.
  2. Or type your question in the chat input below the teacher.
  3. The AI teacher responds in your selected language with a short, encouraging answer.
  4. The teacher's mouth animates while speaking the response aloud.
💡 The AI teacher always keeps answers short (2–3 sentences) and age-appropriate. It guides you toward the answer rather than giving it away directly.

Text-to-Speech

Click Read Aloud on any lesson block to have the AI teacher read it to you in your language. The teacher's avatar animates while speaking.

🔊 Troubleshooting Read Aloud (TTS)
The "Read Aloud" feature uses your computer's built-in voices. If you are learning in a language like Nepali and don't hear anything (or it sounds like gibberish), you may need to install the language pack on your device:
  • Windows: Settings → Time & Language → Language → Add a language → Nepali (ensure "Speech" is checked).
  • Mac: System Settings → Accessibility → Spoken Content → System Voice → Manage Voices → Nepali.
  • Mobile: Usually pre-installed, but check "Accessibility" or "Text-to-Speech" settings if audio is missing.
Note: After installing a new language, restart your browser for the new voices to take effect.

Progress & Scores Student

Your learning progress is tracked automatically as you complete lessons and assessments.

What Gets Tracked

Conditional Content

Some lessons have conditional blocks — extra content that only appears when you score above a threshold on a quiz. This means the better you do, the more you unlock!

Take Quiz Answer questions Score Check ≥ 80%? ✅ Unlock Advanced Extra content revealed Yes 📖 Review Content Try again to unlock No

Viewing Your Progress

Visit your Profile page to see your completed lessons, scores, and overall progress across all subjects. Your teacher can also see this data from their dashboard.

Celebrations & Badges

Learning should be fun! We celebrate your achievements in two ways:

🎉

Instant Celebration

Every time you answer a question correctly in an assessment, you'll see a burst of confetti and hear a cheerful sound!

🦁

Animal Badges

Earn special animal badges as you reach milestones. These are displayed at the top of your screen for everyone to see!

Available Badges