theme-sosh

The OUDS Theme Sosh module provides the concrete implementation of the Sosh design system theme. It maps the abstract definitions from the Theme Contract to the specific Raw Tokens of the Sosh brand.

It serves as the "factory" that assembles the specific visual identity of Sosh.

Purpose

While the core module provides the mechanisms to access the theme, and theme-contract defines what a theme is, theme-sosh defines what the Sosh theme looks like.

• Implementation: It implements the interfaces defined in theme-contract (OudsColorSemanticTokens, OudsFontSemanticTokens, etc.).

• Mapping: It assigns specific values from Sosh raw tokens (e.g., ColorBlueDuckDark960) or global raw tokens (e.g., ColorFunctionalBlack) to semantic slots (e.g., bgPrimaryDark, contentDefaultLight).

Usage

To use the Sosh theme in your application, follow these steps:

1. Add the dependency

Ensure the theme-sosh module is included in your module's build.gradle.kts file in addition to the core module:

dependencies {
    // ...
    implementation("com.orange.ouds.android:ouds-core:0.4.0")
    implementation("com.orange.ouds.android:ouds-theme-sosh:0.4.0")
    // ...
}

dependencies {
    // ...
    implementation 'com.orange.ouds.android:ouds-core:0.4.0'
    implementation 'com.orange.ouds.android:ouds-theme-sosh:0.4.0'
    // ...
}

2. Initialize the Theme

In your application, you must provide the SoshTheme instance to the OudsTheme composable. This effectively "injects" the Sosh visual style into the OUDS system.

Use OudsTheme as a replacement for the traditional MaterialTheme.

OudsTheme(theme = SoshTheme()) {
    // Use OUDS Android or Material components here for an interface
    // matching the Orange Unified Design System with the Sosh theme
}

Relationship with other modules

Tokens versions

This module implements the design specifications versioned below:

🤖 Note: The majority of the files in this module (specifically within the tokens packages) are automatically generated by Tokenator based on the design definitions.

Any manual changes to these files will be lost during the next synchronization.