A self-hosted, "Walled Garden" Learning Management System (LMS) designed for safe, distraction-free home education.
Nuken LMS allows parents and educators to host a private server where students can learn, track progress, and socialize safely without exposure to the open internet.
Experience the student interface directly in your browser at https://nukenlms.com.
| Student Name | Active Theme | PIN Code |
|---|---|---|
| Test1 | Default | 1234 |
| Test2 | Princess | 1234 |
| Test3 | Space | 1234 |
Note: For security reasons, the public demo does not have access to parent dashboards or administrative functions. All games are visible to all users for the demo.
🎯 Target Audience: Currently pre-loaded with content optimized for Preschool to 3rd Grade (Literacy, Basic Math, Logic). However, the platform is grade-agnostic—it is built to grow with your students, allowing you to easily develop or install modules for older age groups (Coding, Advanced Math, Typing, etc.).
The core philosophy is complete isolation from the "wild web."
- Zero External Footprint: No Google Analytics, no third-party fonts, and no outbound links.
- Internal Messaging System: Students can send messages (e.g., emojis, encouragement) to family members or other students only within the local system.
- Data Sovereignty: All progress data, messages, and user accounts reside 100% on your own server.
- Grade-Level Filtering: The database supports
min_gradeandmax_gradeparameters. As you add complex games for older kids, they will only appear for students in those grades. - Scalable Engine: The "GameBridge" API handles simple matching games just as easily as complex logic puzzles or typing tutors.
- Student Management: Create accounts with secure PIN Code Login for easy access.
- Granular Analytics: View detailed Report Cards showing scores, completion time, and specific mistake counts.
- Adaptive Theming: The interface and game content adapt to the student's interest (e.g., "Robo-Sorter" becomes "Unicorn Sorter" in the Fairy Tale theme).
- Security Lockouts: Built-in protection against brute-force PIN guessing.
- Personalized Dashboard: Students can "Favorite" specific exercises for quick access.
- Gamified Learning: Earn badges (e.g., "Word Wizard", "Streak Master") and unlock visual rewards.
- Voice Guidance: Integrated Text-to-Speech acts as a personal tutor, reading instructions aloud.
- Safe Socializing: Unlock the "Messenger Box" badge to send safe, local messages to parents or siblings.
The LMS comes pre-loaded with over 20 curriculum-aligned titles for early learners:
| Subject | Modules |
|---|---|
| Literacy & Language | Alphabet Fun, Sight Word Adventures, Read & Match, Spell It!, Wild World (Animals), The Cat and Rat, Cosmic Signal (Reading), Fiesta Piñata (Spanish) |
| Math & Logic | Egg-dition (Arithmetic), Robo-Sorter (Categorization), Rocket Shop (Currency), Launch Time (Analog Clocks), Pattern Train, Spider Web (Geometry) |
| Executive Function | Robot Commander (Auditory Processing/Simon Says), Traffic Control (Impulse Control/Red Light) |
| Motor Skills | Balloon Pop, Lava Bridge |
| Creativity | Coloring Book, Color Lab |
Ideal for home labs (Portainer/Docker Compose).
-
Clone the Repository
git clone https://github.com/nuken/kid-games.git cd kid-games -
Configure Environment
- Rename
includes/config.sample.phptoincludes/config.php. - Edit
includes/config.phpwith secure credentials. - Update Docker Compose: Ensure
MYSQL_USERandMYSQL_PASSWORDindocker-compose.ymlmatch your config.
- Rename
-
Start Services
docker-compose up -d
Access the LMS at
http://localhost:8080. -
Finish Setup
- Visit
http://localhost:8080/install.phpto create your Admin account.
- Visit
- Upload: Upload files to your server's
public_html. - Database: Create a MySQL/MariaDB database.
- Config: Rename and edit
includes/config.phpwith your database details. - Install: Run the installer at
yoursite.com/install.php.
⚠️ Security: The installer attempts to self-destruct. Ifinstall.phpremains after setup, manually delete it.
Expand the LMS with your own modules using the GameBridge API.
- Data Sync:
GameBridge.saveScore({...})automatically syncs results to the student's report card. - TTS Engine:
GameBridge.speak("Select the square")utilizes browser-native speech. - Theme Awareness: Detect the active LMS theme (Space/Princess/Default) to swap game assets dynamically.
- Core: PHP 7.4+ (Tested on 8.4)
- Data: MariaDB / MySQL
- Frontend: Vanilla Javascript, HTML5, PWA Support
- Delivery: Docker & Docker Compose