Orange-OpenSource · AhmedAmineZr · Apr 21, 2026 · Jun 11, 2025 · Jun 12, 2025 · Jun 16, 2025
diff --git a/.github/CODEOWNERS.txt b/.github/CODEOWNERS.txt
@@ -0,0 +1,10 @@
+# CODEOWNERS file for OUDS Android
+# 
+# This file defines code owners for the repository.
+# Code owners are automatically requested for review when someone opens a pull request
+# that modifies code that they own.
+#
+# More info: https://docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
+
+# Default owners for everything in the repo
+* @nouha06 @AhmedAmineZr
diff --git a/.github/CODE_OF_CONDUCT.md b/.github/CODE_OF_CONDUCT.md
@@ -60,7 +60,7 @@ representative at an online or offline event.
 
 Instances of abusive, harassing, or otherwise unacceptable behavior may be
 reported to the community leaders responsible for enforcement at
-julien.deramond@orange.com.
+julien.deramond@orange.com and opensource.contact@orange.com.
 All complaints will be reviewed and investigated promptly and fairly.
 
 All community leaders are obligated to respect the privacy and security of the

diff --git a/.github/DEVELOP.md b/.github/DEVELOP.md
@@ -3,6 +3,11 @@
 - [Technical Preconditions](#technical-preconditions)
   * [Dependency Management](#dependency-management)
   * [Generation of Localization Files in the app and ouds_core Folders](#generation-of-localization-files-in-the-app-and-ouds_core-folders)
+- [Running Tests](#running-tests)
+  * [Test Suites](#test-suites)
+  * [Run All Tests](#run-all-tests)
+  * [Run Tests for a Specific Package](#run-tests-for-a-specific-package)
+  * [Automated CI Tests](#automated-ci-tests)
 - [Commits, Changelog, Release Notes, Versioning](#commits-changelog-release-notes-versioning)
   * [Commit Guidelines](#commit-guidelines)
   * [Release Notes and Changelog](#release-notes-and-changelog)
@@ -35,6 +40,58 @@ You need to run this command because it generates the necessary localization fil
 flutter gen-l10n
 ```
 
+## Running Tests
+
+The project uses [`flutter_test`](https://api.flutter.dev/flutter/flutter_test/flutter_test-library.html), the official Flutter testing framework (FLOSS, Apache 2.0 license), as its automated test suite.
+
+### Test Suites
+
+Tests are located in each package's `test/` directory:
+
+| Package | Test file |
+|---|---|
+| `app` | `app/test/widget_test.dart` |
+| `ouds_core` | `ouds_core/test/ouds_core_test.dart` |
+| `ouds_global_raw_tokens` | `ouds_global_raw_tokens/test/ouds_global_raw_tokens_test.dart` |
+| `ouds_theme_contract` | `ouds_theme_contract/test/ouds_theme_contract_test.dart` |
+| `ouds_theme_orange` | `ouds_theme_orange/test/ouds_theme_orange_test.dart` |
+| `ouds_theme_sosh` | `ouds_theme_sosh/test/ouds_theme_sosh_test.dart` |
+| `ouds_theme_wireframe` | `ouds_theme_wireframe/test/ouds_theme_wireframe_test.dart` |
+
+### Run All Tests
+
+From the root of the repository, run the following commands to execute tests for each package:
+
+```bash
+cd app && flutter test && cd ..
+cd ouds_core && flutter test && cd ..
+cd ouds_global_raw_tokens && flutter test && cd ..
+cd ouds_theme_contract && flutter test && cd ..
+cd ouds_theme_orange && flutter test && cd ..
+cd ouds_theme_sosh && flutter test && cd ..
+cd ouds_theme_wireframe && flutter test && cd ..
+```
+
+### Run Tests for a Specific Package
+
+```bash
+cd <package_name>
+flutter test
+```
+
+For example, to run only the `ouds_core` tests:
+
+```bash
+cd ouds_core
+flutter test
+```
+
+### Automated CI Tests
+
+Tests are automatically executed on every push and pull request to `main` and `develop` branches via the GitHub Actions workflow defined in [`.github/workflows/build.yml`](./workflows/build.yml).
+
+The CI pipeline runs all test suites before any build step, ensuring no broken code is merged.
+
 ## Commits, Changelog, Release Notes, Versioning
 
 ### Commit Guidelines

diff --git a/.github/ISSUE_TEMPLATE/bug_report.yml b/.github/ISSUE_TEMPLATE/bug_report.yml
@@ -2,7 +2,7 @@ name: Report a bug
 description: Tell us about a bug or issue you may have identified in OUDS Flutter.
 title: "[Bug]: Bug Summary"
 labels: ["🐞 bug", "🔍 triage"]
-assignees: ["Tayebsed93", "nouha06", "AhmedAmineZr"]
+assignees: ["nouha06", "AhmedAmineZr"]
 body:
   - type: checkboxes
     attributes:

diff --git a/.github/ISSUE_TEMPLATE/component_update.yml b/.github/ISSUE_TEMPLATE/component_update.yml
@@ -0,0 +1,29 @@
+name: Component update
+description: Propose a change for a specific component
+labels: [ "⚛️ component", "🧰 library", "🔍 triage" ]
+assignees: ["nouha06", "AhmedAmineZr"]
+projects: [ "⚛️ [OUDS] Project" ]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping us improve OUDS Android!
+  - type: checkboxes
+    attributes:
+      label: Prerequisites
+      description: Take a couple minutes to help our maintainers work faster.
+      options:
+        - label: I have [searched the backlog](https://github.com/Orange-OpenSource/ouds-android/issues) for duplicate or closed issues.
+          required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe your need in details
+    validations:
+      required: true
+  - type: textarea
+    id: motivation_context
+    attributes:
+      label: Motivation & context
+      description: Why is this change required? What problem does it solve?
diff --git a/.github/ISSUE_TEMPLATE/demo_app_update.yml b/.github/ISSUE_TEMPLATE/demo_app_update.yml
@@ -0,0 +1,24 @@
+name: Demo app update
+description: Propose a change in the Design Toolbox application
+labels: [ "📱 demo app", "🔍 triage" ]
+assignees: ["nouha06", "AhmedAmineZr"]
+projects: [ "⚛️ [OUDS] Project" ]
+body:
+  - type: markdown
+    attributes:
+      value: |
+        Thanks for helping us improve the Design Toolbox demo app!
+  - type: checkboxes
+    attributes:
+      label: Prerequisites
+      description: Take a couple minutes to help our maintainers work faster.
+      options:
+        - label: I have [searched the backlog](https://github.com/Orange-OpenSource/ouds-android/issues) for duplicate or closed issues.
+          required: true
+  - type: textarea
+    id: description
+    attributes:
+      label: Description
+      description: Describe your need in details. Which screens? Which tokens, components or modules?
+    validations:
+      required: true
diff --git a/.github/ISSUE_TEMPLATE/documentation-update.yml b/.github/ISSUE_TEMPLATE/documentation-update.yml
@@ -2,7 +2,7 @@ name: Documentation Update
 description: Describe this issue found in the documentation
 title: "[Doc]: "
 labels: ["📖 documentation", "🔍 triage"]
-assignees: ["Tayebsed93", "nouha06", "AhmedAmineZr"]
+assignees: ["nouha06", "AhmedAmineZr"]
 body:
   - type: markdown
     attributes:

diff --git a/.github/ISSUE_TEMPLATE/feature_request.yml b/.github/ISSUE_TEMPLATE/feature_request.yml
@@ -2,7 +2,7 @@ name: Feature Request
 description: Suggest a new Epic to be added to the backlog.
 title: "[feature]: "
 labels: ["🗳️ feature", "🔍 triage"]
-assignees: ["Tayebsed93", "nouha06", "AhmedAmineZr"]
+assignees: ["nouha06", "AhmedAmineZr"]
 body:
   - type: checkboxes
     attributes:

diff --git a/.github/MAINTAINERS.md b/.github/MAINTAINERS.md
@@ -12,7 +12,6 @@ This document contains a list of maintainers in this repo. If you're interested
 
 | Maintainer           | GitHub ID    | Email                                | Affiliation    |
 | -------------------- | -----------  | ------------------------------------ | -------------- |
-| Tayeb SEDRAIA        | Tayebsed93   | tayeb.sedraia@orange.com             | OAB SA         |
 | Ahmed Amine ZRIBI    | AhmedAmineZr | ahmedamine.zribi@sofrecom.com        | SOFRECOM       |
 | HAMMAMI Nouha        | nouha06      | nouha.hammami@sofrecom.com           | SOFRECOM       |
 

diff --git a/.github/SECURITY.md b/.github/SECURITY.md
@@ -1,9 +1,12 @@
 # Security Policy
 
-# Reporting Security Issues
+## Reporting Security Issues
 
 We appreciate your efforts to responsibly disclose your findings, and will make every effort to acknowledge your contributions.
-Send an e-mail to [opensource.contact@orange.com](mailto:opensource.contact@orange.com) to report a vulnerability and contact all people in CONTRIBUTORS and MAINTAINERS including the word "SECURITY" in the subject line.
+To report a vulnerability, send an e-mail to **both**:
+- [opensource.contact@orange.com](mailto:opensource.contact@orange.com)
+- and [cert.cc@orange.com](mailto:cert.cc@orange.com)
+- and all people in MAINTAINERS including the word "SECURITY" in the subject line
 
 Please allow our team sufficient time to resolve the vulnerability before disclosing it ; we'll remain in contact about the fix and may ask for your assistance to verify it is resolved.