theme-wireframe

The OUDS Theme Wireframe module provides the concrete implementation of the Wireframe design system theme. It maps the abstract definitions from the Theme Contract to specific Raw Tokens intended for prototyping or white-label applications.

Purpose

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

  • White Label Use: Since it uses neutral colors and generic styles, this theme is ideal for "White Label" applications that require a clean, unbranded base before a specific visual identity is applied.

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

  • Mapping: It assigns specific values from Wireframe raw tokens (e.g., ColorFunctionalGrayDark880) or global raw tokens (e.g., ColorFunctionalSun750) to semantic slots (e.g., bgPrimaryDark, contentStatusWarningLight).

Usage

To use the Wireframe theme in your application (e.g., for internal testing, layout validation, or as a White Label base), follow these steps:

1. Add the dependency

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

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

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

2. Initialize the Theme

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

Use OudsTheme as a replacement for the traditional MaterialTheme.

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

Relationship with other modules

ModuleRoleAnalogy
global-raw-tokensThe Ingredients"Flour", "Water", "Salt"
theme-contractThe Recipe Template"A Cake Recipe"
theme-wireframeThe Specific Recipe"Basic Bread Recipe"
coreThe Baker"Making the Basic Bread available to eat"

Tokens versions

This module implements the design specifications versioned below:

Android system1.2.0
Wireframe brand2.3.0
Wireframe core1.3.0

🤖 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.

Packages

Link copied to clipboard

This package contains the core WireframeTheme class, which acts as the bridge between the abstract contract and the concrete Wireframe visual implementation used to configure the OudsTheme.

Contains the raw tokens that are specific to the Wireframe theme.