Future Classroom
A modern digital learning platform built for Georgian schools — Georgian first, English alongside — for a school with ~16 desktop learning workstations and one interactive touchscreen. AI helps where it is useful; nothing depends on it.
Technology should improve the learning environment, not replace the teacher.
Teacher → Lesson → Classroom session → Student activities → Hints → Feedback → Progress
- Teachers draft a lesson (with AI, or from built-in lessons when AI is off), edit everything, and run it live: students join with a code like
FC-4821, the teacher launches activities one by one and sees answers arrive in real time.
- Students answer on their workstation and get hint-first help: a conceptual nudge first, more specific hints next, and the full solution only as the last step (and only if the teacher allows it). Outside class they practise, take quizzes, review mistakes and work with the school's materials in the Learning Assistant.
- School materials (PDF, DOCX, TXT, Markdown) are indexed by their own chapters, sections and pages, and the Learning Assistant (
/learning-assistant) helps students work with them and with the lessons: explain a topic, find where the answer is, weigh the evidence for a statement, check their own understanding, find good questions and start a research project — always showing the source.
- Six laboratories that work without AI: Programming (Python and C++), STEM, Research, Critical Thinking, the School Library and Career & University — tied together by teacher assignments, a student portfolio and one learning profile per student.
- 18 subjects with a catalogue (
/subjects): 46 built-in lessons with practice, hint ladders and quizzes, each linked to the lab activities, simulations, books and career pages that fit it.
- Georgian and English throughout: the interface, the built-in lessons, the lab content and the demo school. Georgian is the default.
Quick start
Requirements: Node.js 20.9+ (22 LTS recommended).
npm install
npm run dev # http://localhost:3000
On first start in development (npm run dev) the app creates data/future-classroom.db, installs the built-in lessons and seeds a demo school (teachers, students, two finished sessions, quiz results, materials, lab work and assignments), written in the school's language — Georgian unless DEFAULT_LANGUAGE=en. No other setup is needed.
Demo accounts (password demo1234), or use the one-click buttons on the home page:
| Role | Username | Notes |
|---|
| Teacher | nino | Mathematics, economics, research, critical thinking; owns the demo sessions |
| Teachers | davit, eka | Physics, computer science, engineering · Chemistry, biology, geography, health |
| Teachers | manana, irakli, natia | Georgian, arts · History, civics · English, career |
| Student | mariam | Has progress history |
| Students | giorgi, ana, luka, saba, elene, nika, tamar | |
| Admin | admin | Can open any teacher's content |
Enabling AI (optional)
cp .env.example .env.local
# set ANTHROPIC_API_KEY=... (and optionally AI_MODEL, default claude-opus-5)
Without a key everything still works in offline mode, and the UI says so everywhere it matters (header badge, lesson notices, hint labels, Learning Assistant notes). The app never presents template content as AI output. The six laboratories use no AI at all: checking, feedback and hints are deterministic or teacher-written.
The 5-minute demo
- Teacher (normal window): Continue as demo teacher → Create lesson → Mathematics, Grade 11, “Quadratic equations” → Generate lesson.
- Review the lesson: tabs for structure (with a parabola graph), activities (each with a 4-step hint ladder and solution), discussion & homework. Edit anything, then Start classroom session → the join code appears.
- Student (private window or another workstation): open
/join, enter the code and a first name.
- Teacher: Launch first activity. Student answers the multiple-choice question.
- Teacher: Next activity (“Solve x² − 5x + 6 = 0”). Student clicks Get a hint twice (“What two numbers multiply to 6 and add to −5?”), submits a wrong answer, then the right one.
- Teacher sees the answer, attempts and hints used, clicks Show results to class, optionally opens Presentation view on the touchscreen.
- End session → the session summary (participation, correct %, common wrong answers, per-student table).
Also worth showing: Class overview (teacher insights), the student dashboard/progress, and the student Library (“What does our physics material say about Newton’s second law?”).
Subjects and built-in lessons
Subjects (/subjects) is the entry point for students and teachers: 18 subjects in six groups, filterable by grade and activity type. Each subject page has a recommended learning path, topics that link to real content (lessons, quizzes, programming problems, simulations, experiments, projects, library books, careers), the student's progress on each item and the lessons the school's own teachers have published. Teachers can preview or duplicate a lesson, assign any item, run it in a live session or start a new lesson for the subject.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
