How vuralkayracetintas/app_jam_f_40 works
Project Type and Purpose
• This is a cross-platform mobile/web “Announcement” application built in Flutter. It targets Android, iOS, Linux, macOS, Windows, and the Web.
• Purpose: allow students to log in, select announcement categories (Flutter, Unity, General), and view tasks, events, and push notifications.
File Structure Highlights
• Top-level platform folders: android/, ios/, linux/, macos/, windows/, web/.
• Core application code in lib/:
• pages/ – UI screens organized by feature (login, home, announce/category pages, splash)
• pages/service/ – notification services (Firebase and local)
• pages/widgets/ – reusable UI controls
• assets/ – images & Lottie animations
• Configuration/build: pubspec.yaml, analysis_options.yaml, platform Gradle/Xcode/CMake files.
Architectural Overview from README
• Presentation layer: Flutter Widgets and Pages
• Service layer: Firebase Cloud Messaging + local notifications
• No in-repo backend – relies on external FCM service for announcements
a. Main Components
• Flutter Client (Single codebase)
– Presentation Layer (lib/pages & lib/pages/widgets)
– Service Layer (lib/pages/service)
• Platform Runtimes (“Flutter Engine” per target: Android, iOS, Web, Desktop)
• External Services
– Firebase Cloud Messaging (push notifications)
– Optional external announcements URLs (use_url.dart → url_launcher)
b. Relationships & Data Flow
1. User taps UI → Presentation Layer
2. UI requests notifications permission → Service Layer
3. Service Layer registers with FCM → Firebase Cloud Messaging
4. FCM delivers push → Service Layer → Local Notification API → Presentation
5. User clicks links → url_launcher → External Web
c. Architectural Patterns
• Layered architecture (UI → Services → External)
• Platform‐abstraction via Flutter Engine
d. Key Technologies
• Flutter & Dart
• firebase_messaging (in firebase_notification_service.dart)
• flutter_local_notifications (in local_notification_service.dart)
• url_launcher (in use_url.dart)
• Lottie animations (assets/animations)