{"id":35313466,"url":"https://github.com/theajmalrazaq/superflex","last_synced_at":"2026-04-02T01:02:31.128Z","repository":{"id":287021359,"uuid":"963301673","full_name":"theajmalrazaq/superflex","owner":"theajmalrazaq","description":"Flex Portal Sucks? Not Anymore. Time to Flex on 'Em 😎💻","archived":false,"fork":false,"pushed_at":"2026-02-18T18:48:38.000Z","size":43037,"stargazers_count":32,"open_issues_count":3,"forks_count":3,"subscribers_count":2,"default_branch":"master","last_synced_at":"2026-02-18T21:41:21.049Z","etag":null,"topics":["fastnucesproject","flex"],"latest_commit_sha":null,"homepage":"https://theajmalrazaq.github.io/superflex/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/theajmalrazaq.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-04-09T13:22:34.000Z","updated_at":"2026-02-18T18:48:42.000Z","dependencies_parsed_at":"2025-09-29T16:34:24.104Z","dependency_job_id":"da575687-c23f-4e69-b484-6280230eb2ab","html_url":"https://github.com/theajmalrazaq/superflex","commit_stats":null,"previous_names":["ajmalrazaqbhatti/superflex","theajmalrazaq/superflex"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/theajmalrazaq/superflex","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theajmalrazaq%2Fsuperflex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theajmalrazaq%2Fsuperflex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theajmalrazaq%2Fsuperflex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theajmalrazaq%2Fsuperflex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/theajmalrazaq","download_url":"https://codeload.github.com/theajmalrazaq/superflex/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/theajmalrazaq%2Fsuperflex/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31293631,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-01T21:15:39.731Z","status":"ssl_error","status_checked_at":"2026-04-01T21:15:34.046Z","response_time":53,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["fastnucesproject","flex"],"created_at":"2025-12-30T18:05:48.208Z","updated_at":"2026-04-02T01:02:31.107Z","avatar_url":"https://github.com/theajmalrazaq.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"public/assets/logo.svg\" alt=\"SuperFlex Logo\" width=\"300\" /\u003e\n  \u003cp\u003eA modern interface enhancement extension for university learning management systems\u003c/p\u003e\n  \n\u003cp\u003e\n  \u003ca href=\"https://github.com/theajmalrazaq/superflex/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/theajmalrazaq/superflex/total?style=for-the-badge\u0026color=a098ff\" alt=\"GitHub all downloads\"\u003e\n  \u003c/a\u003e\n  \n  \u003ca href=\"https://github.com/theajmalrazaq/superflex\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/stars/theajmalrazaq/superflex?style=for-the-badge\u0026color=a098ff\" alt=\"GitHub stars\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/theajmalrazaq/superflex/issues\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/issues-raw/theajmalrazaq/superflex?style=for-the-badge\u0026color=a098ff\" alt=\"GitHub issues\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://github.com/theajmalrazaq/superflex/blob/master/LICENSE\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/license-MIT-a098ff?style=for-the-badge\" alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n  \u003cp\u003e\n    \u003ca href=\"https://theajmalrazaq.github.io/superflex\"\u003eWebsite\u003c/a\u003e •\n    \u003ca href=\"#features\"\u003eFeatures\u003c/a\u003e •\n    \u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e •\n    \u003ca href=\"#development\"\u003eDevelopment\u003c/a\u003e •\n    \u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\n  \u003c/p\u003e\n\u003c/div\u003e\n\n## Overview\n\nSuperFlex is the ultimate glow-up for that crusty university Flex portal at NUCES that was giving major 2005 vibes. It's literally a browser extension that said \"challenge accepted\" and transformed the ancient interface into this sleek, dark-mode masterpiece. It's not just a pretty face though - we've added so many features that your productivity is about to be _chef's kiss_ 🔥\n\nThis bad boy works by sneaking React components into the boring old LMS pages, basically performing plastic surgery on the UI. No cap, it's the ultimate uni life hack that the administration wasn't ready for. Flex portal? More like FLEX on your classmates with this aesthetic upgrade! 😎\n\n## Features\n\n### 🤖 AI-Powered Academic Assistant\n\n- **Multi-Model Support**: Chat with multiple AI models including:\n  - Google Gemini 2.0 Flash \u0026 Gemini 3 Pro/Flash\n  - OpenAI GPT-4o Mini\n  - Anthropic Claude Haiku\n  - xAI Grok 2\n  - And more cutting-edge models\n- **Context-Aware Responses**: AI understands your academic data (CGPA, attendance, marks, study plan)\n- **Intelligent Predictions**: Get grade forecasts, attendance warnings, and study recommendations\n- **Auto Data Sync**: Automatically fetches and syncs your academic records for AI context\n- **Persistent Chat History**: Your conversations are saved across sessions\n\n### 🎨 Modern UI/UX\n\n- **Glassmorphic Dark Mode**: Stunning dark theme with frosted glass effects\n- **Google Sans Flex Typography**: Professional and highly readable custom font\n- **Flat Design**: Modern minimalist aesthetic with no shadow bloat\n- **Smooth Animations**: Buttery transitions and micro-interactions\n- **Responsive Layout**: Optimized for all screen sizes\n- **Custom Loading States**: Beautiful animated loading overlays with splash branding\n- **AI Data Visualization**: Interactive status cards within the AI assistant\n\n### 📊 Enhanced Dashboards\n\n- **Attendance Visualization**:\n  - Color-coded progress bars (green/yellow/red based on percentage)\n  - Real-time attendance tracking with warnings\n  - Detailed course-wise breakdown\n  - Bookmark important courses\n- **Advanced Grade Calculator**:\n  - What-if scenario planning\n  - Target CGPA calculator\n  - Best-of score calculations\n  - Grade scheme visualization\n  - Real-time GPA updates\n- **CGPA Tracking**: Monitor semester and cumulative GPA trends\n- **Financial Dashboard**: Clear fee breakdown and transaction history\n\n### 🛠️ Improved Functionality\n\n- **Smart Tables**:\n  - Sortable columns\n  - Filterable data\n  - Responsive design\n  - Export capabilities\n- **Interactive Accordions**: Collapsible sections for better content organization\n- **Custom Navigation**: Streamlined sidebar with quick access to all features\n- **Bookmark System**: Mark and quick-access important courses\n- **Real-time Calculations**: Instant grade and attendance calculations\n- **Data Persistence**: LocalStorage integration for settings and preferences\n\n### 📈 Analytics Integration\n\n- **Umami Analytics**: Privacy-focused usage tracking\n- **Performance Monitoring**: Track extension performance and user engagement\n- **No Personal Data Collection**: Analytics only track usage patterns, not personal information\n\n## Supported Pages\n\nSuperFlex enhances the following university LMS pages:\n\n- **Home Page**: Dashboard with key student information\n- **Transcript Page**: Academic records with GPA calculator\n- **Marks Page**: Course marks with performance visualization\n- **Attendance Page**: Attendance tracking with statistics\n- **Study Plan Page**: Curriculum planning with modern interface\n- **Course Feedback Page**: Improved feedback submission forms\n- **Grade Change Page**: Streamlined grade appeal process\n- **Fee Details Page**: Clearer financial information display\n- **Retake Exam Page**: Simplified exam registration process\n\n## Installation\n\n### Desktop (Chrome/Chromium Browsers)\n\n1. Install directly from the [Chrome Web Store](https://chromewebstore.google.com/detail/superflex/gipkdnbjfhjenfgehofkimpffdbkgppd?authuser=0\u0026hl=en)\n2. SuperFlex will now be active when you visit your university LMS\n\n#### Manual Installation (Alternative)\n\n1. Download the latest release from the [GitHub Releases page](https://github.com/theajmalrazaq/superflex/releases)\n2. Unzip the downloaded file\n3. Open Chrome and go to `chrome://extensions/`\n4. Enable \"Developer Mode\" in the top right\n5. Click \"Load Unpacked\" and select the unzipped folder\n6. SuperFlex will now be active when you visit your university LMS\n\n### Mobile (Android)\n\nSuperFlex works on mobile devices using **Quetta Browser** - a Chromium-based browser with extension support:\n\n1. Download **Quetta Browser** from the Play Store or visit [quetta.net](https://www.quetta.net/features/extensions)\n2. Install SuperFlex from the [Chrome Web Store](https://chromewebstore.google.com/detail/superflex/gipkdnbjfhjenfgehofkimpffdbkgppd?authuser=0\u0026hl=en) or download the latest release from [GitHub Releases](https://github.com/theajmalrazaq/superflex/releases)\n3. If downloading from GitHub, extract the downloaded file to your device\n4. Open Quetta Browser and navigate to the extensions page\n5. Enable \"Developer Mode\"\n6. Load the unpacked SuperFlex extension folder (if not using Chrome Web Store)\n7. Enjoy SuperFlex on your mobile device! 📱\n\n## Development\n\nSuperFlex is built with modern web technologies:\n\n- **React**: Component-based UI library\n- **Vite**: Fast build tooling\n- **Tailwind CSS**: Utility-first CSS framework\n- **CRXJS**: Chrome extension development tools\n\n### Prerequisites\n\n- Node.js (v16+)\n- npm or yarn\n- Chrome browser\n\n### Setup Development Environment\n\n1. Clone the repository:\n\n```bash\ngit clone https://github.com/theajmalrazaq/superflex.git\ncd superflex\n```\n\n2. Install dependencies:\n\n```bash\nnpm install\n# or\nyarn\n```\n\n3. Start the development server:\n\n```bash\nnpm run dev\n# or\nyarn dev\n```\n\n4. Load the extension in Chrome:\n   - Go to `chrome://extensions/`\n   - Enable \"Developer Mode\"\n   - Click \"Load Unpacked\"\n   - Select the `dist` folder from your project directory\n\n5. The extension will automatically reload when you make changes\n\n### Project Structure\n\n```\nsuperflex/\n├── docs\n│   ├── articles\n│   │   ├── bts.md\n│   │   └── superflexai.md\n│   ├── docs.html\n│   ├── index.html\n│   ├── res\n│   │   ├── bg.png\n│   │   ├── bts.png\n│   │   ├── favicon.svg\n│   │   ├── intro.svg\n│   │   ├── logo_sec.svg\n│   │   ├── logo.svg\n│   │   └── prompt.png\n│   ├── reviews.json\n│   └── video.mp4\n├── eslint.config.js\n├── LICENSE\n├── manifest.json\n├── package.json\n├── pnpm-lock.yaml\n├── postcss.config.mjs\n├── public\n│   ├── assets\n│   │   ├── bg.png\n│   │   ├── favicon.png\n│   │   ├── favicon.svg\n│   │   ├── logo_sec.svg\n│   │   ├── logo.svg\n│   │\n│   ├── reviews.json\n│   └── scripts\n│       ├── bridge.js\n│       ├── polyfill.js\n│       ├── puter.js\n│       ├── rustls.js\n│       └── umami.js\n├── README.md\n├── scripts\n│   └── clean.js\n├── src\n│   ├── components\n│   │   ├── layouts\n│   │   │   └── PageLayout.jsx\n│   │   ├── LoginPageStyles.jsx\n│   │   ├── NavBar.jsx\n│   │   ├── PathRouter.jsx\n│   │   ├── SuperFlexAI.jsx\n│   │   └── ui\n│   │       ├── LoadingOverlay.jsx\n│   │       ├── NotificationBanner.jsx\n│   │       ├── PageHeader.jsx\n│   │       ├── ReviewCarousel.jsx\n│   │       ├── Skeleton.jsx\n│   │       ├── StatsCard.jsx\n│   │       └── SuperTabs.jsx\n│   ├── constants\n│   │   └── mcaData.js\n│   ├── content.jsx\n│   ├── hooks\n│   │   └── useAiSync.js\n│   ├── pages\n│   │   ├── AttendancePage.jsx\n│   │   ├── ChangePasswordPage.jsx\n│   │   ├── CourseFeedbackPage.jsx\n│   │   ├── CourseRegistrationPage.jsx\n│   │   ├── CourseWithdrawPage.jsx\n│   │   ├── FeeChallanPage.jsx\n│   │   ├── FeeDetailsPage.jsx\n│   │   ├── GradeChangePage.jsx\n│   │   ├── HomePage.jsx\n│   │   ├── MarksPage.jsx\n│   │   ├── MarksPloReportPage.jsx\n│   │   ├── NotFoundPage.jsx\n│   │   ├── RetakeExamPage.jsx\n│   │   ├── SessionExpirePage.jsx\n│   │   ├── StudyPlanPage.jsx\n│   │   └── TranscriptPage.jsx\n│   ├── styles\n│   │   ├── loading.css\n│   │   └── tailwind.css\n│   └── utils\n│       └── marksProcessor.js\n└── vite.config.js\n\n17 directories, 68 files\n```\n\n## Building for Production\n\nTo create a production build:\n\n```bash\nnpm run build\n# or\nyarn build\n```\n\nThe production build will be available in the `dist` folder, ready to be published or loaded as an unpacked extension.\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the repository\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\nPlease make sure your code follows the project's coding style and includes appropriate tests.\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## Acknowledgements\n\n- The university community for providing feedback and feature suggestions\n- All contributors who have helped improve SuperFlex\n- [Lucide Icons](https://lucide.dev/) for beautiful UI icons\n\n## Contact\n\nAjmal Razaq Bhatti - [@theajmalrazaq](https://github.com/theajmalrazaq)\n\nProject Link: [https://github.com/theajmalrazaq/superflex](https://github.com/theajmalrazaq/superflex)\n\n## Disclaimer\n\nSuperFlex is an independent project that redesigns the Flex portal of NUCES university. This extension is not affiliated with, endorsed by, or sponsored by NUCES university.\n\nThis is my personal project intended to enhance my learning experience. I did not hack anything or intend to do so. SuperFlex merely applies cosmetic changes to the user interface without compromising any security measures or accessing unauthorized data. This project should not warrant any academic warnings or disciplinary actions as it respects the system's integrity and security.\n\nUsers are using this extension at their own consent and responsibility. The creator of SuperFlex is not responsible for any issues that may arise from using this extension, including but not limited to academic discrepancies, data inaccuracies, or system incompatibilities.\n\nBy installing SuperFlex, you acknowledge that you are using a third-party modification to the university's official system and do so at your own risk.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheajmalrazaq%2Fsuperflex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftheajmalrazaq%2Fsuperflex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftheajmalrazaq%2Fsuperflex/lists"}