AIUB PortalX 🚀

A modern Chrome extension assistant designed to streamline the student experience on the AIUB Portal.

---

Repository: ABiR994/AIUB-PortalX

---

✨ Features

• Smart Routine & Holiday Alerts
  A personalized dashboard that greets you based on the time of day and provides pulsing alerts for university holidays, helping you plan your week at a glance.

• Advanced Course Advisor
  Plan your degree with a three-tier system: Suggested, Enrolled, and Finished. Now features multi-program support (CSE/EEE) and intelligent detection for Recommended Retakes.

• Experimental Auto-Login Engine (Beta)
  Note: This feature is currently in active development and may be unstable.

  • Intelligent OCR Race Mode: Simultaneously races a local CV engine against Cloud Inference for maximum potential accuracy.
  • Fail-Safe Architecture: Designed with a "Zero-Loop" mechanism to prevent infinite retry cycles if login fails.
  • Structural Analysis: Uses region sampling to attempt CAPTCHA resolution, though manual intervention may still be required.

---

📂 Project Structure

AIUB-PortalX/
├── public/                # Static assets (icons, tesseract, wasm)
├── src/                   # Source code
│   ├── assets/            # Global styles
│   ├── background/        # Background service worker
│   ├── components/        # React UI components
│   ├── content-scripts/   # Auto-login & content injection
│   ├── services/          # Core logic (Portal, OCR, Solver)
│   ├── store/             # Zustand state management
│   ├── types/             # Type definitions
│   ├── App.tsx            # Main app component
│   └── main.tsx           # Entry point
├── .gitignore
├── index.html
├── LICENSE
├── manifest.json
├── package.json
├── postcss.config.cjs
├── tailwind.config.cjs
├── tsconfig.json
└── vite.config.ts

---

🚀 Tech Stack

Layer	Technology
Framework	React 19 + Vite
Logic	TypeScript
Styling	Tailwind CSS v4
State	Zustand (Persistent)
OCR Engine	Tesseract.js (Local Workers)
Cloud Solver	Hugging Face Inference API
Build Tool	CRXJS Vite Plugin

---

🛠️ Installation & Setup

📥 For Regular Users (Recommended)

1. Download the Extension: Go to the Releases page and download the AIUB-PortalX.zip from the latest version.
2. Unzip the File: Extract the downloaded .zip file to a folder on your computer.
3. Open Chrome Extensions: In your browser, go to chrome://extensions/.
4. Enable Developer Mode: Toggle the switch in the top-right corner.
5. Load the Extension: Click Load unpacked and select the folder you just unzipped.

💻 For Developers

1. Clone the repository:

   git clone https://github.com/ABiR994/AIUB-PortalX.git
   cd AIUB-PortalX

2. Install dependencies:

   npm install

3. Development Mode: Launch with Hot Module Replacement (HMR):

   npm run dev

4. Production Build: Generate an optimized, minified bundle:

   npm run build

5. Load the Extension:

   • Open Chrome and navigate to chrome://extensions/.
   • Enable Developer Mode.
   • Click Load unpacked and select the dist folder.

---

🏗️ Architecture

PortalX is built with a modern, reactive architecture for long-term maintainability:

• AppStore: A unified Zustand store managing global state and Chrome Storage persistence.
• PortalService: A robust DOM-scraping layer designed to extract clean data from the complex portal structure.
• Gatekeeper: A specialized content-script engine that handles OCR race conditions and image validation.
• UI Components: Modular React components styled with Tailwind for conflict-free isolation.

---

🤝 Credits

This project is a standalone evolution (v3) of the original AIUB_Portal_helper by sajedulsakib001.

---

🤖 Built With

Architected and developed using Antigravity and OpenCode, leveraging advanced agentic coding workflows to ensure clean code, efficient logic, and a refined user experience.

---

📜 License

Distributed under the MIT License. See LICENSE for the full text.

---

⚡ Automate. Organize. Excel. Master the Portal.