Skip to content

Aarinmahala/punjab-digital-learning-platform

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

3 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ›οΈ Punjab Digital Learning Platform

Official Government Education Management System
Transforming Rural Education Through Digital Innovation

Live Demo Platform

🎯 Overview

The Punjab Digital Learning Platform is a comprehensive, government-grade education management system designed for rural areas in Punjab, India. Built with modern web technologies and mobile-first design.

🌐 Live Demo

URL: https://punjab-digital-learning-platform-d745eou28.vercel.app

πŸ”‘ Demo Credentials

πŸ›οΈ Key Features

  • βœ… Official Punjab Government Branding
  • βœ… Multi-Role System (Admin, Teacher, Student)
  • βœ… Mobile-First Design optimized for smartphones
  • βœ… Progressive Web App (PWA) with offline capabilities
  • βœ… Regional Language Games (English, Punjabi, Hindi)
  • βœ… Complete Education Management tools
  • βœ… Secure Authentication with role-based access

πŸ“± Mobile App (APK)

Generate Android APK using: https://webtoapk.com Paste our live URL to create professional government-branded mobile app.

πŸš€ Quick Start

npm install
npm start

πŸ—οΈ Technology Stack

  • Frontend: HTML5, CSS3, JavaScript
  • Backend: Node.js, Express.js
  • Authentication: JWT
  • Deployment: Vercel
  • PWA: Service Worker, Web App Manifest

πŸ“ž Support


πŸ›οΈ Built for Punjab Education - Transforming Rural Learning Through Digital Innovation

🌟 Features

Core Features

  • Offline-First Architecture: Full functionality without internet connectivity
  • Multi-Language Support: English, Hindi (ΰ€Ήΰ€Ώΰ€‚ΰ€¦ΰ₯€), and Punjabi (ΰ¨ͺΰ©°ΰ¨œΰ¨Ύΰ¨¬ΰ©€)
  • Role-Based Access: Student, Teacher, and Admin dashboards
  • Interactive Learning: Quizzes, videos, and gamified lessons
  • Progress Tracking: Detailed analytics and progress monitoring
  • Digital Literacy Modules: Essential computer and internet skills

Student Features

  • Access to courses (Mathematics, Science, Digital Literacy)
  • Interactive lessons and quizzes
  • Offline content downloads
  • Personal progress tracking
  • Mobile-optimized interface

Teacher Features

  • Student progress monitoring
  • Lesson management
  • Assignment creation
  • Communication tools
  • Analytics dashboard

Admin Features

  • User management
  • Course management
  • System analytics
  • Performance reports
  • Multi-school oversight

πŸš€ Quick Start

Prerequisites

  • Node.js (v14 or higher)
  • npm or yarn

Installation

  1. Clone the repository

    git clone <repository-url>
    cd nabha-digital-learning-platform
  2. Install dependencies

    npm install
  3. Start the development server

    npm run dev
  4. Open your browser Navigate to http://localhost:5000

Demo Credentials

Admin Access

  • Email: [email protected]
  • Password: admin123
  • Features: Full system access, analytics, user management

Teacher Access

  • Email: [email protected]
  • Password: teacher123
  • Features: Student monitoring, lesson management

Student Access

  • Email: [email protected]
  • Password: student123
  • Features: Course access, interactive learning

πŸ“± Technology Stack

Frontend

  • Vanilla JavaScript: Lightweight and fast
  • CSS3: Modern styling with responsive design
  • Service Workers: Offline functionality
  • Local Storage: Client-side data persistence

Backend

  • Node.js: Server runtime
  • Express.js: Web framework
  • In-Memory Storage: Demo data (easily replaceable with MongoDB)
  • JWT: Authentication

Features

  • Progressive Web App (PWA): Installable on mobile devices
  • Responsive Design: Works on all screen sizes
  • Offline Support: Full functionality without internet
  • Multi-Language: i18n implementation

🎯 Target Audience

Primary Users

  • Students: Rural students in grades 6-12
  • Teachers: Educators in government schools
  • Administrators: School principals and education officials

Use Cases

  • Offline learning in areas with poor connectivity
  • Digital literacy training for rural communities
  • Progress tracking for government education programs
  • Multi-language education support

πŸ—οΈ Architecture

Offline-First Design

Client Device
β”œβ”€β”€ Service Worker (Caching)
β”œβ”€β”€ Local Storage (Data)
β”œβ”€β”€ IndexedDB (Large Data)
└── Background Sync

Language Support

