Unfugly Ecosystem

Radically simplifying the SRM Academia portal experience with a beautiful, fast, and feature-rich unified platform.

The Unfugly ecosystem is split into three primary components that work in tandem to capture, process, and display academic information for SRM students:

1. Chrome Extension: Injects directly into the SRM Academia page to redesign the interface, capture data, fast-track faculty feedback, and sync details to the cloud.
2. Next.js Webapp: A premium, dark-mode dashboard providing cross-device access to timetables, attendance analytics, internal marks, and calendars.
3. Express Backend (unfugly-backend): A secure Node.js/Express API that manages cookie state propagation, captcha solving, background scraping, and Supabase database interactions.

---

🛠️ Architecture Overview

graph TD
    A[SRM Academia Portal] -->|Scrapes / Syncs Cookie| B(Unfugly Extension)
    B -->|POST /api/v1/user/save| C(Express Backend)
    C -->|Reads / Writes| D[(Supabase Database)]
    E[Next.js Webapp] -->|GET /api/v1/user/data| C
    E -->|PUT /api/v1/user/slots| C

Loading

📂 Project Structure

Unfugly/
├── extension/          # Chrome extension source files (JS, CSS, assets)
├── webapp/             # Next.js webapp frontend
├── unfugly-backend/    # Express API backend & Puppeteer scraper
├── flow.md             # Detailed data sync guidelines
└── README.md           # This file

---

🚀 Setup & Development

Refer to the service-specific documentation to get started with individual components:

• 📖 Extension Setup
• 📖 Webapp Setup
• 📖 Backend Setup

🛡️ Workspace Rules

AI agents working in this repository must follow the instructions configured in .agents/AGENTS.md.