Skip to content

Latest commit

ย 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš€ Learno-X

Learn Smarter. Build Faster.

An AI-powered personalized learning platform that generates adaptive learning roadmaps, curates the best educational resources, tracks learning progress, and gamifies the learning experience.


React Node.js Express MongoDB Groq YouTube API


๐Ÿ“– Overview

Learno-X is an AI-powered learning platform designed to help learners master any technical topic through structured roadmaps, curated educational resources, official documentation, progress tracking, and gamified learning.

Unlike traditional learning platforms, Learno-X does not simply search YouTube.

It acts as an AI learning companion that helps users:

  • Discover the best resources
  • Follow personalized learning paths
  • Track progress
  • Stay motivated through XP, levels, streaks, and achievements

๐ŸŒ Live Demo

Service Link
๐Ÿš€ Live Website https://learno-x-client-ten.vercel.app/
โš™๏ธ Backend API https://learno-x-api.onrender.com/api/health

โœจ Features

๐Ÿค– AI Learning Engine

  • AI-generated personalized roadmaps
  • AI Query Optimizer
  • Smart topic understanding
  • Intelligent resource recommendations

๐Ÿ“š Smart Learning Resources

  • YouTube Data API Integration
  • Official Documentation
  • Learning Roadmaps
  • Coding Exercises
  • Interview Questions
  • Practice Resources

โญ Learno Score

Every learning resource receives an AI-generated quality score based on

  • Teaching Quality
  • Course Completeness
  • Beginner Friendliness
  • Trusted Instructor
  • Community Reputation
  • Freshness

๐ŸŽฎ Gamification

  • XP System
  • Level System
  • Achievements
  • Daily Goals
  • Learning Streaks
  • Progress Tracking
  • Continue Learning

๐Ÿ“Š Dashboard

Track

  • Learning Progress
  • Current Roadmap
  • XP
  • Level
  • Achievements
  • Learning Statistics
  • Recent Activity
  • Today's Mission

๐Ÿง  AI Mentor

Interactive AI assistant that helps learners

  • Understand difficult concepts
  • Explain errors
  • Recommend next lessons
  • Guide the learning journey

๐ŸŽจ Modern UI

Inspired by

  • Linear
  • Perplexity AI
  • Notion
  • ChatGPT
  • roadmap.sh

Built using

  • Tailwind CSS
  • Framer Motion
  • Responsive Design
  • Dark Mode

๐Ÿ›  Tech Stack

Frontend

  • React
  • React Router
  • Tailwind CSS
  • Framer Motion
  • Lucide React

Backend

  • Node.js
  • Express.js

Database

  • MongoDB

AI

  • Groq API
  • OpenRouter (Planned)

APIs

  • YouTube Data API v3

๐Ÿš€ Project Evolution

Version 1

โœ… MVP

  • Basic Search
  • Authentication
  • Roadmap Generation

Version 2

โœ… Functional Platform

  • MongoDB
  • Provider Architecture
  • Dashboard
  • Groq Integration

Version 3

โœ… Smart Learning Platform

  • AI Query Optimizer
  • Learno Score
  • Better Roadmaps
  • Persistent Progress
  • Better Dashboard

Version 4

โœ… Product Polish

  • Dynamic Learning Paths
  • XP & Levels
  • Achievements
  • Continue Learning
  • Today's Mission
  • AI Mentor
  • Improved Dashboard
  • Premium UI
  • Search Persistence

๐ŸŽฏ Future Roadmap

  • AI Adaptive Roadmaps
  • Certificates
  • Coding Playground
  • Weekly Reports
  • AI Mock Interviews
  • Mobile Application
  • Admin Dashboard
  • Study Groups
  • Real-time Collaboration

๐Ÿš€ Deployment

Option A โ€” Docker Compose (recommended for self-host)

A single command builds and starts MongoDB, the API server, and (via the server) the pre-built client:

cp .env.example .env      # fill in JWT_SECRET, MONGO_URI, etc.
docker compose up --build -d

The API and UI are served from http://localhost:5000 (single origin, no CORS), serving the admin panel from the same server.

The admin account is NOT created automatically. Provision it with:

docker compose exec api node seedAdmin.js

(set ADMIN_EMAIL / ADMIN_PASSWORD (โ‰ฅ12 chars) in .env first).

Option B โ€” Deploy platforms (Railway / Render / Fly)

  1. Deploy the server (cd server && npm start). Set these environment variables: MONGO_URI, JWT_SECRET, CORS_ORIGIN, APP_URL, plus at least one AI key (GROQ_API_KEY) for AI-optimized features (optional).
  2. Deploy the client as a static site (cd client && npm run build). Create client/.env with VITE_API_URL=https://<your-api>/api, then build.

Environment variables

Variable Required Description
MONGO_URI โœ… MongoDB connection string
JWT_SECRET โœ… Long random secret for JWT signing
CORS_ORIGIN โœ… Allowed frontend origin(s), comma-separated
GROQ_API_KEY optional Enables AI query optimizer + AI mentor
OPENROUTER_API_KEY optional Alternate AI provider
YOUTUBE_API_KEY optional YouTube Data API v3 (enriches search results)

Contributions are currently closed while Learno-X is under active development.

If you'd like to discuss ideas or collaborate, please reach out through LinkedIn or email.


๐Ÿ“œ License

Copyright ยฉ 2026 Pratham Pai

All Rights Reserved.

This project is published for portfolio and evaluation purposes only.

Viewing the source code does NOT grant permission to copy, modify, redistribute, or commercially use any part of this project without prior written permission.

See the LICENSE file for details.


๐Ÿ‘จโ€๐Ÿ’ป Developer

Pratham Pai

Computer Science & Design

Canara Engineering College


Connect with me

GitHub

https://github.com/Pratham0667

LinkedIn

https://www.linkedin.com/in/pai-pratham/

Email

prathampai0667@gmail.com


โญ If you like this project, consider giving it a star!

Learno-X โ€” Learn Smarter. Build Faster. ๐Ÿš€

About

An AI-powered personalized learning platform that generates adaptive roadmaps, curates educational resources, tracks progress, and gamifies learning.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages