Need help with dynamic-support?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

231 Stars 26 Forks Apache License 2.0 414 Commits 1 Opened issues


A complete library to build Android apps with a built-in theme engine.

Services available


Need anything else?

Contributors list

# 154,748
411 commits

Dynamic Support

License Build Status Release

A complete library to build apps for Android 4.0 (API 14) and above with a built-in theme engine. It is built on top of the latest app compat library to provide best compatibility.

Since v2.0.0, it uses AndroidX so, first migrate your project to AndroidX.
Since v3.0.0, it is dependent on Java 8 due to the dependency on DrawerLayout.





It can be installed by adding the following dependency to your

dependencies {
    // For AndroidX enabled projects.
    implementation ''

// For legacy projects.
implementation ''



It is a collection of activities, fragments, widgets, views and some utility functions required to build a standard Android app. It also provides some in-built use cases like an intro screen, drawer activity, about screen, collapsing app bar, bottom navigation, color picker, multiple locales, runtime permissions, etc. which can be used and customised according to the need.

For complete reference, please read the documentation.

Theme engine

Each activity and widget can be themed by using the in-built theme engine with background aware functionality to avoid any visibility issues. Colors can be selected by using the provided material design colors or by selecting a custom color from the in-built picker which supports HEX, HSV and ARGB values.

Background aware

Below are the same colors applied on the light and dark backgrounds respectively. But the final color is adjusted according to the colored view background to provide best visibility.



This library is fully commented so, please check the individual classes or files for the documentation. Basic documentation will be available soon.

Checkout the

to know more about the basic implementation.


It depends on the dynamic-theme, dynamic-locale and dynamic-preferences to perform various internal operations. So, their functions can also be used to perform other useful operations.


This library uses reflection at some places to theme widgets at runtime. So, their original name must be preserved to theme them properly. It will automatically apply the appropriate rules if proguard is enabled in the project.

The following rules will be applied by this library:

# Keep application class.
-keep public class * extends

Keep methods in Activity that could be used in the XML.

-keepclassmembers class * extends { public void *(android.view.View); }

Keep support library classes.

#-keep class** { ; } #-keep class** { ; } #-keep class { *; } #-keep class** { *; }

Keep AndroidX classes.

-keep class androidx.core.widget.** { ; } #-keep class androidx.appcompat.widget.** { ; } -keep class { ; } -keep class androidx.recyclerview.widget.** { ; } -keep class androidx.viewpager.widget. { *; }

Keep Material Components classes.

-keep class** { ; } -keep class** { ; } -keep class { *; }

Keep all the Dynamic Support models.

-keep class** { ; } -keepclassmembers class * implements android.os.Parcelable { static * CREATOR; }

Dynamic Theme rules

Gson uses generic type information stored in a class file when working with fields.

Proguard removes such information by default, so configure it to keep all of it.

-keepattributes Signature

For using Gson annotation.

-keepattributes Annotation

Gson specific classes.

-keep class sun.misc.Unsafe { *; } -keep class** { *; }

Apps using Dynamic Support

All of my apps are using some or all part of this library. You can download them from Google Play. Please email me if you are using this library and want to feature your app here. Also, please checkout the

apps to experience the full potential of this library.



  • German (de) - Flubberlutsch
  • Hindi (hi) - Siddh Narhari
  • Indonesian (in) - Gamal Kevin A
  • Italian (it) - Nicola
  • Portuguese (pt) - Jorge Alexandre | Matheus Coelho
  • Russian (ru) - Maxim Anisimov
  • Spanish (es) - Dave
  • Turkish (tr) - Fatih Fırıncı
  • Chinese (Simplified) (zh-rCN) - 残念
  • Chinese (Traditional) (zh-rTW) - 會呼吸的風


Pranav Pandey

GitHub Follow on Twitter Donate via PayPal


Copyright 2018-2021 Pranav Pandey

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

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.