CodeMirrorX

CodeMirrorX is a modern, beginner-friendly desktop app for learning Python interactively. It lets you view example code, write your own code, and see the output instantly—all in a clean, easy-to-use interface.

---

Features

• Side-by-side example and user code panels
• Run Python code and see output instantly
• Organized by topics (variables, loops, functions, classes, etc.)
• Designed for beginners and educators
• Clean, minimal, and professional UI
• Ongoing project: new features and examples will be added regularly

---

Dependencies

Main Python packages (see requirements.txt for full list):

• Flask
• Eel

Install all dependencies with:

pip install -r requirements.txt

---

Testing

To run backend and frontend tests:

python test_backend.py
python test_flask.py
# For frontend HTML tests, open test_simple.html in your browser

---

References & Resources

See REFERENCES.md for a curated list of Python, Flask, Eel, and web development resources.

---

Development Workflow

• This project is updated frequently. Please use branches for new features or fixes.
• Pull requests and issues are welcome!
• See the docs/ folder for future documentation and guides.

---

---

Project Structure

CodeMirrorX/
  src/         # Main app code (HTML, JS, CSS)
  examples/    # Example Python code snippets
  assets/      # Images, icons, and other assets
  docs/        # Documentation and extra info
  backend/     # Python backend (Flask + Eel)

---

How to Run

1. Install Python 3.8+
2. Install dependencies:

   pip install -r requirements.txt
   

3. Run the app:

   python run_app.py
   

4. The app will open in its own window. You can also create a desktop shortcut to run_app.py for easy access.

---

Contributing

• Contributions are welcome! Please open issues or pull requests for new features, bug fixes, or improvements.
• All code should be clean, well-documented, and beginner-friendly.
• See CONTRIBUTING.md for guidelines.

---

---

License

MIT License

---

---

About

CodeMirrorX is an ongoing project to help anyone learn Python in a fun, interactive, and professional way. Built with ❤️ by Stilian and contributors.

---

Professional Notes

• This repository is intended for ongoing development and frequent updates.
• Please feel free to fork, clone, and contribute.
• All contributions are reviewed for clarity, code quality, and educational value.

---