MPC Extension - Study Planning Tool

📌 What is MPC Extension?

MPC Extension is a free, open-source browser extension specifically designed to help students of Ho Chi Minh City Open University manage their studies more effectively.

It acts as a tool in your browser - supporting the management of grades, schedules, fees, and all important student information in a friendly, easy-to-use interface.

✨ Key Features

📊 Centralized Dashboard

• View all academic information in one place
• Real-time updates, never miss information

🎯 Grade & GPA Management

• Automatic GPA calculation according to HCMCOU criteria
• Track failed courses, academic classification
• Forecast required scores

📅 Class & Exam Schedule

• View detailed weekly class schedules
• Automatic reminders for exam schedules
• Export schedule to calendar

💰 Financial Tracking

• Monitor tuition fees
• View scholarships and financial aid
• Payment deadline notifications

👤 Student Information

• Securely store personal records
• Manage documents and certificates
• Flexibly update information

🚀 Quick Installation

Method 1: Chrome Web Store (Recommended) ⭐

1. Visit: MPC Extension on Chrome Web Store
2. Click "Add to Chrome"
3. Confirm access permissions
4. ✅ Done! Extension is ready to use

Method 2: Firefox Add-ons

1. Download from GitHub Releases
2. Select the Firefox version
3. Install into Firefox
4. ✅ Use immediately

Method 3: Install from Source (For Developers)

1git clone https://github.com/mpc-ou/mpc-extension.git
2cd mpc-extension
3pnpm install
4pnpm build          # Chrome
5pnpm build:firefox  # Firefox

Then load the .output folder into the browser

🔐 Security & Privacy - 100% Commitment

Evidence:

• Source code is completely public on GitHub
• Anyone can review and audit the code
• GPLv3 license - requires source code disclosure
• No backend server - no centralized data storage

🛠️ Technology Behind

MPC Extension is built with the most modern technology:

1Frontend Stack:
2├─ React 19.2 (UI library)
3├─ TypeScript (Code safe)
4├─ Tailwind CSS (Responsive design)
5└─ Shadcn UI (Beautiful components)
6 
7Browser Support:
8├─ Chrome ✅
9├─ Firefox ✅
10├─ Edge ✅
11└─ Brave ✅
12 
13Developer Tools:
14├─ WXT (Web Extension Framework)
15├─ Zustand (State management)
16├─ Recharts (Data visualization)
17├─ pnpm (Package manager)
18├─ Biome (Linting & formatting)
19└─ Semantic Release (Auto versioning)
20 
21Security:
22├─ Local storage encryption
23├─ No external API calls
24├─ TypeScript type safety
25└─ Open source audit trail

🤝 Contribution & Open Source

Benefits of Open Source:

100% Transparency

• Every line of code is public
• Nothing hidden, no malware

Safe & Trustworthy

• Community code monitoring
• Security audit by many people

Customizable

• Fork & modify as needed
• Create your own version

Long-term Development

• No sudden support discontinuation
• Community continues development

How to Contribute?

📋 Report Bugs:

11. Visit GitHub Issues
22. Check if already reported
33. Create a new issue with:
4   - Clear title
5   - Detailed bug description
6   - Reproduction steps
7   - Screenshot if available

✨ Suggest Features:

11. Create a new issue
22. Describe:
3   - Problem you want to solve
4   - Proposed solution
5   - Feature benefits

🔧 Code & Fix Bugs:

11. Fork repository
22. git clone https://github.com/YOUR_USERNAME/mpc-extension.git
33. git checkout -b fix/bug-name
44. Fix code & test
55. git commit -m "fix: describe your fix"
66. git push & create Pull Request

📖 Improve Documentation:

1- Translate UI to other languages
2- Write detailed guides
3- Create video tutorials

Standard Process:

1# Setup
2git clone https://github.com/mpc-ou/mpc-extension.git
3cd mpc-extension
4pnpm install
5pnpm dev
6 
7# Commit according to Conventional Commits
8git commit -m "feat: new feature"   # New feature
9git commit -m "fix: bug fix"        # Bug fix
10git commit -m "docs: update docs"   # Update docs
11git commit -m "style: format code"  # Format code
12 
13# Quality checks
14pnpm lint:check

📲 Contact & Support

1🐙 GitHub: https://github.com/mpc-ou/mpc-extension
2💬 Issues: https://github.com/mpc-ou/mpc-extension/issues
3📖 Docs: See README or CONTRIBUTING.md
4👤 Facebook: @mpc (Programming Club)

📜 License

GNU General Public License v3 (GPLv3)