Android Material Navigation Drawer library

Android Material Navigation Drawer library

Create navigation drawers in your Activities and Fragments without having to write any XML, in pure Kotlin code, with access to all the features of the original library: all sorts of menu items, badges, account headers, and more.

This library is a Kotlin DSL wrapper around the mikepenz/MaterialDrawer library, and features:

  • Access to all of the original library’s features with a nice, concise API
  • Fixes for the couple of inconsistencies of the original API
  • Detailed code comments for conveninent in-IDE documentation lookup (Ctrl+Q on Windows⌃J on Mac)

Sample app

You can find the sample app in the Play Store, and its source code in the app module of the project.


The library is hosted on jcenter. To use it, add the following to your module level build.gradle file’s dependencies:

In general, you don’t have to include the original library separately. (See the note in the FAQ.)

If you’re not using AndroidX yet, you can use the last 1.x release of the library found here.

Basic usage

Just as a general note, try using the in-IDE documentation when you’re in doubt about anything. It’s much more detailed than the original library’s docs, this was one of the design goals of the library. The IntelliJ/Android Studio shortcut for bringing up the docs about a function is Ctrl+Q on Windows, and ⌃J on Mac.

To add a navigation drawer, you just have to add the following to your Activity’s onCreate function:

This will give you an empty sheet that you can drag in from the left side of the screen. You can add menu items to it like this:

For all the available types of menu items, see the “Drawer item types” in the sample app.

You can modify properties of the drawer inside the drawer {} block, and properties of the menu items in their respective blocks:

Note that most of these properties are non-readable, and can only be used for setting these values. This is why these properties are marked as deprecated, and will cause build errors. The rest should be safe to use to read back any values you’ve set, if you had to do that for whatever reason.

For a complete reference of the wrapper methods and properties, see the list in the wiki.

Advanced features

Account headers

Creating an account header with profile entries can be done like so:

Note that loading images from URLs requires additional setup, see the Image loading section of this document or the DrawerApplication class in the sample app for guidance.


You can add items to an always visible, sticky footer in by nesting them inside a footer block:


Listeners can be added to both individual drawer items and the entire drawer. Some examples:

More examples in the “Listeners” section of the sample app.


Add badges to drawer items, and customize them with this syntax:

You can see more examples in the “Badges” section of the sample app.

Conversion from original

This is a rough guide to how the original API’s features are converted to the DSL, for those who are already familiar with the original library.


Builders are replaced by functions that are named without the “Builder” suffix.

… is replaced with …


Calls to XyzDrawerItem classes are replaced with functions as well. The “Drawer” word is omitted from the function’s name. Note that properties like names and descriptions of the drawer items become parameters of these functions.

For example:

… is replaced with …

with functions

Calls to .withXyz() functions are replaced with properties that you can set. For a complete reference of the wrapper methods and properties, see the list in the wiki.

Very few of these are readable. If you want to read these at build time for some reason, check the documentation. Non readable properties should be deprecated and not compile, but if they do, they will throw a NonReadablePropertyException if you attempt to read their value.

For an example…

… is replaced with …

Note that overloaded functions are replaced with multiple properties, distinguished by suffixes. For example, the above withHeaderBackground function’s three overloads can be set through the following properties:

Parameter typeProperty name

There may be defaults without suffixes for what’s assumed to be the most popular use case.


Adding simple listeners to drawers (or individual drawer items) are done with onXyz function calls, which take lambdas as parameters. For example:

… is replaced with …

Complex listeners

Listeners that originally have multiple callbacks have been broken up into individual functions:

… is replaced with …

Image loading

Since the MaterialDrawer library doesn’t include its own image loading solution, you have to set one up yourself. You have to do this before the first time MaterialDrawer has to load an image, for example, in your Application’s onCreate method.

With the original library, this setup looks like this (Picasso is just used as an example):

This can be replaced by the following:


I want to use features of the base library that haven’t made it to this one yet

If the base library gets features and they aren’t ported to this wrapper yet, you can include that as a dependency in addition to this one, and use the two together. For these purposes, the internal DrawerBuilder that this library uses is exposed through a property, and you can access it like so:

The internal AccountHeaderBuilder is exposed in the same way:

As for drawer items, you can just use the original API’s calls on the items that are returned:

 2,706 total views,  6 views today

(Visited 1,175 times, 2 visits today)

You May Also Like

About the Author: Android Developer

This is Mohammad I am Android Application Developer. I am the founder of Android Tutorial Online blog. I am programming lover and professional blogger from India. I spend most of my time doing programming and helping other programmers. This Android tutorial online blog for learning and share Android code.
My Chatbot
Powered by Replace Me