This repository provides an overview over the flagship product Diia developed by the Ministry of Digital Transformation of Ukraine.

Diia is an app with access to citizen’s digital documents and government services.

The application was created so that Ukrainians could interact with the state in a few clicks, without spending their time on queues and paperwork - Diia open source application will help countries, companies and communities build a foundation for long-term relationships. At the heart of these relations are openness, efficiency and humanity.

We're pleased to share the Diia project with you.

1.1. Clone the repository and open the Xcode project file.

git clone https://github.com/diia-open-source/ios-diia.git
cd ios-diia
open DiiaOpenSource.xcodeproj

1.2. Wait for the SPM packages to finish resolving.

Build and run the project on iOS device or simulator.

To get mock user for testing please refer to the TESTING.md file for details.

For configuring project we are using .xcconfig settings files:

Development Environment (DiiaDev.xcconfig)

// API
API_BASE_URL = api2oss.diia.gov.ua

// APP SETTINGS
APP_NAME = Diia OpenSource
APP_BUNDLE_ID = ua.gov.diia.opensource.app
SCHEME = DiiaDev

• API_BASE_URL: Set this to the URL of your backend server.
• APP_NAME: Defines the name of the application.
• APP_BUNDLE_ID: Specifies the bundle identifier of the application.
• SCHEME: Indicates the scheme used for the application.

• Presenting authentication available methods
• Bank-ID authorization method
• PinCode. Enteing, changing pincode plust enabling the using biometry option

• Presenting collection of available documents with the ability to change the order
• Driver License document

• Presenting list of available public services
• Criminal Record Extract service

It serves as the go-to hub for personalized control and management within the app, offering features like the ability to reorder documents, change the app's pin code, toggle biometry on/off, contact support, read about the app and policies, and log out.

Almost all features and core components such as network core and UI library are shipped as separate SPM packages.

• DiiaMVPModule: Model-View-Presenter basic protocols
• DiiaNetwork: The foundational network layer
• DiiaUIComponents: Basic UI components and primitives.
• DiiaCommonTypes: Types (classes, strucutres, protocols) that have to be shared amond several packages.
• DiiaCommonServices: Foundational utilities and modules providing essential support for Diia on iOS.
• DiiaAuthorization: Core of authorization, authorization methods and pin code.
• DiiaDocuments: Documents core functionality and particular documents
• DiiaPublicServices: Public services core functionality and particular public services.

• RNCryptor
• Lottie

The Diia project welcomes contributions into this solution; please refer to the CONTRIBUTING file for details

Copyright (C) Diia and all other contributors.

Licensed under the EUPL (the "License"); you may not use this file except in compliance with the License. Re-use is permitted, although not encouraged, under the EUPL, with the exception of source files that contain a different license.

You may obtain a copy of the License at https://joinup.ec.europa.eu/collection/eupl/eupl-text-eupl-12.

Questions regarding the Diia project, the License and any re-use should be directed to [email protected].