Installation

Get DWallet up and running on your local machine in minutes.

Prerequisites

Before you begin, ensure you have the following installed:

Flutter SDK: 3.41.0 or later (Stable channel)
Dart SDK: 3.10.0 or later (included with Flutter)
IDE: VS Code or Android Studio with Flutter/Dart plugins installed

Setup Steps

Extract the downloaded package to your desired location.
Navigate to the project directory:
Terminal window
```
cd dwallet_ui
```
Install Dependencies: Run the following command to fetch all required packages:
Terminal window
```
flutter pub get
```
Generate Required Code (mandatory): This project uses AutoRoute for type-safe routing, which requires a one-time code generation step:
Terminal window
```
dart run build_runner build --delete-conflicting-outputs
```
You must run this command before running the app for the first time. Skipping this step will result in compilation errors due to the missing generated router file (_app_router.gr.dart).

If you later modify route definitions in _app_router.dart, re-run this command. During active development, use dart run build_runner watch --delete-conflicting-outputs to auto-regenerate on changes.
Run the App: Choose your target device (Android/iOS Simulator) and run:
Terminal window
```
flutter run
```

Project Structure

The app uses a clean architecture with the following structure:

/lib
├── main.dart                    # App entry point
└── /app
    ├── /core                    # Core utilities
    ├── /di                      # Dependency injection
    │   └── /services           # Service providers
    ├── /pages                   # UI pages
    ├── /providers               # State providers
    ├── /router                  # Navigation
    └── /widgets                 # Reusable widgets

/packages/dwallet_types          # Local data package

Post-Install Check

If the app launches successfully and you see the onboarding screen, you’re all set!

Preparing for Publication

Ready to publish your app? Follow the Publishing Preparation Guide to:

Change your package name and bundle ID using change_app_package_name
Update the app name using rename_app
Customize the app icon using flutter_launcher_icons

These CLI tools are already included in the project’s dev_dependencies for your convenience.