How aurumco/riyales works
Project Type and Purpose
• This is a full-stack, cross-platform Flutter application (“Riyales”) used to display real-time financial data (currencies, crypto, gold, stocks). The frontend is a single Flutter codebase compiled for Android, iOS, Web, Linux, macOS, and Windows. The backend (external to this repo) is a Python service that aggregates real-time data from third-party financial APIs.
File Structure Analysis
• Top-level “android/”, “ios/”, “linux/”, “macos/”, “windows/”, “web/” directories contain the platform‐specific embedder code and configuration.
• “lib/” holds the Dart application logic, divided into:
– config (app_config, constants)
– generated (localizations)
– l10n (ARB files) and localization utilities
– models (data structures: Asset, Alert, Terms)
– providers (state managers via Provider, grouped by feature & data source)
– services (API service, connectivity, analytics, device info, action handling)
– ui (presentation layer: screens, widgets, theme)
– utils (helpers, extensions)
• GitHub Actions workflows for building APK and Web artifacts in “.github/workflows/”.
Key README Insights
• Flutter frontend (Dart)
• Python backend serving as data aggregator/proxy
• Real-time third-party financial data APIs
• Smooth UI/UX, light & dark themes
• Under active development, CI set up for mobile/web builds