https://github.com/useraar/eduhack-autisense

https://github.com/useraar/eduhack-autisense

Last synced: 4 months ago
JSON representation

• Host: GitHub
• URL: https://github.com/useraar/eduhack-autisense
• Owner: UserAAR
• Created: 2025-04-19T15:38:23.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-04-19T15:58:17.000Z (about 1 year ago)
• Last Synced: 2025-05-15T01:14:40.464Z (about 1 year ago)
• Language: HTML
• Size: 21.8 MB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          


  🔗 Live Demo: autisense1.netlify.app



🧠 AutiSense 🧠




  A responsive, child‑friendly web application that connects autistic children (6–14), their parents, and specialized teachers through interactive lessons, games, AI‑driven insights, and a Supabase backend — built entirely with HTML, CSS & JavaScript.





📝 Overview

This project delivers:



  


Interactive Learning for Children: Short animated lessons (hygiene, safety, social skills) plus mini‑tests and educational games.

  


Parent Dashboard & AI Insights: Track each child’s progress, view charts & test stats, receive personalized AI analysis & recommendations.

  


Teacher Directory & Profiles: Specialized educators register, showcase experience/skills, and parents can filter & connect.





✨ Key Features



  
🎮 Lessons & Games: Colorful card grid, embedded GIF/video animations, MCQ quizzes, drag‑and‑drop & matching games.

  
👪 Parent Panel: Login/Register via Supabase Auth, add/manage children, switch active child, progress bars & Chart.js graphs.

  
🤖 AI Assistant: On first visit, fetch child profile & stats from Supabase, send a custom “initial analysis” prompt to Gemini API, then answer follow‑up parent questions using stored data.

  
🧑‍🏫 Teacher Module: Registration form, profile cards, filter by region/skill/experience, modal detail view.

  
🌐 Full Frontend Stack: HTML5, CSS3, Vanilla JavaScript, Supabase JS SDK (no custom backend server).

  
📱 Responsive Design: Desktop & tablet optimizations, burger‑menu header, soft pastel color palette, rounded cards & playful icons.





🛠️ Technologies & Architecture



  


Markup & Styles: HTML5, CSS3 (Flexbox, Grid, Media Queries)

  


Client‑side Logic: Vanilla JavaScript (ES6+), Chart.js for graphs

  


Database & Auth: Supabase (PostgreSQL, REST & JS SDK, Auth)

  


AI & LLM: Google Gemini API for generative insights & chat

  


Static Assets: Lottie/GIF animations, DiceBear avatars





📋 Prerequisites



  
Modern web browser (Chrome, Firefox, Edge)

  
Supabase project with tables:

    


      


users (id, email, role)

      


children (id, name, age, parent_id)

      
tests, game_results, ai_feedback

      


teachers (profile fields)

    

  

  
Google Cloud API key for Gemini Model access





🚀 Getting Started



  


Clone the repository:

    
git clone <https://github.com/UserAAR/eduhack-autisense.git> && cd autism-learning-platform

  

  


Configure environment:

    


-- In main.js:

const SUPABASE_URL = 'https://YOUR_PROJECT.supabase.co';

const SUPABASE_ANON_KEY = 'YOUR_ANON_KEY';

const GEMINI_API_KEY = 'YOUR_GEMINI_API_KEY';

  

  


Open index.html in your browser:

    
No build step required — everything runs client‑side.

  

  


Register as Parent/Teacher: Use Supabase Auth UI, then explore dashboards.





📬 Contact



  Developed with ❤️ by  DeepSense Team


  deepsense.az@gmail.com