Translations
β”œβ”€β”€ English (Primary)
β”œβ”€β”€ Hindi (ΰ€Ήΰ€Ώΰ€‚ΰ€¦ΰ₯€)
└── Punjabi (ΰ¨ͺΰ©°ΰ¨œΰ¨Ύΰ¨¬ΰ©€)

Role-Based Dashboards

Platform
β”œβ”€β”€ Student Dashboard
β”‚   β”œβ”€β”€ Course Access
β”‚   β”œβ”€β”€ Progress Tracking
β”‚   └── Offline Downloads
β”œβ”€β”€ Teacher Dashboard
β”‚   β”œβ”€β”€ Student Monitoring
β”‚   β”œβ”€β”€ Lesson Management
β”‚   └── Analytics
└── Admin Dashboard
    β”œβ”€β”€ User Management
    β”œβ”€β”€ System Analytics
    └── School Performance

πŸ“š Educational Content

Mathematics

  • Algebra fundamentals
  • Linear equations
  • Geometry basics
  • Problem-solving techniques

Science

  • Basic chemistry
  • Physics concepts
  • Biology fundamentals
  • Practical experiments

Digital Literacy

  • Computer basics
  • Internet safety
  • Digital communication
  • Online learning skills

πŸ”§ Development

Project Structure

nabha-digital-learning-platform/
β”œβ”€β”€ public/
β”‚   β”œβ”€β”€ index.html      # Main HTML file
β”‚   β”œβ”€β”€ app.js          # Frontend JavaScript
β”‚   └── sw.js           # Service Worker
β”œβ”€β”€ server.js           # Backend server
β”œβ”€β”€ package.json        # Dependencies
└── README.md          # Documentation

Key Components

Authentication System

// JWT-based authentication
// Role-based access control
// Secure session management

Offline Storage

// Service Worker caching
// Local Storage for user data
// Background sync for data updates

Multi-Language Support

// i18n implementation
// Dynamic language switching
// Cultural localization

API Endpoints

Authentication

  • POST /api/auth/login - User login
  • GET /api/users - User management (admin/teacher)

Courses

  • GET /api/courses - Get all courses
  • GET /api/courses/:id - Get specific course
  • GET /api/lessons - Get lessons
  • GET /api/lessons/:id - Get specific lesson

Progress

  • GET /api/progress - Get user progress
  • POST /api/progress - Update progress

Analytics

  • GET /api/analytics/overview - System statistics

🌐 Deployment

Production Setup

  1. Environment Variables

    NODE_ENV=production
    PORT=5000
    JWT_SECRET=your-secret-key
    MONGODB_URI=your-mongodb-connection
  2. Build for Production

    npm run build
  3. Start Production Server

    npm start

Deployment Options

  • Government Servers: For official education department hosting
  • AWS/Google Cloud: Scalable cloud deployment
  • Local Servers: School-based hosting for better offline support

πŸ“Š Impact & Benefits

Educational Impact

  • Improved Access: Rural students get quality education
  • Digital Skills: Essential 21st-century skills
  • Language Preservation: Content in local languages
  • Teacher Efficiency: Digital tools for educators

Technical Benefits

  • Offline Capability: Works without internet
  • Low Bandwidth: Optimized for slow connections
  • Mobile-First: Accessible on smartphones
  • Scalable: Can serve thousands of students

Social Impact

  • Digital Divide: Reduces educational inequality
  • Rural Development: Empowers rural communities
  • Language Diversity: Preserves local languages
  • Government Goals: Supports Digital India initiative

🀝 Contributing

We welcome contributions from educators, developers, and community members!

How to Contribute

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Test thoroughly
  5. Submit a pull request

Areas for Contribution

  • Educational content development
  • Language translations
  • User interface improvements
  • Performance optimizations
  • Testing and bug fixes

πŸ“ž Support

Contact Information

  • Project Team: Nabha Digital Learning Initiative
  • Email: [email protected]
  • Documentation: Available in multiple languages

Community

  • Join our educator community
  • Share feedback and suggestions
  • Report issues and bugs
  • Contribute educational content

πŸ“„ License

This project is licensed under the MIT License - see the LICENSE file for details.

πŸ™ Acknowledgments

  • Government of Punjab: Supporting rural education
  • Local Educators: Providing valuable insights
  • Student Community: Testing and feedback
  • Open Source Community: Technical contributions

Empowering Rural Education Through Technology πŸŽ“

Built with ❀️ for the students and teachers of Nabha and rural Punjab.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages