# amrsalahdev/evira-e-commerce architecture

> Architecture diagram of the GitHub repository amrsalahdev/evira-e-commerce, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-09-23). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/amrsalahdev/evira-e-commerce
- Repository: https://github.com/amrsalahdev/evira-e-commerce

## Overview

##### Project type and purpose
- This is a multi-platform Flutter application (Android, iOS, Web, Windows, macOS, Linux) serving as a premium E-Commerce & Online Shop front-end.
- It leverages Supabase as its backend (authentication, database, storage), uses Bloc/Cubit for state management, GetIt/Injectable for dependency injection, and integrates Sentry and Microsoft Clarity for monitoring/analytics.

##### File structure
- Top-level platforms: android/, ios/, web/, windows/, macos/, linux/
- Flutter entrypoint: lib/main.dart
- Core modules under lib/core – constants, theme, routes, DI, services, utils, localization
- Feature modules under lib/features – each with UI (screens, widgets), Cubit (state management), and domain/data layers (for onboarding)
- Shared module under lib/shared – reusable widgets, mixins, domain/usecases, cubits
- Configuration & generated code: pubspec.yaml, build_runner, flutter_gen, injectable_generator, flutter_native_splash

##### README for additional insights
- Architecture pattern: a layered “clean” approach with Presentation (UI + Cubit), Domain (entities, use cases), Data (models, Supabase client)
- State management: flutter_bloc (Cubit per screen/feature)
- Dependency injection: get_it + injectable
- External services: supabase_flutter, sentry_flutter, clarity_flutter

##### Main components and their relationships
a. Client Platforms (Android, iOS, Web, Desktop)
b. Presentation Layer
- Widgets & Screens (lib/features/.../ui/screen, lib/shared/widgets)
- Cubits (lib/features/.../ui/cubit, lib/shared/cubits)
- Routes & Navigation (go_router in lib/core/routes/app_router.dart)
c. Domain Layer
- Entities (e.g., OnboardingEntity)
- Use Cases (e.g., GetThemeModeUseCase, SetThemeModeUseCase)
d. Data Layer
- Models (e.g., OnboardingModel)
- Services (Supabase client via supabase_flutter in lib/core/services)
- DI configuration (lib/core/di/di.dart, di.config.dart)
e. Cross-cutting Services
- ThemeService, AppUtils, AppTheme
- Localization (ARB files, intl)
f. External Services & APIs
- Supabase (Auth, Database, Storage)
- Sentry (Error Monitoring)
- Microsoft Clarity (Analytics)

##### Data flow & interactions
- User taps UI → triggers Cubit event → Cubit invokes UseCase/Service via injected repository → Service calls Supabase API → returns data or error → Cubit emits new state → UI rebuilds → optional logging to Sentry/Clarity.
- Theme changes go through ThemeService and persisted via UseCase.
- Navigation via go_router, passing Cubit or arguments between screens.

##### Architectural patterns & principles
- Layered/Clean architecture: clear separation of Presentation, Domain, Data
- Bloc/Cubit for unidirectional data flow
- Dependency Injection for loose coupling and testability
- Code generation for DI (Injectable) and assets (Flutter Gen)
- Feature-based module organization

## Diagram (Mermaid)

