SimpleTopAppBar

Implements a simple top app bar with a navigation back button and kebab menu, facilitating seamless navigation and interaction in applications.

#ui
#compose-multiplatform
#compose

Suggest an edit

Android JVMJVMKotlin/NativeWasm

GitHub stars0

Authorsyuyuyuyuyu-dev

Open issues0

LicenseApache License 2.0

Creation dateabout 1 year ago

Last activity8 months ago

Latest release0.3.1 (8 months ago)

Homepage GitHub repository Wiki page

SimpleTopAppBar

A simple TopAppBar for Android and Compose Multiplatrorm, include navigate back button and kebab menu button.

Installation

Android

app/build.gradle.kts

dependencies {
    ...

+   implementation("dev.yuyuyuyuyu:simpletopappbar:0.3.1")
}

Compose Multiplatform

composeApp/build.gradle.kts

kotlin {
...

    sourceSets {
        ...

        commonMain.dependencies {
            ...

+           implementation("dev.yuyuyuyuyu:simpletopappbar:0.3.1")
        }
    }
}

Screenshots

Android

Compose Multiplatform

Examples

Android

app/src/main/java/dev/yuyuyuyuyu/simpletopappbar/example/android/ui/App.kt

@Composable
fun App(
    navController: NavHostController = rememberNavController(),
) {
    val backStackEntry by navController.currentBackStackEntryAsState()
    val currentScreen = NavigateDestination.valueOf(
        value = backStackEntry?.destination?.route
            ?: NavigateDestination.SimpleTopAppBarExample.name,
    )

    SimpleTopAppBarTheme {
        Scaffold(
            topBar = {
                SimpleTopAppBar(
                    title = currentScreen.name,
                    navigateBackIsPossible = navController.previousBackStackEntry != null,
                    onNavigateBackButtonClick = { navController.navigateUp() },
                    onOpenSourceLicensesButtonClick = {
                        if (currentScreen != NavigateDestination.OpenSourceLicenses) {
                            navController.navigate(NavigateDestination.OpenSourceLicenses.name)
                        }
                    },
                )
            },
        ) { innerPadding ->
            NavHost(
                navController = navController,
                startDestination = NavigateDestination.SimpleTopAppBarExample.name,
                modifier = Modifier.padding(innerPadding),
            ) {
                composable(route = NavigateDestination.SimpleTopAppBarExample.name) {
                    SimpleTopAppBarExampleScreen()
                }
                composable(route = NavigateDestination.OpenSourceLicenses.name) {
                    OpenSourceLicensesScreen()
                }
            }
        }
    }
}

Compose Multiplatform

composeApp/src/commonMain/kotlin/dev/yuyuyuyuyu/simpletopappbar/example/multiplatform/ui/App.kt

fun App(
    navController: NavHostController = rememberNavController(),
) {
    val backStackEntry by navController.currentBackStackEntryAsState()
    val currentScreen = NavigateDestination.valueOf(
        value = backStackEntry?.destination?.route
            ?: NavigateDestination.SimpleTopAppBarExample.name,
    )

    MaterialTheme {
        Scaffold(
            topBar = {
                SimpleTopAppBar(
                    title = currentScreen.name,
                    navigateBackIsPossible = navController.previousBackStackEntry != null,
                    onNavigateBackButtonClick = { navController.navigateUp() },
                    onOpenSourceLicensesButtonClick = {
                        if (currentScreen != NavigateDestination.OpenSourceLicenses) {
                            navController.navigate(NavigateDestination.OpenSourceLicenses.name)
                        }
                    },
                )
            },
        ) { innerPadding ->
            NavHost(
                navController = navController,
                startDestination = NavigateDestination.SimpleTopAppBarExample.name,
                modifier = Modifier.padding(innerPadding),
            ) {
                composable(route = NavigateDestination.SimpleTopAppBarExample.name) {
                    SimpleTopAppBarExampleScreen()
                }
                composable(route = NavigateDestination.OpenSourceLicenses.name) {
                    OpenSourceLicensesScreen()
                }
            }
        }
    }
}

