Flutter Mentor 🧠

A quiet, intelligent Flutter mentor that lives inside your VS Code. It observes your code, learns your patterns, and provides gentle guidance when it matters.

Features

• 🔍 Automatic Code Review: Reviews your Dart/Flutter files on save
• 📊 Pattern Detection: Tracks recurring issues like:
  • Business logic in UI widgets
  • Excessive setState calls
  • Missing const keywords
  • Deep widget nesting
  • Async operations in build methods
  • Missing dispose for controllers
• 🎓 Developer Levels: Adapts responses for beginner, intermediate, and advanced developers
• 🤔 Socratic Mode: Asks questions to help you think deeper (optional)
• 📈 Statistics Dashboard: Track your progress and growth areas
• 🌍 Bilingual Responses: Arabic + English technical terms

Requirements

• VS Code 1.85.0+
• Mentor Server running locally (see below)

Setup

1. Start the Mentor Server

cd mentor-server
npm install
npm start
# 🍃 Mentor Server listening on ws://localhost:3030

2. Install the Extension

cd extension
npm install
npm run compile
npm run package
# Install the generated .vsix file

Or press F5 in VS Code to run in development mode.

Commands

Settings

Philosophy

This mentor is designed to be:

• Quiet: Only speaks when useful
• Respectful: Never shames or mocks
• Supportive: Offers help, doesn't force it
• Patient: Remembers your struggles
• Educational: Helps you grow, not just fix

License

MIT