{"id":41879598,"url":"https://github.com/brittytino/psgmx-flutter","last_synced_at":"2026-02-08T07:28:27.897Z","repository":{"id":333870701,"uuid":"923035576","full_name":"brittytino/psgmx-flutter","owner":"brittytino","description":"High-performance placement portal featuring role-based access control, PostgreSQL real-time sync, and automated analytics. Powered by Flutter, Supabase, and Dart.","archived":false,"fork":false,"pushed_at":"2026-01-28T18:00:24.000Z","size":26963,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2026-01-29T06:35:01.376Z","etag":null,"topics":["dart","flutter","postgresql","psg-tech","realtime-database","role-based-access-control","supabase"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/brittytino.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"SECURITY.md","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},"funding":null},"created_at":"2025-01-27T14:35:21.000Z","updated_at":"2026-01-28T18:00:34.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/brittytino/psgmx-flutter","commit_stats":null,"previous_names":["brittytino/psgmx-flutter"],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/brittytino/psgmx-flutter","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittytino%2Fpsgmx-flutter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittytino%2Fpsgmx-flutter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittytino%2Fpsgmx-flutter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittytino%2Fpsgmx-flutter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brittytino","download_url":"https://codeload.github.com/brittytino/psgmx-flutter/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brittytino%2Fpsgmx-flutter/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28950299,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T18:30:42.805Z","status":"ssl_error","status_checked_at":"2026-01-31T18:30:19.593Z","response_time":128,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: 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":["dart","flutter","postgresql","psg-tech","realtime-database","role-based-access-control","supabase"],"created_at":"2026-01-25T13:02:18.664Z","updated_at":"2026-01-31T19:04:12.079Z","avatar_url":"https://github.com/brittytino.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# PSGMX - Placement Prep App\n\n**A comprehensive placement preparation companion for PSG Technology MCA batch (2025-2027).**\n\nBuilt with  using **Flutter** and **Supabase**.\n\n![Flutter](https://img.shields.io/badge/Flutter-3.27+-02569B?logo=flutter\u0026logoColor=white) \n![Supabase](https://img.shields.io/badge/Supabase-Production-3ECF8E?logo=supabase\u0026logoColor=white)\n![Dart](https://img.shields.io/badge/Dart-3.0+-0175C2?logo=dart\u0026logoColor=white)\n![License](https://img.shields.io/badge/License-MIT-green)\n[![Build and Release](https://github.com/brittytino/psgmx-flutter/actions/workflows/release.yml/badge.svg)](https://github.com/brittytino/psgmx-flutter/actions/workflows/release.yml)\n\n\n---\n\n##  Features\n\n###  For Students\n- **Daily Attendance**: QR-code style or manual team leader marking.\n- **Placement Tasks**: Daily LeetCode challenges and Core CS topic prep.\n- **Announcements**: Real-time notifications for placement drives and deadlines.\n- **Analytics**: Track your attendance and LeetCode solving streaks.\n- **Personalized Dashboard**: View your specific status and upcoming tasks.\n\n###  For Team Leaders \u0026 Coordinators\n- **Attendance Management**: Mark attendance for your assigned team members.\n- **Task Verification**: Tracking completion of assigned placement work.\n- **Broadcast System**: Send announcements to all students or specific groups.\n- **Reports**: View batch-wide statistics (Simulated Admin/Rep views).\n\n---\n\n##  Tech Stack\n\n*   **Frontend**: Flutter (Mobile - Android \u0026 iOS)\n*   **Backend \u0026 DB**: Supabase (PostgreSQL, Auth, Realtime)\n*   **State Management**: Provider\n*   **Architecture**: Service-Repository Pattern with Feature-first folder structure.\n\n---\n\n##  Project Structure\n\n```\nlib/\n core/            # App-wide configurations (Theme, Constants, Routes)\n models/          # Data models (AppUser, Announcement, LeetCodeStats)\n providers/       # State management (UserProvider, AnnouncementProvider)\n services/        # External API calls (Supabase, Notifications, Quotes)\n ui/              # Screens and Widgets\n    attendance/  # Attendance marking \u0026 viewing\n    home/        # Dashboard (Role-adaptive)\n    profile/     # User profile \u0026 Settings\n    tasks/       # Daily tasks \u0026 Challenges\n main.dart        # Entry point\n```\n\n---\n\n##  Role-Based Access Control\n\nThe app strictly enforces roles via Supabase RLS and App Logic:\n\n1.  **Student**: View only own data, tasks, and public announcements.\n2.  **Team Leader**: Can mark attendance for their specific team.\n3.  **Placement Rep**: Full access to batch data, create announcements, manage tasks.\n4.  **Coordinator**: View reports and assist Reps.\n\n*(Note: Admin features in the current build may be simulated for demonstration via the Profile \u003e Dev Tools section)*\n\n---\n\n##  Setup \u0026 Installation\n\n### Prerequisites\n*   Flutter SDK (3.27.0 or later)\n*   Supabase Account (Free Tier)\n\n### 1. Clone the Repository\n```bash\ngit clone https://github.com/brittytino/psgmx-flutter.git\ncd psgmx-flutter\n```\n\n### 2. Install Dependencies\n```bash\nflutter pub get\n```\n\n### 3. Build the App\n**Android:**\n```bash\nflutter build apk --release\n```\n\n**iOS:**\n```bash\nflutter build ios --release --no-codesign\n```\n\n---\n\n##  Community \u0026 Support\n\n- **Contributing**: Check out our [Contributing Guide](CONTRIBUTING.md) to get started.\n- **Code of Conduct**: We expect all contributors to follow our [Code of Conduct](CODE_OF_CONDUCT.md).\n- **Security**: Please report vulnerabilities according to our [Security Policy](SECURITY.md).\n- **Issues**: Use [GitHub Issues](../../issues) for bug reports and feature requests.\n\n---\n\n**© 2026 PSG Placement Team**\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittytino%2Fpsgmx-flutter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrittytino%2Fpsgmx-flutter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrittytino%2Fpsgmx-flutter/lists"}