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
Getting Started
- A Super Admin or School Admin sets up the platform — creates schools, adds teachers, and configures the GenAI key.
- Teachers log in, create subjects, and build lessons using the AI-powered lesson editor.
- Students register (or are added by admin/teacher), log in, and start learning with the interactive AI teacher.
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
- Create and manage schools
- Add teachers and students (individually or via CSV bulk import)
- Configure the AI API key and model
- Manage the school calendar
- Create and manage other admin accounts
- Search, filter, sort, and paginate all users
- Full Content Control: Admins can view and manage any subject or lesson within their assigned schools (or globally for Super Admins), regardless of who created the content.
Admin Dashboard Overview
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.
Setup Steps
- Navigate to
/admin/login. - Enter your email and password. If no admin exists, a Name field appears automatically.
- Fill in your name and click Create Admin Account.
- You are redirected to the Admin Dashboard.
- From the Settings tab, add your AI API KEY before teachers can use AI features.
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
- Go to the Schools tab in the Admin Dashboard.
- Enter the school name in the input field and click Add School.
- The school appears in the list and is now available for teacher and student assignment.
School Workflow
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.
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:
- Search by name or roll number
- Sort by name, grade, school, or date added
- Edit a student's name, grade, school, or roll number
- Delete individual students
- Bulk import students via CSV
Bulk Import via CSV
- Click Bulk Add in the Students or Teachers tab.
- Download the CSV template provided in the modal.
- Fill in the required columns: name, email, grade (students) or name, email (teachers).
- Upload the completed CSV file and click 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
- Go to the Students or Teachers tab.
- Use the status filter dropdown to select Pending.
- Find the user you wish to approve and click the ✅ Approve button in the Actions column.
- The user is now
activeand 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.
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
- Go to the Settings tab in the Admin Dashboard.
- Paste your AI API key into the AI_API_KEY field.
- Optionally select an AI Model from the available options.
- Click Save Settings.
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.
- Add events with a title, date, and description
- Mark school holidays and closures
- View events by month
- Delete or edit existing events
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
Teacher Account Setup Teacher
How to register and log in as a teacher.
Registering
- Go to
/teacher/loginor click I am a Teacher on the home page. - Toggle to Register mode.
- Enter your name, email, and password.
- Click Register.
- 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 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.
Course Content Teacher
Organize your teaching material into subjects and lessons.
Creating a Subject
- Go to Course Content in the teacher navigation.
- Click + New Subject.
- Enter a subject name, choose an emoji icon, and pick a color.
- Click Save — the subject card appears in your grid.
Subject Card Grid
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.
- Find the subject card in the Course Content grid.
- Click the 👯 Duplicate button on the card (this acts as a Copy feature).
- A new subject is created with the name "Copy of [Subject Name]".
- The copy includes all lessons, assessments, and pathways, but starts as Draft and has no contributors linked.
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:
- Owners have full control: edit, delete, add lessons, and add contributors.
- Other Teachers can view your content (Read-Only) but cannot make any changes.
- Admins have full access to all content on the platform and can manage any subject or lesson.
Collaborating with Contributors
If you want other teachers to help you build or manage a course, you can add them as Contributors.
- Open the subject you own from the Course Content page.
- Click the 👥 Contributors button in the toolbar.
- In the modal, use the search box to find a teacher by name or email.
- Click the Add button next to their name.
- Contributors gain full "Manage" access to that specific subject and all its lessons.
Read-Only Mode
When you view content as a non-owner/non-contributor, the platform enters Read-Only Mode automatically:
- The Lesson Editor sidebar and toolbar are disabled.
- You cannot add, move, or delete blocks.
- AI generation features are hidden.
- In the Lesson Flow, you can see the path but cannot move nodes or change connections.
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.
- List View: A traditional table of all lessons, best for quick edits and deletions.
- Flow View: An interactive canvas where you design the sequence of learning.
2. Designing the Journey
Designing a pathway is as simple as connecting nodes:
- Add Lessons: Drag lessons from the "Library" sidebar onto the canvas.
- Link Nodes: Click and drag from one node to another to create a prerequisite link.
- Branching: You can create multiple paths — for example, a "Remedial" path and an "Advanced" path that diverge after a quiz.
3. Filtering and Navigation
The flow graph can get complex, so use the built-in tools to manage the view:
- Grade Chips: Click grade buttons (e.g., "Grade 10") to highlight only the lessons relevant to that level.
- Skill Chips: Toggle "Beginner", "Intermediate", or "Advanced" to see the learning progression for different abilities.
- Zoom & Pan: Use your mouse wheel to zoom in/out and click-drag the background to pan across the map.
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.
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
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.
- Select a block in the editor.
- Enable Visibility Rule in the block settings.
- Choose the condition (e.g., score ≥ 80%) and the target assessment block.
- 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
Generating a Full Lesson
- Open a subject and click New Lesson or open an existing lesson.
- 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."
- Click Generate. The AI returns structured blocks.
- 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.
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.
- Prompt-to-SVG: Describe your concept (e.g., "A diagram of a plant cell with labeled organelles") and the AI builds it.
- Iterative Editing: Refine your design by chatting with the AI. Ask it to "Change the colors to be more vibrant," "Add a title at the top," or "Make the nucleus larger."
- Intelligent Logic: Ask the AI to add interactivity, such as "Make the labels appear only when the organelles are clicked."
2. Dynamic Animations
Bring your diagrams to life with a powerful keyframe-based animation system.
- Recording Mode: Toggle the ⏺️ Record button. Any changes you make to a shape's position, size, rotation, or color will automatically create a keyframe at the current time.
- Supported Properties: Animate
x,y,width,height,opacity,rotation,fill, andstroke. - Timeline Management: Drag keyframes on the timeline to adjust timing or right-click to change easing functions.
3. Visual Logic & Interactivity
Turn your static diagrams into interactive "apps" using the built-in block editor.
- Events: Trigger actions when a student clicks, hovers, or drags a shape.
- Actions: Update shape properties, change variables, or control animations (Play/Stop/Seek).
- Variables: Store and manipulate data (e.g., counters, scores, or toggle states) to create complex simulations.
- Switch to the Code tab in the Diagram Editor.
- Drag an Event block (like "When [Shape] is clicked") onto the workspace.
- Snap Action blocks (like "Set [Shape] opacity to 0") into the event block.
- Click ▶ Run App to test the interactivity immediately.
My Students Teacher
View, add, link, and manage the students in your class.
Student List Features
- Search by name or roll number
- Filter by school and grade
- Edit student details (name, grade, school, roll number)
- Add new students directly
- Link existing students to your account
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
Student Registration Student
How students create an account and log in.
Registering as a New Student
- Go to the home page and click I am a Student, or navigate to
/student/login. - Select the New Student tab.
- Enter your name, email, password, grade, preferred language, and school.
- Click Register.
- Wait for Approval — Your account will be
pending. A school admin must approve you before you can access lessons.
Supported Languages
Students can choose from 10 languages at registration and change it anytime from their profile:
- English, Nepali, Maithili, Bhojpuri, Tharu
- Tamang, Newari (Nepal Bhasa), Magar, Gurung, Sherpa
Learning a Lesson Student
How to navigate and interact with lessons.
Lesson Player Layout
Navigating Lessons
- Scroll through blocks — text, diagrams, videos, and quizzes appear in order
- Click Next Lesson at the bottom to advance when you're done
- Use Read Aloud to have the AI teacher read the content to you
- Switch language from your profile at any time — content re-translates instantly
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
- Click the microphone button on the AI teacher panel to speak your question.
- Or type your question in the chat input below the teacher.
- The AI teacher responds in your selected language with a short, encouraging answer.
- The teacher's mouth animates while speaking the response aloud.
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.
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.
Progress & Scores Student
Your learning progress is tracked automatically as you complete lessons and assessments.
What Gets Tracked
- Lessons completed per subject
- Assessment scores for each lesson
- Overall progress percentage per topic
- Time spent on lessons
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!
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
- 🐢 Steady Turtle: Complete your first lesson.
- 🐰 Fast Rabbit: Complete 3 lessons.
- 🐬 Smart Dolphin: Complete your first assessment.
- 🦉 Scholar Owl: Get a 100% score on any assessment.
- 🐘 Wise Elephant: Complete 7 lessons.
- 🦁 Brave Lion: Complete 15 lessons.