🚀 CIT Learning App

A modern, gamified learning platform for CIT students, built with Python and Streamlit. Learn chapter by chapter, test yourself with quizzes, earn XP, level up and keep your daily streak alive.

🔗 Live Demo: cit-learning.streamlit.app

---

✨ Features

• 🔐 User Login System – personal account so your progress is saved
• 📚 Chapter-based Learning – study the material one chapter at a time
• 📝 Quiz System – test your understanding after each chapter
• ⭐ XP & Level System – earn experience points and level up as you learn
• 🔥 Daily Streak Tracking – build a habit by learning every day
• 📊 Progress Dashboard & Graphs – see how far you have come
• 🌙 Modern Dark UI – clean and easy on the eyes

🎯 Purpose

Self-learning plus progress tracking for CIT students. Learning feels more like a game, which keeps you motivated and consistent.

🛠️ Tech Stack

• Python 3
• Streamlit (UI and app framework)

📁 Project Structure

CIT_Learning_App/
├── app.py        # Main Streamlit app (run this file)
├── quiz.py       # Quiz logic
├── data/         # Chapters, questions and app data
├── utils/        # Helper functions
├── .gitignore
└── README.md

⚡ Run Locally

1. Clone the repository

   git clone https://github.com/zyanhub/CIT_Learning_App.git
   cd CIT_Learning_App

2. (Optional) Create a virtual environment

   python -m venv venv
   # Windows
   venv\Scripts\activate
   # macOS / Linux
   source venv/bin/activate

3. Install dependencies

   pip install streamlit

   If the project uses more packages (for example pandas or plotly for graphs), install them with pip install pandas plotly.

4. Start the app

   streamlit run app.py

5. Open the link shown in the terminal (usually http://localhost:8501).

🗺️ Roadmap

• Add more chapters and quiz questions
• Leaderboard for top learners
• Badges and achievements
• Urdu / English language option
• Mobile-friendly layout improvements

🤝 Contributing

Suggestions and improvements are welcome. Fork the repo, create a branch, and open a pull request.

👤 Author

Dev_Hub – @zyanhub

---

⭐ If you like this project, give it a star!