{"id":24167171,"url":"https://github.com/follownaim/learnmate","last_synced_at":"2026-04-02T03:02:12.867Z","repository":{"id":271503206,"uuid":"906630098","full_name":"FollowNaim/LearnMate","owner":"FollowNaim","description":"A one-stop solution for learners to connect with professional tutors, schedule tutorial sessions, and achieve their academic goals with ease. The platform also empowers tutors to manage bookings and reviews efficiently.","archived":false,"fork":false,"pushed_at":"2025-01-11T05:27:17.000Z","size":6363,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-02T09:14:27.532Z","etag":null,"topics":["expressjs","firebase","framer-motion","mongodb","nodejs","react","shadcn-ui","tanstack-react-query"],"latest_commit_sha":null,"homepage":"https://learnmates.vercel.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/FollowNaim.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2024-12-21T12:53:51.000Z","updated_at":"2025-01-11T05:27:20.000Z","dependencies_parsed_at":"2025-01-08T07:31:38.416Z","dependency_job_id":null,"html_url":"https://github.com/FollowNaim/LearnMate","commit_stats":null,"previous_names":["follownaim/learnmate"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FLearnMate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FLearnMate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FLearnMate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/FollowNaim%2FLearnMate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/FollowNaim","download_url":"https://codeload.github.com/FollowNaim/LearnMate/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241482109,"owners_count":19969850,"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":["expressjs","firebase","framer-motion","mongodb","nodejs","react","shadcn-ui","tanstack-react-query"],"created_at":"2025-01-12T21:12:37.917Z","updated_at":"2025-12-30T19:05:32.994Z","avatar_url":"https://github.com/FollowNaim.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LearnMate\n\nThis repository contains the front-end implementation for **LearnMate**, an innovative platform that bridges the gap between tutors and learners. Designed with modern technologies, LearnMate ensures a smooth and effective user experience for managing educational needs.\n\n---\n\n## Purpose\n\n[Learn Mate](https://learnmates.vercel.app/) is a one-stop solution for learners to connect with professional tutors, schedule tutorial sessions, and achieve their academic goals with ease. The platform also empowers tutors to manage bookings and reviews efficiently.\n\n---\n\n## Showcase\n\n\u003cimg src='https://i.ibb.co.com/s3Wfgyk/01.jpg'/\u003e\n\n---\n\n## Live URL\n\n[Live Site](https://learnmates.vercel.app/)\n\n---\n\n## Tech Stack\n\n- **Frontend Framework:** React.js\n- **Styling:** Tailwind CSS, Shadcn\n- **Animations:** Framer Motion\n- **State Management:** Context API\n- **Routing:** React Router\n- **Backend:** Node.js, Express.js\n- **Database:** MongoDB\n- **Authentication:** Firebase Authentication (JWT token integration)\n- **Data Fetching:** TanStack Query, Axios\n\n---\n\n## Key Features\n\n- **Responsive Design:**  \n  User-friendly layout optimized for all devices.\n\n- **Tutor Browsing:**  \n  Search, filter, and view tutors by category, subject, and availability.\n\n- **Tutor Management::**  \n  Create, view , update and delete tutorial for student to book.\n\n- **Booking System:**  \n  Schedule tutorial sessions in just a few clicks.\n\n- **Review System:**  \n  Rate and review tutors to ensure transparency and trust. Leave reviews, incrementing the review count dynamically.\n\n- **Secure Authentication:**  \n  Firebase-powered authentication with JWT integration.\n\n- **Category Insights:**  \n  Explore popular subjects and find tutors in specific categories.\n\n- **Dynamic Animations:**  \n  Engaging transitions and effects using Framer Motion.\n\n- **Data Synchronization:**  \n  Real-time updates for bookings and tutor details via TanStack Query.\n\n---\n\n## Features Overview\n\n### Authentication\n\n- Secure login and registration for users (students and tutors).\n- Persistent login sessions using Firebase and JWT.\n\n### Tutor Management\n\n- Display dynamic lists of tutors filtered by categories or search terms.\n- View detailed profiles of tutors, including ratings and reviews.\n\n### Booking Management\n\n- Schedule tutorial sessions with selected tutors.\n- Manage bookings directly from the user dashboard.\n\n### Reviews\n\n- Leave feedback for tutors after a session.\n- View average ratings for each tutor.\n\n### Dashboard\n\n- Personalized dashboard for users to manage bookings and reviews.\n- Tutors can view and manage upcoming tutorial requests.\n\n---\n\n### Additional Features\n\n- **Dark/Light Mode:** Toggle theme for the entire application.\n- **Error and Loading Pages:** Ensures smooth user experience.\n- **Animations:** Integrated animations using Framer Motion.\n\n---\n\n## Endpoints Used\n\n### Authentication\n\n- **`POST /jwt`** – Generate JWT token for user authentication.\n- **`GET /clearjwt`** – Logout by clearing the JWT token.\n\n### Users\n\n- **`GET /users`** – Retrieve total user count.\n- **`POST /user`** – Register a new user.\n- **`PATCH /user`** – Update user profile details.\n\n### Tutors\n\n- **`GET /tutors`** – Retrieve tutor list with optional filtering.\n- **`GET /tutors/categories`** – Fetch unique tutor categories.\n- **`GET /tutors/:id`** – Retrieve specific tutor details.\n\n### Bookings\n\n- **`GET /bookings`** – Fetch all bookings for a user.\n- **`POST /bookings`** – Create a new booking.\n\n### Categories\n\n- **`GET /categories`** – Retrieve category-wise tutor counts.\n\n---\n\n## Dependencies\n\n- **@radix-ui/react-avatar**: ^1.1.2 – A Radix UI component for displaying user avatars.\n- **@radix-ui/react-dropdown-menu**: ^2.1.4 – A Radix UI dropdown menu component.\n- **@radix-ui/react-label**: ^2.1.1 – A Radix UI label component for forms.\n- **@radix-ui/react-select**: ^2.1.4 – A Radix UI select dropdown component.\n- **@radix-ui/react-slot**: ^1.1.1 – A utility for passing dynamic components as slots.\n- **@tanstack/react-query**: ^5.62.8 – Powerful data-fetching library for React.\n- **axios**: ^1.7.9 – A promise-based HTTP client for making API requests.\n- **class-variance-authority**: ^0.7.1 – Utility for handling className variants in React.\n- **clsx**: ^2.1.1 – Utility for constructing `className` strings conditionally.\n- **firebase**: ^11.1.0 – Google Firebase JavaScript SDK.\n- **framer-motion**: ^11.15.0 – Motion library for React animations.\n- **hamburger-react**: ^2.5.2 – A hamburger menu button component.\n- **lottie-react**: ^2.4.0 – A React library for rendering Lottie animations.\n- **lucide-react**: ^0.469.0 – React icons library with beautiful, consistent icons.\n- **react**: ^18.3.1 – A JavaScript library for building user interfaces.\n- **react-dom**: ^18.3.1 – React package for working with the DOM.\n- **react-helmet-async**: ^2.0.5 – A library for managing document head tags asynchronously.\n- **react-hot-toast**: ^2.4.1 – Toast notification library for React.\n- **react-icons**: ^5.4.0 – Popular icon library for React.\n- **react-router-dom**: ^7.1.0 – Declarative routing for React applications.\n- **react-tooltip**: ^5.28.0 – Tooltips for React components.\n- **sweetalert2**: ^11.15.3 – A customizable, accessible replacement for JavaScript’s alert.\n- **tailwind-merge**: ^2.5.5 – Utility for merging Tailwind CSS class strings.\n- **tailwindcss-animate**: ^1.0.7 – Animation utilities for Tailwind CSS.\n\n---\n\n## Dev Dependencies\n\n- **@eslint/js**: ^9.17.0 – ESLint's core JavaScript functionality.\n- **@types/node**: ^22.10.2 – TypeScript definitions for Node.js.\n- **@types/react**: ^18.3.17 – TypeScript definitions for React.\n- **@types/react-dom**: ^18.3.5 – TypeScript definitions for React DOM.\n- **@vitejs/plugin-react**: ^4.3.4 – Vite plugin for React support.\n- **autoprefixer**: ^10.4.20 – PostCSS plugin for adding vendor prefixes automatically.\n- **eslint**: ^9.17.0 – A tool for identifying and fixing JavaScript code issues.\n- **eslint-plugin-react**: ^7.37.2 – ESLint plugin for React best practices.\n- **eslint-plugin-react-hooks**: ^5.0.0 – ESLint rules for React hooks.\n- **eslint-plugin-react-refresh**: ^0.4.16 – ESLint plugin for React Fast Refresh.\n- **globals**: ^15.13.0 – Global variable definitions for ESLint.\n- **postcss**: ^8.4.49 – A tool for transforming CSS with JavaScript plugins.\n- **tailwindcss**: ^3.4.17 – A utility-first CSS framework.\n- **vite**: ^6.0.3 – Next-generation frontend build tool.\n\n---\n\n## 🔧 How to Run\n\n1. **Clone the repository.**\n\n```bash\n   git clone https://github.com/FollowNaim/LearnMate\n   cd LearnMate\n```\n\n2. **Install Dependencies**\n\n```bash\nnpm install\n```\n\n3. **Setup Environment Variables**\n\n- create .env.local in the root directory.\n- Add `VITE_API_URL` variable and put your server url here.\n- create a firebase project and add config here\n- firebase config will look like\n\n```bash\nVITE_Projectid\nVITE_apikey\n```\n\nlike this.\n\n4. ** Run the application**\n\n```bash\nnpm run dev\n```\n\n5. **Access the app**\n\n- Open http://localhost:5173 in your browser.\n\n---\n\n## 🛠️ Deployment\n\n- Hosted on Netlify or Vercel for a fast and reliable experience.\n- Firebase Authentication requires authorized domains to ensure secure access.\n\n---\n\n## 🤝 Contributions\n\nContributions are welcome! Fork this repository, make your changes, and submit a pull request.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollownaim%2Flearnmate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffollownaim%2Flearnmate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffollownaim%2Flearnmate/lists"}