How omar-e-khalifa/currency_calculator works
LancerCalc is a Flutter currency calculator for freelancers. The principal workflow combines calculator input with live exchange-rate conversion; users can also swap currencies and retain currency preferences locally. The README documents calculator, settings, API, and storage capabilities, but the Dart sources were not excerpted, so internal call ownership is not verifiable. Edges therefore cite documented behavior or are marked unverified. Tax calculation and full currency management are planned, not implemented.
Main entry points: currency_calculator_view.dart Calculator screen · settings_view.dart Settings screen · currency_list_cubit.dart Currency list state · exchange_rate_cubit.dart Exchange rate state
Components 17
App experience
- App entry
lib/main.dart - Calculator screen
lib/views/currency_calculator_view.dart - Settings screen
lib/views/settings_view.dart - Reusable widgets
lib/widgets - Calculator layout
lib/data/buttons_list.dart
State and domain
- Display state
lib/cubits/display_area_cubit/display_area_cubit.dart - Currency list state
lib/cubits/currency_list_cubit/currency_list_cubit.dart - Exchange rate state
lib/cubits/exchange_rate_cubit/exchange_rate_cubit.dart - Domain models
lib/models
Services and integrations
- Rate API service
lib/services/exchange_rate_service.dart - Supported codes service
lib/services/supported_code_service.dart - Preference storage
lib/services/shared_preferences_service.dart
Planned capabilities
- Tax screen
lib/views - Currency management
lib/views
Other components
- Freelancer
- ExchangeRate-API
- Local preferences
Connections 15
- Freelancer → Calculator screen: enters amounts
README.md - Calculator screen → Exchange rate state: converts currencies
- Calculator screen → Display state: calculator input
- Calculator screen → Calculator layout: uses layout
- Calculator screen → Reusable widgets: shows controls
- Freelancer → Settings screen: selects currencies
README.md - Settings screen → Currency list state: selects currencies
- Settings screen → Preference storage: saves preferences
- Preference storage → Local preferences: persists locally
README.md - Exchange rate state → Rate API service: requests rates
- Rate API service → ExchangeRate-API: fetches rates
README.md - Currency list state → Supported codes service: loads supported codes
- Calculator screen → Tax screen: planned feature
README.md - Settings screen → Currency management: planned feature
README.md - App entry → Calculator screen: launches screen