```mermaid
graph TB
  %% Client Platforms
  subgraph "Client Platforms"
    Android["Android"]:::platform
    iOS["iOS"]:::platform
    Web["Web"]:::platform
    Windows["Windows"]:::platform
    macOS["macOS"]:::platform
    Linux["Linux"]:::platform
  end

  %% Entry point
  Main["main.dart\n(lib/main.dart)"]:::entrypoint

  %% Presentation Layer
  subgraph "Presentation Layer" 
    Router["Routes & Navigation\ngo_router"]:::presentation
    subgraph "Feature Modules (UI & Cubits)"
      OB_Screen["OnBoardingScreen"]:::presentation
      OB_Cubit["OnboardingCubit"]:::presentation
      Auth_Screen["AuthScreen"]:::presentation
      Auth_Cubit["AuthCubit"]:::presentation
      Login_Screen["LoginScreen"]:::presentation
      Login_Cubit["LoginCubit"]:::presentation
      Signup_Screen["SignupScreen"]:::presentation
      Signup_Cubit["SignupCubit"]:::presentation
      Fill_Screen["FillProfileScreen"]:::presentation
      Fill_Cubit["FillProfileCubit"]:::presentation
    end
    subgraph "Shared UI & Cubits"
      Widgets["Shared Widgets"]:::presentation
      Shared_Cubits["Shared Cubits"]:::presentation
    end
  end

  %% Domain Layer
  subgraph "Domain Layer"
    Entities["Entities"]:::domain
    UseCases["UseCases"]:::domain
  end

  %% Data Layer
  subgraph "Data Layer"
    Models["Data Models"]:::data
    Services["Supabase Service\n(supabase_flutter)"]:::data
  end

  %% Cross-Cutting Services
  subgraph "Cross-Cutting"
    DI["DI Container\n(get_it, injectable)"]:::crosscutting
    ThemeService["ThemeService"]:::crosscutting
    AppTheme["AppTheme"]:::crosscutting
    AppUtils["AppUtils"]:::crosscutting
    Constants["App Colors & Styles"]:::crosscutting
    Localization["Localization\n(intl, ARB)"]:::crosscutting
  end

  %% External Services
  subgraph "External Services"
    Supabase["Supabase\n(Auth, DB, Storage)"]:::external
    Sentry["Sentry\n(Error Monitoring)"]:::external
    Clarity["Microsoft Clarity\n(Analytics)"]:::external
  end

  %% Flows
  Android --> Main
  iOS --> Main
  Web --> Main
  Windows --> Main
  macOS --> Main
  Linux --> Main

  Main --> Router
  Main --> Widgets
  Main --> Shared_Cubits

  Router --> OB_Screen
  OB_Screen --> OB_Cubit
  Auth_Screen --> Auth_Cubit
  Login_Screen --> Login_Cubit
  Signup_Screen --> Signup_Cubit
  Fill_Screen --> Fill_Cubit

  OB_Cubit --> UseCases
  Auth_Cubit --> UseCases
  Login_Cubit --> UseCases
  Signup_Cubit --> UseCases
  Fill_Cubit --> UseCases
  Shared_Cubits --> UseCases

  UseCases --> Services
  Entities --> Models

  Services --> Supabase
  Services --> Sentry
  Services --> Clarity

  DI --> OB_Cubit
  DI --> Auth_Cubit
  DI --> Login_Cubit
  DI --> Signup_Cubit
  DI --> Fill_Cubit
  DI --> UseCases
  DI --> Services
  DI --> ThemeService
  DI --> AppUtils
  DI --> Localization

  ThemeService --> UseCases
  ThemeService --> AppTheme

  AppUtils --> Widgets

  Constants --> Widgets
  Constants --> OB_Screen

  Localization --> OB_Screen
  Localization --> Widgets

  %% Click Events
  click Android "https://github.com/amrsalahdev/evira-e-commerce/tree/main/android/"
  click iOS "https://github.com/amrsalahdev/evira-e-commerce/tree/main/ios/"
  click Web "https://github.com/amrsalahdev/evira-e-commerce/tree/main/web/"
  click Windows "https://github.com/amrsalahdev/evira-e-commerce/tree/main/windows/"
  click macOS "https://github.com/amrsalahdev/evira-e-commerce/tree/main/macos/"
  click Linux "https://github.com/amrsalahdev/evira-e-commerce/tree/main/linux/"
  click Main "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/main.dart"
  click Router "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/routes/app_router.dart"
  click DI "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/di/di.dart"
  click DI "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/di/di.config.dart"
  click ThemeService "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/services/theme_service.dart"
  click AppTheme "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/theme/app_theme.dart"
  click AppUtils "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/utils/app_utils.dart"
  click Constants "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/constants/app_colors.dart"
  click Constants "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/constants/app_styles.dart"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/l10n/intl_ar.arb"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/l10n/intl_en.arb"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/lang_generated/intl/messages_all.dart"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/lang_generated/intl/messages_ar.dart"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/lang_generated/intl/messages_en.dart"
  click Localization "https://github.com/amrsalahdev/evira-e-commerce/blob/main/lib/core/lang_generated/l10n.dart"

  %% Styles
  classDef platform fill:#eef,stroke:#99f,stroke-width:1px;
  classDef entrypoint fill:#def,stroke:#48f,stroke-width:1px;
  classDef presentation fill:#ddf,stroke:#36f,stroke-width:1px,stroke-dasharray: 5 5;
  classDef domain fill:#dfd,stroke:#3a3,stroke-width:1px;
  classDef data fill:#fed,stroke:#fa0,stroke-width:1px;
  classDef crosscutting fill:#eee,stroke:#666,stroke-width:1px,stroke-dasharray: 2 2;
  classDef external fill:#fdd,stroke:#f33,stroke-width:1px;
```
