AndroidSharedUI is a comprehensive Jetpack Compose UI library providing reusable components that follow Salesforce Lightning Design System guidelines. The library includes a complete theming framework with support for multiple design systems, comprehensive accessibility features, and production-ready components for Android applications.

• Production-Ready Components: Organized into multiple categories covering all common UI patterns
• Complete Theming System: Colors, Typography, Shapes, Dimensions, and Shadows with multiple design system support
• Multiple Design Systems: Built-in Salesforce Cosmos and Square themes
• SLDS Compliant: Follows Salesforce Lightning Design System Plus guidelines
• Jetpack Compose Native: Built specifically for modern Android development
• Accessibility First: Comprehensive accessibility support built into all components
• Extensive Documentation: Complete API documentation with practical examples for every component

The library is organized into six main component categories:

• Core UI Components (4): Button, Card, Avatar, Badge
• Interactive Components (5): Checkbox, Combobox, Toast, Tooltip, ModalSheet
• Layout Components (4): BaseRow, BadgeRow, CollapsibleCard, SearchRow
• Display Components (5): Footer, NoContent, ToggleTile, ContactRow, FieldValueTile
• Selection Components (2): SingleSelectionList, SelectionListItem
• Icon Components (1): BaseIcon with full SLDS icon support

Add SharedUI to your project's build.gradle:

dependencies {
    implementation 'com.salesforce.android:sharedui:1.0.0'
}

• Android SDK 24 (Android 7.0) or higher
• Kotlin 1.9+
• Jetpack Compose 1.5+

SharedUI includes a comprehensive theming system based on Salesforce Cosmos design tokens:

import com.salesforce.android.sharedui.theme.SalesforceCosmosTheme
import com.salesforce.android.sharedui.components.*

@Composable
fun MyApp() {
    SalesforceCosmosTheme {
        // Your app content here
        MyScreen()
    }
}

• Colors: Primary, secondary, success, warning, error, neutral palettes
• Typography: Complete type scale with support for Material You dynamic color
• Shapes: Consistent corner radius and shape definitions
• Dimensions: Standard spacing and sizing scales
• Shadows: Elevation system for depth and hierarchy

import com.salesforce.android.sharedui.theme.SharedUITheme

@Composable
fun CustomThemedApp() {
    SharedUITheme(
        colors = MyCustomColors,
        typography = MyCustomTypography,
        shapes = MyCustomShapes
    ) {
        // Your app content
    }
}

import androidx.compose.foundation.layout.*
import androidx.compose.runtime.*
import androidx.compose.ui.Modifier
import androidx.compose.ui.unit.dp
import com.salesforce.android.sharedui.components.*
import com.salesforce.android.sharedui.theme.SalesforceCosmosTheme

@Composable
fun ExampleScreen() {
    var showToast by remember { mutableStateOf(false) }

    SalesforceCosmosTheme {
        Column(
            modifier = Modifier
                .fillMaxSize()
                .padding(16.dp),
            verticalArrangement = Arrangement.spacedBy(16.dp)
        ) {
            Button(
                text = "Primary Button",
                style = ButtonStyle.Primary,
                onClick = { showToast = true }
            )

            Card(
                modifier = Modifier.fillMaxWidth()
            ) {
                Column(
                    modifier = Modifier.padding(16.dp),
                    verticalArrangement = Arrangement.spacedBy(8.dp)
                ) {
                    Text(
                        text = "Card Title",
                        style = MaterialTheme.typography.titleMedium
                    )
                    Text(
                        text = "Card content goes here",
                        style = MaterialTheme.typography.bodyMedium
                    )
                }
            }

            Avatar(
                initials = "JD",
                size = AvatarSize.Large
            )

            if (showToast) {
                Toast(
                    message = "Action completed successfully!",
                    type = ToastType.Success,
                    onDismiss = { showToast = false }
                )
            }
        }
    }
}

All SharedUI components are built with accessibility as a priority:

• TalkBack Support: Comprehensive screen reader support with meaningful content descriptions
• Touch Targets: Minimum 48dp touch targets on all interactive elements
• Color Contrast: WCAG AA compliant color combinations
• State Descriptions: Clear indication of component states for assistive technologies
• Keyboard Navigation: Full keyboard navigation support where applicable
• Dynamic Font Scaling: Respect user's system font size preferences

SharedUI components are designed to be testable:

@Test
fun testButtonClick() {
    composeTestRule.setContent {
        Button(
            text = "Test Button",
            style = ButtonStyle.Primary,
            onClick = { /* handle click */ }
        )
    }

    composeTestRule
        .onNodeWithText("Test Button")
        .performClick()
}

SharedUI is available under the terms specified in the TERMS_OF_USE.txt file.

Copyright 2026 Salesforce, Inc. All rights reserved.

For bug reports and feature requests, please use the GitHub Issues section of this repository.

For Salesforce employees: Please refer to internal documentation for contribution guidelines and development setup.

• SLDSIcons-Android - Salesforce Lightning Design System icon library for Android
• Salesforce Lightning Design System - The official design system

• Jetpack Compose Documentation
• Material Design 3
• Android Accessibility

Note: This library is provided as-is for use in mobile applications. See the TERMS_OF_USE.txt for complete details on usage, warranty, and liability.