License

Apache License 2.0

Copyright 2025 yu

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

Android JVMJVMKotlin/NativeWasm

GitHub stars0

Authorsyuyuyuyuyu-dev

Open issues0

LicenseApache License 2.0

Creation dateabout 1 year ago

Last activity8 months ago

Latest release0.3.1 (8 months ago)

Homepage GitHub repository Wiki page

SimpleTopAppBar

A simple TopAppBar for Android and Compose Multiplatrorm, include navigate back button and kebab menu button.

Installation

Android

app/build.gradle.kts

dependencies {
    ...

+   implementation("dev.yuyuyuyuyu:simpletopappbar:0.3.1")
}

Compose Multiplatform

composeApp/build.gradle.kts

kotlin {
...

    sourceSets {
        ...

        commonMain.dependencies {
            ...

+           implementation("dev.yuyuyuyuyu:simpletopappbar:0.3.1")
        }
    }
}

Screenshots

Android

Compose Multiplatform

Examples

Android

app/src/main/java/dev/yuyuyuyuyu/simpletopappbar/example/android/ui/App.kt

@Composable
fun App(
    navController: NavHostController = rememberNavController(),
) {
    val backStackEntry by navController.currentBackStackEntryAsState()
    val currentScreen = NavigateDestination.valueOf(
        value = backStackEntry?.destination?.route
            ?: NavigateDestination.SimpleTopAppBarExample.name,
    )

    SimpleTopAppBarTheme {
        Scaffold(
            topBar = {
                SimpleTopAppBar(
                    title = currentScreen.name,
                    navigateBackIsPossible = navController.previousBackStackEntry != null,
                    onNavigateBackButtonClick = { navController.navigateUp() },
                    onOpenSourceLicensesButtonClick = {
                        if (currentScreen != NavigateDestination.OpenSourceLicenses) {
                            navController.navigate(NavigateDestination.OpenSourceLicenses.name)
                        }
                    },
                )
            },
        ) { innerPadding ->
            NavHost(
                navController = navController,
                startDestination = NavigateDestination.SimpleTopAppBarExample.name,
                modifier = Modifier.padding(innerPadding),
            ) {
                composable(route = NavigateDestination.SimpleTopAppBarExample.name) {
                    SimpleTopAppBarExampleScreen()
                }
                composable(route = NavigateDestination.OpenSourceLicenses.name) {
                    OpenSourceLicensesScreen()
                }
            }
        }
    }
}

Compose Multiplatform

composeApp/src/commonMain/kotlin/dev/yuyuyuyuyu/simpletopappbar/example/multiplatform/ui/App.kt

fun App(
    navController: NavHostController = rememberNavController(),
) {
    val backStackEntry by navController.currentBackStackEntryAsState()
    val currentScreen = NavigateDestination.valueOf(
        value = backStackEntry?.destination?.route
            ?: NavigateDestination.SimpleTopAppBarExample.name,
    )

    MaterialTheme {
        Scaffold(
            topBar = {
                SimpleTopAppBar(
                    title = currentScreen.name,
                    navigateBackIsPossible = navController.previousBackStackEntry != null,
                    onNavigateBackButtonClick = { navController.navigateUp() },
                    onOpenSourceLicensesButtonClick = {
                        if (currentScreen != NavigateDestination.OpenSourceLicenses) {
                            navController.navigate(NavigateDestination.OpenSourceLicenses.name)
                        }
                    },
                )
            },
        ) { innerPadding ->
            NavHost(
                navController = navController,
                startDestination = NavigateDestination.SimpleTopAppBarExample.name,
                modifier = Modifier.padding(innerPadding),
            ) {
                composable(route = NavigateDestination.SimpleTopAppBarExample.name) {
                    SimpleTopAppBarExampleScreen()
                }
                composable(route = NavigateDestination.OpenSourceLicenses.name) {
                    OpenSourceLicensesScreen()
                }
            }
        }
    }
}

License

Apache License 2.0

Copyright 2025 yu

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.