{"id":25917025,"url":"https://github.com/travelxml/scholar-pulse-ce967982","last_synced_at":"2026-05-16T18:06:23.827Z","repository":{"id":279173654,"uuid":"937921338","full_name":"TravelXML/scholar-pulse-ce967982","owner":"TravelXML","description":"Scholar-Plus is an open-source, all-in-one education management and engagement platform designed to streamline academic reporting, communication, and extracurricular management for K-12 institutions. Featuring digital student profiles with QR code integration, multi-role authentication, real-time messaging, bilingual support, and comprehensive time","archived":false,"fork":false,"pushed_at":"2025-02-24T06:47:07.000Z","size":422,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-24T07:37:02.640Z","etag":null,"topics":["edtech","edtech-app","edtech-backend","edtech-software","k12","k12education","mo","mobile-app","opensource","opensource-projects","reactjs","scholar-plus"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TravelXML.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-02-24T06:04:51.000Z","updated_at":"2025-02-24T07:26:11.000Z","dependencies_parsed_at":"2025-02-24T07:37:13.326Z","dependency_job_id":"c244f8e5-7ef7-4a31-b94a-411f11c18c22","html_url":"https://github.com/TravelXML/scholar-pulse-ce967982","commit_stats":null,"previous_names":["travelxml/scholar-pulse-ce967982"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TravelXML%2Fscholar-pulse-ce967982","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TravelXML%2Fscholar-pulse-ce967982/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TravelXML%2Fscholar-pulse-ce967982/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TravelXML%2Fscholar-pulse-ce967982/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TravelXML","download_url":"https://codeload.github.com/TravelXML/scholar-pulse-ce967982/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241670122,"owners_count":20000327,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["edtech","edtech-app","edtech-backend","edtech-software","k12","k12education","mo","mobile-app","opensource","opensource-projects","reactjs","scholar-plus"],"created_at":"2025-03-03T13:19:31.835Z","updated_at":"2026-05-16T18:06:23.782Z","avatar_url":"https://github.com/TravelXML.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Scholar Plus\n\n**Scholar Plus** is an open-source, all-in-one education management and engagement platform designed to streamline academic reporting, enhance communication among schools, teachers, parents, and students, and manage extracurricular activities. With a mobile-first approach and a clean, minimalist design accentuated in forest green (#OB6623), Scholar Plus provides a unified solution from admissions and academic performance tracking to health monitoring and campus facility access via QR codes.\n\n\n---\n\n## Table of Contents\n\n- [Overview](#overview)\n- [Enhanced Features](#enhanced-features)\n  - [Student Profiles \u0026 Timeline](#student-profiles--timeline)\n  - [Dynamic Home Dashboard](#dynamic-home-dashboard)\n  - [Interactive Dashboard \u0026 School Supplies](#interactive-dashboard--school-supplies)\n  - [Admin Panel \u0026 Multi-Role Authentication](#admin-panel--multi-role-authentication)\n- [Tech Stack](#tech-stack)\n- [Installation](#installation)\n- [Usage](#usage)\n- [Project Structure](#project-structure)\n- [Contributing](#contributing)\n- [License](#license)\n- [Contact](#contact)\n\n---\n\n## Overview\n\nScholar Plus bridges the gap between educational institutions and their stakeholders by consolidating fragmented communication channels and administrative processes. The platform now includes:\n\n- **Detailed Digital Student Profiles:** With comprehensive personal, academic, and emergency details.\n- **Enhanced Timeline \u0026 History:** A visual, chronologically ordered timeline of student milestones—from admissions and academic progress to medical issues, counseling sessions, awards, leave approvals, and teacher recommendations.\n- **Dynamic Home Dashboard:** Featuring a dual-tab interface for school admissions and extracurricular activities, alongside recent school albums and personalized “My Child” photo sections.\n- **Interactive Dashboard:** Showcasing real-time analytics, advanced filtering, and e-commerce features for school supplies.\n- **Robust Admin Panel:** With multi-role authentication (students/parents, schools/activity providers, government) and complete CRUD operations for content, events, and profiles.\n- **QR Code Integration:** For seamless campus facility access and event entry passes.\n\n---\n\n## Enhanced Features\n\n### Student Profiles \u0026 Timeline\n![image](https://github.com/user-attachments/assets/930b3168-27af-4343-8cfc-22e41b006628)\n![image](https://github.com/user-attachments/assets/e8ff9141-36f4-4969-bc77-c93a3ccde184)\n![image](https://github.com/user-attachments/assets/a41d2c0d-8fab-4599-9b69-8524577c3eff)\n![image](https://github.com/user-attachments/assets/f053969d-36f9-4e25-9165-72cc11124f3b)\n\n- **Personal \u0026 Academic Details:**\n  - Capture essentials: name, age, blood group, birth date, Aadhar number, and class roll number.\n  - Upload and manage profile photos (with support for file uploads and potential image cropping/resizing).\n  - Display class information, grade level, section, and academic year.\n\n- **Performance Analytics:**\n  - **Subject-Wise Line Graph:** Visualize performance trends across subjects (e.g., English, Hindi, Math, MIL, Geography, History) with interactive tooltips and legends.\n\n- **Visual Timeline \u0026 History Menu:**\n  - **Chronological Events:** Track admissions, academic milestones, medical issues, counseling sessions, awards, teacher flags/recommendations, and leave approvals.\n  - **Icons \u0026 Badges:**  \n    - School/Academic events – School icon  \n    - Medical issues – Heart Pulse icon  \n    - Counseling sessions – Brain icon  \n    - Awards – Award icon  \n    - Teacher recommendations – Flag icon\n  - **Event Details:** Title, date, description, category badge, and support for file attachments (documents, images).\n  - **Filtering Options:** Easily filter events by type.\n\n---\n\n### Dynamic Home Dashboard\n\n- **Dual-Tab Interface:**\n  - **Schools for Admission:**\n   ![image](https://github.com/user-attachments/assets/f8942299-2a04-4846-bd4e-ccf9b8752c1d)\n \n    - Lists available schools with filters for age, class, and board types (CBSE, ISSC, State Board).\n    - Displays tags indicating available class ranges (from playschools/nursery to higher standards) and “buy” options for related supplies.\n  - **Extracurricular Activities \u0026 Competitions:**\n    ![image](https://github.com/user-attachments/assets/0a829c90-d5f6-4ca6-bd1e-423b39efed74)\n\n    - Showcases activities (dance, karate, pottery, etc.) with search and filtering options based on age groups, categories, and organizers.   \n\n\n- **Additional Home Sections:**\n  - **Recent Albums:**  \n    - Positioned just before quick actions; displays recent school albums with a “View All” button for event-based photo galleries.\n  - **My Child Tab:**  \n    - Offers a personalized view of photos tagged for your child.\n\n---\n\n### Interactive Dashboard \u0026 School Supplies\n![image](https://github.com/user-attachments/assets/ffd70d68-6716-4555-a567-039610aa00cc)\n![image](https://github.com/user-attachments/assets/c1253b3e-1af7-47bb-9806-f64fa7153699)\n![image](https://github.com/user-attachments/assets/71f5afb6-6ca4-4245-ad97-4f1bf568ddac)\n\n- **Overview Cards:**  \n  - Display key metrics in a two-card-per-row layout for Schools, Activities, and School Supplies.\n  - Each card includes intuitive icons (all styled in forest green #OB6623), interactive hover effects, and click actions.\n![image](https://github.com/user-attachments/assets/c1383698-c453-4eea-b067-408fdc9de910)\n\n\n- **School Supplies Module:**\n  ![image](https://github.com/user-attachments/assets/3b6452ec-8bbb-4402-a74a-754726b9729d)\n  ![image](https://github.com/user-attachments/assets/946fdd2d-fb50-4bb5-bd20-ccea7fb89e00)\n  ![image](https://github.com/user-attachments/assets/c18e1f50-c66c-450a-b07a-27ee5580d142)\n\n\n  - **Expanded Categories:**  \n    - Backpacks \u0026 Bags  \n    - Stationery \u0026 School Supplies  \n    - Technology \u0026 Gadgets  \n    - Books \u0026 Learning Materials  \n    - Uniforms \u0026 Clothing  \n    - Lunch Boxes \u0026 Water Bottles  \n    - Art \u0026 Craft Supplies  \n    - Sports \u0026 Activity Gear  \n    - Organizers \u0026 Planners  \n    - Personal Care \u0026 Hygiene Products\n  - **Enhanced Interactions:**  \n    - Smooth animations, hover scaling, image zoom, and real-time search \u0026 filtering options.\n  - **Filtering Options:**  \n    - Filter by age, category, and more to easily find top-selling products or recent purchases.\n\n- **Analytics \u0026 Filtering:**  \n  - Advanced visualizations (line, bar, and pie charts) for user growth, event distribution, and activity types.\n  - Detailed filtering options across all modules.\n\n---\n\n### Admin Panel \u0026 Multi-Role Authentication\n\n- **Admin Dashboard:**\n  ![image](https://github.com/user-attachments/assets/bafb0ca6-7a05-48d7-9ff3-10e8a05a031f)\n\n  - Overview statistics: Total students, active schools, upcoming events, etc.\n  - Dedicated management tabs for content approval, school listings, activities, and analytics.\n  - Complete CRUD operations for managing student profiles, events, and communications.\n  - Refactored into smaller, manageable components for maintainability.\n\n- **Multi-Role Authentication:**  \n  - Separate login and dashboard access for students/parents, schools/activity providers, and government agencies.\n  - Secure OAuth/JWT-based authentication and role-based access control.\n\n- **QR Code Integration:**  \n  - Auto-generate unique QR codes for each student, used for accessing campus facilities (canteen, library, hostels) and event entry passes.\n\n- **Visual Consistency:**  \n  - All card titles, page headers, and icons utilize forest green (#OB6623) for a cohesive look and feel.\n\n---\n\n## Tech Stack\n\n- **Frontend:**  \n  - Cross-platform mobile: React Native or Flutter  \n  - Web Dashboard: ReactJS, Tailwind CSS, shadcn/ui\n\n- **Backend:**  \n  - Node.js, Express  \n  - Supabase (PostgreSQL) for real-time data storage and management\n\n- **APIs \u0026 Integrations:**  \n  - RESTful API endpoints  \n  - UPI payment gateway integration  \n  - GitHub integration for code versioning\n\n- **Security:**  \n  - OAuth/JWT for authentication  \n  - Role-based access control and data encryption\n\n---\n\n## Installation\n\n### Prerequisites\n\n- Node.js (v14+ recommended)\n- npm or yarn package manager\n- Supabase account (for backend services)\n- UPI gateway API keys (for payment features)\n- GitHub account (for code integration)\n\n### Setup Instructions\n\n1. **Clone the Repository:**\n\n   ```bash\n   git clone https://github.com/TravelXML/scholar-pulse-ce967982.git\n   cd scholar-plus\n   ```\n\n2. **Install Dependencies:**\n\n   ```bash\n   npm install\n   # or\n   yarn install\n   ```\n\n3. **Configure Environment Variables:**\n\n   Create a `.env` file in the root directory with the following variables:\n\n   ```env\n   PORT=3000\n   SUPABASE_URL=your_supabase_url\n   SUPABASE_ANON_KEY=your_supabase_anon_key\n   UPI_API_KEY=your_upi_api_key\n   JWT_SECRET=your_jwt_secret\n   ```\n\n4. **Start the Application:**\n\n   ```bash\n   npm start\n   # or\n   yarn start\n   ```\n\n5. **Development Mode (with hot reloading):**\n\n   ```bash\n   npm run dev\n   # or\n   yarn dev\n   ```\n\n---\n\n## Usage\n\n- **Access the Web Dashboard:**  \n  Visit [http://localhost:3000](http://localhost:3000) in your browser.\n\n- **Mobile App:**  \n  Install the mobile app (available on iOS and Android) to access Scholar Plus on the go.\n\n- **Admin Panel:**  \n  Use the admin dashboard to manage student profiles, configure integrations, and monitor system performance.\n\n- **API Documentation:**  \n  Detailed API documentation can be found in the `/docs` folder.\n\n---\n\n## Contributing\n\nWe welcome contributions to Scholar Plus! To contribute:\n\n1. **Fork the Repository**\n\n2. **Create a Feature Branch:**\n\n   ```bash\n   git checkout -b feature/your-feature-name\n   ```\n\n3. **Commit Your Changes:**\n\n   ```bash\n   git commit -m \"Description of your feature\"\n   ```\n\n4. **Push to Your Branch:**\n\n   ```bash\n   git push origin feature/your-feature-name\n   ```\n\n5. **Submit a Pull Request:**\n   - Follow our coding standards and guidelines.\n   - Include detailed commit messages and update documentation as needed.\n   - See our [CONTRIBUTING.md](CONTRIBUTING.md) for more details.\n\n---\n\n## License\n\nThis project is licensed under the MIT License. See the [LICENSE](LICENSE) file for more details.\n\n---\n\n## Contact\n\nFor support or inquiries, please contact:\n\n- **Email:** astartupcto@gmail.com\n- **GitHub:** [scholar-plus](https://github.com/TravelXML/scholar-pulse-ce967982)\n\n---\n\nThank you for exploring Scholar Plus! We look forward to your contributions and feedback as we work together to revolutionize education management.\n\n---\n\nFeel free to adjust or expand any section as the project evolves.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftravelxml%2Fscholar-pulse-ce967982","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftravelxml%2Fscholar-pulse-ce967982","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftravelxml%2Fscholar-pulse-ce967982/lists"}