🐍 PyCompanion — Interactive Python Learning App

A fully interactive, browser-based Python learning platform — no installation required.

---

✨ Features

Feature	Description
📦 Course Modules	12 structured modules from Python basics to testing
⌨️ Code Editor	In-browser editor with simulated execution and test cases
🧠 Quiz Arena	10-question quiz with instant feedback and XP rewards
🚀 Project Lab	9 guided projects sorted by difficulty level
🎬 Video Tutorials	Curated YouTube links for every topic
📚 Docs & Resources	Links to official docs, cheatsheets, and practice sites
💬 Community Forum	Ask questions and share solutions with learners
📈 Progress Tracking	XP system, completion rings, weekly activity chart
🏅 Badges	15 achievements to unlock as you learn
🌙 Dark / Light Mode	Full theme toggle with smooth transitions
🔍 Search	Instant search across all modules and topics
📱 Mobile Friendly	Fully responsive with collapsible sidebar

---

🖥️ Preview

Beginner → Intermediate → Advanced
Variables · Loops · Functions · OOP · APIs · Testing

---

🚀 Getting Started

Option A — Use it instantly (no setup)

👉 Open Live App

Option B — Run locally

# Clone the repository
git clone https://github.com/yourusername/pycompanion.git

# Navigate into the folder
cd pycompanion

# Open directly in your browser
open index.html

# OR serve with Python's built-in server
python3 -m http.server 8000
# Then visit http://localhost:8000

---

📁 Project Structure

pycompanion/
├── index.html        # Entire app — single self-contained file
├── README.md         # You're reading this
└── screenshot.png    # Preview image (optional)

Note: PyCompanion is intentionally a single HTML file with zero dependencies. No npm, no build step, no frameworks — just open and run.

---

📚 Curriculum Overview

🟢 Beginner

• Python Basics — variables, types, operators
• Control Flow — if/elif/else
• Loops — for, while, range()

🟡 Intermediate

• Functions — def, scope, *args, **kwargs
• Data Structures — lists, dicts, sets, tuples
• List Comprehensions
• File I/O
• Error Handling

🔴 Advanced

• Object-Oriented Programming
• Modules & Packages
• APIs & Requests
• Testing with pytest

---

🛠️ Tech Stack

• Pure HTML5 / CSS3 / Vanilla JavaScript — zero dependencies
• Google Fonts — Fira Code + DM Sans
• No build tools — works offline after first load

---

🤝 Contributing

Contributions are welcome! Here's how:

# 1. Fork this repository
# 2. Create a feature branch
git checkout -b feature/add-new-module

# 3. Make your changes to index.html
# 4. Commit with a clear message
git commit -m "Add: Decorators module content"

# 5. Push and open a Pull Request
git push origin feature/add-new-module

Ideas for contributions:

• Add new quiz questions
• Write new coding exercises
• Add more project ideas
• Improve mobile layout
• Add more resource links

---

📝 License

MIT License — free to use, modify, and distribute. See LICENSE for details.

---

🙏 Acknowledgements

• Python.org — Official documentation
• freeCodeCamp — Inspiration and video content
• Corey Schafer — Python tutorial videos
• Real Python — Resource links

---

Made with ❤️ for Python learners everywhere
⭐ Star this repo if it helped you!