Human-first learning. Bite-sized lessons that actually stick.Welcome to HouseLearning Lessons Page — a fun and interactive learning website designed to make education engaging through browser-based mini-games and activities. The platform offers a collection of educational games that help users practice and reinforce their skills while having fun.
Curious to see our plans? Check the roadmap.
See STUDENT_LEARNING.md for the student learning foundation, Firestore access model, deployment notes, and remaining platform phases.
-
🌟 Interactive educational games
Engaging activities that respond to player input in real time. -
🏆 Instant feedback and rewards
Players get immediate results, points, and progress indicators to track learning. -
📱 Simple, clean, and responsive interface
Designed to be easy to use on desktop and mobile browsers. -
🎨 Web-based — no installation required
Runs directly in your web browser with no extra software needed.
- HTML5
- CSS3
- JavaScript
- Firebase API
The static website, generated K–12 course catalog, Lesson CLI, expression engine, and seasonal themes run on GitHub Pages or in the browser/local tooling and add no paid service dependency. Their GitHub Actions workflows use the repository's included Actions quota.
Forum and Gists public-content moderation is pending-by-default and manually reviewed. It uses existing Firestore reads/writes and security rules; the moderation path does not call Gemini or add Cloud Functions. The one-time legacy-content queue also uses Firestore operations, so run it in a small batch and monitor the Firebase free quota.
This repository already contains SafeAI and notification Firebase Functions. SafeAI can call the configured Gemini provider, and email notifications use a configured mail provider; those existing services may have metered usage. This project cannot guarantee a $0 bill if those services are enabled or Firebase/GitHub usage exceeds free quotas. Check the provider's current limits and set billing alerts/limits before enabling them. Do not place credentials in the repository.
receivePushNotificationEmail accepts SendGrid Inbound Parse multipart webhooks. Create the PUSH_EMAIL_WEBHOOK_SECRET Firebase Functions secret, then deploy with firebase deploy --only firestore:rules and firebase deploy --only functions:receivePushNotificationEmail,functions:getNotificationImage. Configure the SendGrid Parse URL as the deployed function URL with ?token= followed by that secret. Keep the secret in Firebase Secret Manager and the mail-provider configuration; never put it in firestore.rules or frontend code. Route push-notifications@houselearning.org to SendGrid Inbound Parse through the domain's existing email provider; do not replace domain-wide MX records unless that is intentional.
Only messages whose parsed sender is cajm23331@gmail.com are accepted. Subjects must be exactly @everyone, @admins-only, @students, @teachers, or @user user@example.com. Accounts without an admin or teacher role are treated as students. Text is rendered as plain text; PNG, JPEG, GIF, and WebP attachments are accepted, while other attachments are rejected. Image files are served only after verifying the signed-in user's access to the notification.
Here’s a preview of the HouseLearning Home website (subject to change):
