Skip to content
A simple library that creates BottomSheets according to the Material Design specs
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
bottomsheetbuilder Don't allow delay dismiss and don't change landscape peek height if e… Apr 5, 2018
gradle Update dependencies Apr 5, 2018
sample Update dependencies Apr 5, 2018
screens Update gif Aug 29, 2016
.gitignore Add longer menu to fill height completely Oct 27, 2016 Update to 1.4 Oct 27, 2016
LICENSE.txt Update LICENSE.txt Mar 31, 2016 Update Apr 5, 2018
build.gradle Update dependencies Apr 5, 2018 Bump to 1.6.1 Apr 5, 2018
gradlew Initial commit Feb 28, 2016
settings.gradle Prepare for jcenter distribution Sep 12, 2016


A simple library that creates BottomSheets according to the Material Design specs:

Available from API 14.


How to use

  • Add the following to your build.gradle:
dependencies {
  implementation 'com.github.rubensousa:bottomsheetbuilder:1.6.1'
  implementation ''
  • Create a view (the builder already inflates the view inside the coordinatorLayout):
View bottomSheet = new BottomSheetBuilder(context, coordinatorLayout)
  • Create a BottomSheetMenuDialog:
BottomSheetMenuDialog dialog = new BottomSheetBuilder(context,
              .setItemClickListener(new BottomSheetItemClickListener() {
                        public void onBottomSheetItemClick(MenuItem item) {
  • If you have a long view, you should consider adding the AppBarLayout to the builder so that the dialog doesn't overlap with it:
BottomSheetMenuDialog dialog = new BottomSheetBuilder(context,
  • If you want to expand the dialog automatically:
BottomSheetMenuDialog dialog = new BottomSheetBuilder(context,
  • If you want to tint the menu icons:
BottomSheetMenuDialog dialog = new BottomSheetBuilder(context,


Make sure the style passed in the BottomSheetBuilder's constructor extends from the Theme.Design.BottomSheetDialog family:

<style name="AppTheme.BottomSheetDialog" parent="Theme.Design.Light.BottomSheetDialog">
    <item name="bottomSheetStyle">@style/AppTheme.BottomSheetStyle</item>

<style name="AppTheme.BottomSheetStyle" parent="Widget.Design.BottomSheet.Modal">
    <item name="behavior_hideable">true</item>
    <item name="behavior_skipCollapsed">true</item>

You can also style the background and text colors as of 1.5:

<style name="AppTheme.BottomSheetDialog.Custom" parent="AppTheme.BottomSheetDialog">
    <item name="bottomSheetBuilderItemTextColor">@color/colorPrimaryDark</item>
    <item name="bottomSheetBuilderBackgroundColor">@android:color/white</item>
    <item name="bottomSheetBuilderTitleTextColor">@color/colorAccent</item>


The sample includes 4 view modes: grid, list, long list and list with one submenu. It also has a save/restore state example.

Customization methods

setItemTextColor(@ColorInt int color)
setTitleTextColor(@ColorInt int color)
setItemTextColorResource(@ColorRes int color)
setTitleTextColorResource(@ColorRes int color)
setIconTintColorResource(@ColorRes int color)
setIconTintColor(int color)
setBackground(@DrawableRes int background)
setBackgroundColorResource(@ColorRes int background)
setBackgroundColor(@ColorInt int background)
setDividerBackground(@DrawableRes int background)
setItemBackground(@DrawableRes int background)
setAppBarLayout(AppBarLayout appbar) -> To avoid overlapping
expandOnStart(boolean expand) -> Defaults to false

Third Party Bindings

React Native

You may now use this library with React Native via the module here


Copyright 2016 Rúben Sousa

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

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
See the License for the specific language governing permissions and
limitations under the License.
You can’t perform that action at this time.