{"id":29534512,"url":"https://github.com/khaledsaeed18/yalla-learn","last_synced_at":"2025-10-03T16:09:32.572Z","repository":{"id":295458805,"uuid":"941201434","full_name":"KhaledSaeed18/yalla-learn","owner":"KhaledSaeed18","description":"Yalla Learn - 💻 Website","archived":false,"fork":false,"pushed_at":"2025-06-22T18:30:33.000Z","size":2170,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-22T19:34:23.153Z","etag":null,"topics":["ai","ai-sdk","axios","framer-motion","frontend","nextjs","pnpm","react-hook-form","reactjs","redux","server-actions","shadcn-ui","tailwindcss","typescript","vercel","zod"],"latest_commit_sha":null,"homepage":"https://www.yalla-learn.me/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KhaledSaeed18.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2025-03-01T18:21:13.000Z","updated_at":"2025-06-22T18:30:37.000Z","dependencies_parsed_at":"2025-05-25T17:42:01.723Z","dependency_job_id":"3a22ac69-22db-4132-b5b1-60557213b3a5","html_url":"https://github.com/KhaledSaeed18/yalla-learn","commit_stats":null,"previous_names":["khaledsaeed18/yalla-learn"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/KhaledSaeed18/yalla-learn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledSaeed18%2Fyalla-learn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledSaeed18%2Fyalla-learn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledSaeed18%2Fyalla-learn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledSaeed18%2Fyalla-learn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KhaledSaeed18","download_url":"https://codeload.github.com/KhaledSaeed18/yalla-learn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KhaledSaeed18%2Fyalla-learn/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265555195,"owners_count":23787353,"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":["ai","ai-sdk","axios","framer-motion","frontend","nextjs","pnpm","react-hook-form","reactjs","redux","server-actions","shadcn-ui","tailwindcss","typescript","vercel","zod"],"created_at":"2025-07-17T00:39:09.570Z","updated_at":"2025-10-03T16:09:26.111Z","avatar_url":"https://github.com/KhaledSaeed18.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 Yalla Learn - Complete Learning \u0026 Productivity Platform\n\n\u003cdiv align=\"center\"\u003e\n\n[![Yalla Learn Logo](https://img.shields.io/badge/Yalla%20Learn-Complete%20Platform-blue?style=for-the-badge\u0026logo=education)](https://yalla-learn.me)\n\n[![Next.js](https://img.shields.io/badge/Next.js-15.2.0-black?style=for-the-badge\u0026logo=next.js)](https://nextjs.org/)\n[![React](https://img.shields.io/badge/React-19.0.0-61DAFB?style=for-the-badge\u0026logo=react)](https://reactjs.org/)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6?style=for-the-badge\u0026logo=typescript)](https://www.typescriptlang.org/)\n[![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-4.0-38B2AC?style=for-the-badge\u0026logo=tailwind-css)](https://tailwindcss.com/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\n**A comprehensive learning and productivity platform powered by AI, designed to enhance your educational journey and boost productivity.**\n\n[🌐 Live Demo](https://yalla-learn.me) • [📱 Mobile App](#-related-repositories) • [🖥️ Desktop App](#-related-repositories) • [🔧 Backend API](#-related-repositories)\n\n\u003c/div\u003e\n\n---\n\n## 📋 Table of Contents\n\n- [✨ Features](#-features)\n- [🎯 AI Tools](#-ai-tools)\n- [⚡ Productivity Tools](#-productivity-tools)\n- [🔧 Tech Stack](#-tech-stack)\n- [🚀 Installation](#-installation)\n- [📖 Usage](#-usage)\n- [🔗 Related Repositories](#-related-repositories)\n- [🤝 Contributing](#-contributing)\n- [📄 License](#-license)\n\n---\n\n## ✨ Features\n\n### 🤖 **AI-Powered Learning Tools**\n\n| Feature | Description | Status |\n|---------|-------------|--------|\n| 📄 **PDF AI Chat** | Chat with PDFs - summarize, search and extract information instantly | ✅ |\n| 🖼️ **Image AI Chat** | Upload images and chat with AI to explore, analyze, and understand them | ✅ |\n| 🧠 **Mindmap Creation** | Turn ideas into clear, visual mindmaps in seconds with AI | ✅ |\n| 🃏 **Flashcard Generation** | Generate flashcards from any text or topic for effective learning | ✅ |\n| 📚 **Study Plan Generator** | Create personalized study plans based on subject, timeframe, and goals | ✅ |\n| 📝 **Quiz Generator** | Create interactive quizzes with automatic scoring and explanations | ✅ |\n| 🧩 **Concept Explainer** | Get clear explanations of complex concepts with visual descriptions | ✅ |\n| 🔍 **AI Web Search** | Search the web using AI and get relevant, curated results | ✅ |\n| 🎤 **Voice Assistant** | Have voice conversations with AI for learning support | ✅ |\n\n### ⚡ **Productivity \u0026 Management Tools**\n\n| Feature | Description | Status |\n|---------|-------------|--------|\n| ⏰ **Pomodoro Timer** | Enhanced focus with customizable 25/5 minute timer cycles | ✅ |\n| 🎯 **Focus Mode** | Distraction-free environment for maximum concentration | ✅ |\n| 📄 **Resume Builder** | Professional resume creation with multiple templates | ✅ |\n| 💰 **Expense Tracker** | Personal finance management with charts and analytics | ✅ |\n| 📋 **Kanban Board** | Task management with drag-and-drop functionality | ✅ |\n\n### 💬 **Community \u0026 Content**\n\n| Feature | Description | Status |\n|---------|-------------|--------|\n| ❓ **Q\u0026A Platform** | Ask questions and get answers from the community | ✅ |\n| 📝 **Blog System** | Rich content creation and sharing platform | ✅ |\n| 💼 **Job Portal** | Career opportunities and job listings | ✅ |\n\n---\n\n## 🎯 AI Tools\n\n\u003cdiv align=\"center\"\u003e\n\n### 🤖 Powered by Advanced AI Models\n\n![Google Gemini](https://img.shields.io/badge/Google%20Gemini-AI%20Chat-4285F4?style=for-the-badge\u0026logo=google)\n![OpenAI](https://img.shields.io/badge/OpenAI-GPT--4-412991?style=for-the-badge\u0026logo=openai)\n![Vapi AI](https://img.shields.io/badge/Vapi%20AI-Voice%20Assistant-FF6B6B?style=for-the-badge)\n\n\u003c/div\u003e\n\nOur AI tools are designed to revolutionize your learning experience:\n\n- **📄 PDF AI Chat**: Upload PDFs and have intelligent conversations about the content\n- **🖼️ Image AI Chat**: Analyze images, get descriptions, and ask questions about visual content\n- **🧠 Mindmap Creation**: Transform complex topics into visual mindmaps automatically\n- **🃏 Flashcard Generation**: Create study cards from any topic with AI-generated questions\n- **📚 Study Plan Generator**: Get personalized learning schedules based on your goals\n- **📝 Quiz Generator**: Generate quizzes with explanations for any subject\n- **🧩 Concept Explainer**: Break down complex concepts into understandable explanations\n- **🔍 AI Web Search**: Get curated, relevant search results with AI analysis\n- **🎤 Voice Assistant**: Natural voice conversations for learning support\n\n---\n\n## ⚡ Productivity Tools\n\nBoost your efficiency with our specialized productivity features:\n\n### 🎯 **Focus Enhancement**\n\n- **Pomodoro Timer**: Customizable work/break cycles\n- **Focus Mode**: Distraction-free workspace\n- **Progress Tracking**: Monitor your productivity sessions\n\n### 📊 **Organization Tools**\n\n- **Task Management**: Kanban-style boards with drag-and-drop\n- **Expense Tracking**: Personal finance management with analytics\n- **Resume Builder**: Professional CV creation with multiple templates\n\n---\n\n## 🔧 Tech Stack\n\n\u003cdiv align=\"center\"\u003e\n\n### Frontend\n\n![Next.js](https://img.shields.io/badge/Next.js-15.2.0-000000?style=for-the-badge\u0026logo=next.js)\n![React](https://img.shields.io/badge/React-19.0.0-61DAFB?style=for-the-badge\u0026logo=react)\n![TypeScript](https://img.shields.io/badge/TypeScript-5.0-3178C6?style=for-the-badge\u0026logo=typescript)\n![Tailwind CSS](https://img.shields.io/badge/Tailwind%20CSS-4.0-38B2AC?style=for-the-badge\u0026logo=tailwind-css)\n\n### State Management \u0026 UI\n\n![Redux Toolkit](https://img.shields.io/badge/Redux%20Toolkit-2.6.1-764ABC?style=for-the-badge\u0026logo=redux)\n![React Query](https://img.shields.io/badge/React%20Query-5.69.0-FF4154?style=for-the-badge\u0026logo=react-query)\n![Framer Motion](https://img.shields.io/badge/Framer%20Motion-12.5.0-0055FF?style=for-the-badge\u0026logo=framer)\n![Radix UI](https://img.shields.io/badge/Radix%20UI-Components-161618?style=for-the-badge)\n\n### AI \u0026 APIs\n\n![Google AI](https://img.shields.io/badge/Google%20AI%20SDK-1.2.11-4285F4?style=for-the-badge\u0026logo=google)\n![AI SDK](https://img.shields.io/badge/Vercel%20AI%20SDK-4.3.9-000000?style=for-the-badge)\n![Vapi AI](https://img.shields.io/badge/Vapi%20AI-2.2.6-FF6B6B?style=for-the-badge)\n\n### Development Tools\n\n![ESLint](https://img.shields.io/badge/ESLint-9.0-4B32C3?style=for-the-badge\u0026logo=eslint)\n![Turbopack](https://img.shields.io/badge/Turbopack-Enabled-000000?style=for-the-badge)\n![PNPM](https://img.shields.io/badge/PNPM-Package%20Manager-F69220?style=for-the-badge\u0026logo=pnpm)\n\n\u003c/div\u003e\n\n---\n\n## 🚀 Installation\n\n### 📋 Prerequisites\n\n| Requirement | Version | Download |\n|-------------|---------|----------|\n| **Node.js** | v20+ | [Download](https://nodejs.org/) |\n| **Git** | Latest | [Download](https://git-scm.com/) |\n| **PNPM** | Latest | [Install](https://pnpm.io/installation) |\n\n### 🛠️ Setup Instructions\n\n1. **Clone the repository**\n\n   ```bash\n   git clone https://github.com/KhaledSaeed18/yalla-learn.git\n   cd yalla-learn\n   ```\n\n2. **Install dependencies**\n\n   ```bash\n   pnpm install\n   ```\n\n3. **Environment Setup**\n\n   ```bash\n   # Add your API keys and configuration\n   # Edit .env.local with your actual values\n   ```\n\n4. **Start development server**\n\n   ```bash\n   pnpm dev\n   ```\n\n5. **Open your browser**\n\n   ```\n   http://localhost:3000\n   ```\n\n### 🔑 Environment Variables\n\nCreate a `.env.local` file with the following variables:\n\n```env\nGOOGLE_GENERATIVE_AI_API_KEY=\nNEXT_PUBLIC_HUGGINGFACE_API_KEY=\nNEXT_PUBLIC_AZURE_TRANSLATOR_KEY=\nNEXT_PUBLIC_AZURE_TRANSLATOR_REGION=\nNEXT_PUBLIC_API_URL=\nNEXT_PUBLIC_VAPI_API_KEY=\n```\n\n---\n\n## 📖 Usage\n\n### 🎯 **Getting Started**\n\n1. **Sign up** for a new account or **sign in** if you already have one\n2. **Explore AI Tools** - Start with PDF chat or concept explainer\n3. **Set up productivity** - Configure your Pomodoro timer and create task boards\n4. **Join the community** - Ask questions in Q\u0026A and read blog posts\n5. **Build your profile** - Use the resume builder and track your progress\n\n### 🔧 **Development Commands**\n\n| Command | Description | Usage |\n|---------|-------------|--------|\n| `pnpm dev` | Start development server with Turbopack | Development |\n| `pnpm build` | Build production bundle | Deployment |\n| `pnpm start` | Start production server | Production |\n| `pnpm lint` | Run ESLint for code quality | Code Quality |\n\n---\n\n## 🔗 Related Repositories\n\n\u003cdiv align=\"center\"\u003e\n\n### 🌐 **Complete Yalla Learn Ecosystem**\n\n| Platform | Repository | Description | Technology |\n|----------|------------|-------------|------------|\n| 🌐 **Frontend Web** | [yalla-learn](https://github.com/KhaledSaeed18/yalla-learn) | Main web application (this repo) | Next.js, React, TypeScript |\n| 🔧 **Backend API** | [yalla-learn-backend](https://github.com/KhaledSaeed18/yalla-learn-backend) | RESTful API and database | Node.js, Express, PostgresSQL |\n| 📱 **Mobile App** | [yalla-learn-app](https://github.com/KhaledSaeed18/yalla-learn-app) | iOS \u0026 Android application | React Native, Expo |\n| 🖥️ **Desktop App** | [yalla-learn-desktop](https://github.com/KhaledSaeed18/yalla-learn-desktop) | Cross-platform desktop app | Electron, React |\n\n\u003c/div\u003e\n\n---\n\n## 🌟 Features Showcase\n\n### 📊 **Dashboard Overview**\n\n- **AI Assistant**: Integrated chat for learning support\n- **Progress Tracking**: Monitor your learning journey\n- **Quick Access**: Fast navigation to all tools and features\n- **Personalization**: Customizable workspace and preferences\n\n### 🎨 **User Experience**\n\n- **Responsive Design**: Works perfectly on all devices\n- **Dark/Light Mode**: Theme switching for comfortable viewing\n- **Accessibility**: WCAG compliant for inclusive design\n- **Performance**: Optimized with Next.js and Turbopack\n\n### 🔒 **Security \u0026 Privacy**\n\n- **Secure Authentication**: JWT-based user management\n- **Data Encryption**: Protected user data and conversations\n- **Privacy Controls**: Granular privacy settings\n- **GDPR Compliant**: Respects user data rights\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Here's how you can help:\n\n### 🚀 **How to Contribute**\n\n1. **Fork the repository**\n2. **Create a feature branch** (`git checkout -b feature/amazing-feature`)\n3. **Commit your changes** (`git commit -m 'Add amazing feature'`)\n4. **Push to the branch** (`git push origin feature/amazing-feature`)\n5. **Open a Pull Request**\n\n### 📝 **Contribution Guidelines**\n\n- Follow the existing code style and conventions\n- Write clear commit messages\n- Add tests for new features\n- Update documentation as needed\n- Ensure all tests pass before submitting\n\n---\n\n## 📄 License\n\nThis project is licensed under the **MIT License** - see the [LICENSE](LICENSE) file for details.\n\n\u003cdiv align=\"center\"\u003e\n\n[![GitHub stars](https://img.shields.io/github/stars/KhaledSaeed18/yalla-learn?style=social)](https://github.com/KhaledSaeed18/yalla-learn/stargazers)\n[![GitHub forks](https://img.shields.io/github/forks/KhaledSaeed18/yalla-learn?style=social)](https://github.com/KhaledSaeed18/yalla-learn/network/members)\n\n[🌐 Website](https://yalla-learn.me)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledsaeed18%2Fyalla-learn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhaledsaeed18%2Fyalla-learn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaledsaeed18%2Fyalla-learn/lists"}