{"id":13694785,"url":"https://github.com/pranavpandey/dynamic-support","last_synced_at":"2025-04-07T12:09:43.120Z","repository":{"id":24226615,"uuid":"121538886","full_name":"pranavpandey/dynamic-support","owner":"pranavpandey","description":"A complete library to build Android apps with a built-in theme engine.","archived":false,"fork":false,"pushed_at":"2023-12-07T13:56:15.000Z","size":31176,"stargazers_count":263,"open_issues_count":2,"forks_count":29,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-04-14T05:42:56.786Z","etag":null,"topics":["activity","android","app","color","intro","library","material-design","support","theme-engine","widget"],"latest_commit_sha":null,"homepage":"https://dynamic.pranavpandey.com","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pranavpandey.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null},"funding":{"github":"pranavpandey","patreon":"pranavpandey","open_collective":"pranavpandeydev","ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["paypal.me/pranavpandeydev"]}},"created_at":"2018-02-14T17:20:51.000Z","updated_at":"2023-11-07T12:47:56.000Z","dependencies_parsed_at":"2023-12-10T15:03:18.154Z","dependency_job_id":"a5b7e165-a208-43e0-84e0-786cdacf2ef0","html_url":"https://github.com/pranavpandey/dynamic-support","commit_stats":{"total_commits":603,"total_committers":1,"mean_commits":603.0,"dds":0.0,"last_synced_commit":"f2993cd21a3242034ed34e164b8843cdddc3c562"},"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-support","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-support/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-support/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pranavpandey%2Fdynamic-support/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pranavpandey","download_url":"https://codeload.github.com/pranavpandey/dynamic-support/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247332291,"owners_count":20921850,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["activity","android","app","color","intro","library","material-design","support","theme-engine","widget"],"created_at":"2024-08-02T17:01:42.222Z","updated_at":"2025-04-07T12:09:43.036Z","avatar_url":"https://github.com/pranavpandey.png","language":"Java","readme":"\u003cimg src=\"./graphics/icon.png\" height=\"160\"\u003e\n\n# Dynamic Support\n\n[![License](https://img.shields.io/badge/license-Apache%202-4EB1BA.svg?)](https://www.apache.org/licenses/LICENSE-2.0.html)\n[![Release](https://img.shields.io/maven-central/v/com.pranavpandey.android/dynamic-support)](https://search.maven.org/artifact/com.pranavpandey.android/dynamic-support)\n\n**A complete library to build apps for Android 4.0 (API 14) and above with a built-in theme engine. \nIt is built on top of the latest [app compat library][android-support] to provide best \ncompatibility.** \n\n\u003e [!IMPORTANT]\n\u003eSince v2.0.0, it uses [AndroidX][androidx] so, first [migrate][androidx-migrate] your project \nto AndroidX.\n\u003cbr/\u003eSince v3.0.0, it is dependent on Java 8 due to the dependency on \n[DrawerLayout][drawer-layout].\n\u003cbr/\u003eSince v6.3.0, it is targeting Java 17 to provide maximum compatibility.\n\u003cbr/\u003eSince v6.4.0, the minimum SDK is Android 4.4 (API 19) to comply with the latest policies.\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"./graphics/play/screenshots/phone-1.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/play/screenshots/phone-3.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n\u003c/p\u003e\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"./graphics/play/screenshots/phone-5.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/play/screenshots/phone-6.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n\u003c/p\u003e\n\n---\n\n## Contents\n\n- [Installation](#installation)\n- [Usage](#usage)\n    - [Theme engine](#theme-engine)\n    - [Background aware](#background-aware)\n    - [Sample](#sample)\n    - [Dependency](#dependency)\n    - [Proguard](#proguard)\n- [Projects](#built-with-dynamic)\n- [License](#license)\n\n---\n\n## Installation\n\nIt can be installed by adding the following dependency to your `build.gradle` file:\n\n```groovy\ndependencies {\n    // For AndroidX enabled projects.\n    implementation 'com.pranavpandey.android:dynamic-support:6.4.1'\n\n    // For legacy projects.\n    implementation 'com.pranavpandey.android:dynamic-support:1.3.0'\n}\n```\n\n---\n\n## Usage\n\nIt is a collection of activities, fragments, widgets, views and some utility functions required \nto build a standard Android app. It also provides some built-in use cases like an intro screen, \ndrawer activity, about screen, collapsing app bar, navigation bar view, color picker, multiple \nlocales, runtime permissions, etc. which can be used and customised according to the requirements.\n\n\u003e For a complete reference, please read the [documentation][documentation].\n\n### Theme engine\n\nEach activity and widget can be themed by using the built-in theme engine with background aware \nfunctionality to avoid any visibility issues. Colors can be selected by using the provided \n[material design colors][material-design-colors] or by selecting a custom color from the built-in \npicker which supports HEX, HSV, ARGB and CMYK values.\n\n### Background aware\n\nBelow are the same colors applied on the light and dark backgrounds respectively. But the final \ncolor is adjusted according to the colored view background to provide best visibility.\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"./graphics/background-aware-2.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/background-aware-3.png\" width=\"280\" height=\"486\" hspace=\"2\"\u003e\n\u003c/p\u003e\n\n### Sample\n\nThis library is fully commented so, please check the individual classes or files for the \ndocumentation. Basic documentation will be available soon.\n\nCheckout the `sample` to know more about the basic implementation. \n\n### Dependency\n\nIt depends on the [dynamic-theme][dynamic-theme], [dynamic-locale][dynamic-locale] and \n[dynamic-preferences][dynamic-preferences] to perform various internal operations. \nSo, their functions can also be used to perform other useful operations.\n\n### Proguard\n\nThis library uses reflection at some places to theme widgets at runtime. So, their original name\nmust be preserved to theme them properly. It will automatically apply the appropriate rules if \nproguard is enabled in the project.\n\nThe following rules will be applied by this library:\n\n```yml\n# Keep application class.\n-keep public class * extends android.app.Application\n\n# Keep methods in Activity that could be used in the XML.\n-keepclassmembers class * extends android.app.Activity {\n    public void *(android.view.View);\n}\n\n# Keep support library classes.\n#-keep class android.support.v4.widget.** { *; }\n#-keep class android.support.v7.widget.** { *; }\n#-keep class android.support.design.widget.** { *; }\n#-keep class android.support.design.internal.** { *; }\n\n# Keep AndroidX classes.\n-keep class androidx.core.widget.** { *; }\n#-keep class androidx.appcompat.widget.** { *; }\n-keep class androidx.appcompat.view.menu.** { *; }\n-keep class androidx.recyclerview.widget.** { *; }\n-keep class androidx.viewpager.widget.** { *; }\n\n# Keep Material Components classes.\n-keep class com.google.android.material.internal.** { *; }\n-keep class com.google.android.material.navigation.** { *; }\n-keep class com.google.android.material.textfield.** { *; }\n\n# Keep all the Dynamic Support models.\n-keep class com.pranavpandey.android.dynamic.support.model.** { *; }\n-keepclassmembers class * implements android.os.Parcelable {\n    static ** CREATOR;\n}\n\n# Dynamic Theme rules\n\n# Gson uses generic type information stored in a class file when working with fields.\n# Proguard removes such information by default, so configure it to keep all of it.\n-keepattributes Signature\n\n# For using Gson annotation.\n-keepattributes *Annotation*\n\n# Gson specific classes.\n-keep class sun.misc.Unsafe { *; }\n-keep class com.google.gson.** { *; }\n```\n\n---\n\n## Built with Dynamic\n\nAll of my apps are using some or all part of this library. You can download them via Google Play. \nPlease email me if you are using this library and want to feature your app here. Also, please \ncheckout the `Rotation` and `Everyday` apps to experience the full potential of this library.\n\n\u003cp align=\"left\"\u003e\n  \u003cimg src=\"./graphics/apps/alexandermadani-eznotes.png\" width=\"140\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/apps/pranavpandey-rotation.png\" width=\"140\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/apps/pranavpandey-everyday.png\" width=\"140\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/apps/pranavpandey-palettes.png\" width=\"140\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/apps/pranavpandey-barquode.png\" width=\"140\" hspace=\"2\"\u003e\n  \u003cimg src=\"./graphics/apps/pranavpandey-zerocros.png\" width=\"140\" hspace=\"2\"\u003e\n\u003c/p\u003e\n\n### Supported\n\n- [EZ Notes][ez-notes]\n\n### Developed\n\n- [Rotation][rotation]\n- [Everyday][everyday]\n- [Palettes][palettes]\n- [Barquode][barquode]\n- [Zerocros][zerocros]\n\n---\n\n## Translations\n\n- German (de) - Flubberlutsch\n- French (fr) - Nitesh Jha | Others\n- Hindi (hi) - Siddh Narhari\n- Indonesian (in) - Gamal Kevin A\n- Italian (it) - Nicola\n- Portuguese (pt) - Jorge Alexandre | Matheus Coelho\n- Russian (ru) - Maxim Anisimov\n- Spanish (es) - Dave\n- Turkish (tr) - Fatih Fırıncı\n- Chinese (Simplified) (zh-rCN) - 残念\n- Chinese (Traditional) (zh-rTW) - 會呼吸的風 | 人工知能\n\n---\n\n## Author\n\nPranav Pandey\n\n[![GitHub](https://img.shields.io/github/followers/pranavpandey?label=GitHub\u0026style=social)](https://github.com/pranavpandey)\n[![Follow on Twitter](https://img.shields.io/twitter/follow/pranavpandeydev?label=Follow\u0026style=social)](https://twitter.com/intent/follow?screen_name=pranavpandeydev)\n[![Donate via PayPal](https://img.shields.io/static/v1?label=Donate\u0026message=PayPal\u0026color=blue)](https://paypal.me/pranavpandeydev)\n\n---\n\n## License\n\n    Copyright 2018-2024 Pranav Pandey\n\n    Licensed under the Apache License, Version 2.0 (the \"License\");\n    you may not use this file except in compliance with the License.\n    You may obtain a copy of the License at\n\n       http://www.apache.org/licenses/LICENSE-2.0\n\n    Unless required by applicable law or agreed to in writing, software\n    distributed under the License is distributed on an \"AS IS\" BASIS,\n    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n    See the License for the specific language governing permissions and\n    limitations under the License.\n\n\n[android-support]: https://developer.android.com/topic/libraries/support-library/features.html\n[androidx]: https://developer.android.com/jetpack/androidx\n[androidx-migrate]: https://developer.android.com/jetpack/androidx/migrate\n[drawer-layout]: https://developer.android.com/jetpack/androidx/releases/drawerlayout\n[documentation]: https://pranavpandey.github.io/dynamic-support\n[material-design-colors]: https://material.io/guidelines/style/color.html\n[dynamic-theme]: https://github.com/pranavpandey/dynamic-theme\n[dynamic-locale]: https://github.com/pranavpandey/dynamic-locale\n[dynamic-preferences]: https://github.com/pranavpandey/dynamic-preferences\n[ez-notes]: https://play.google.com/store/apps/details?id=com.pristineusa.android.speechtotext\n[rotation]: https://play.google.com/store/apps/details?id=com.pranavpandey.rotation\n[everyday]: https://play.google.com/store/apps/details?id=com.pranavpandey.calendar\n[palettes]: https://play.google.com/store/apps/details?id=com.pranavpandey.theme\n[barquode]: https://play.google.com/store/apps/details?id=com.pranavpandey.matrix\n[zerocros]: https://play.google.com/store/apps/details?id=com.pranavpandey.tictactoe\n","funding_links":["https://github.com/sponsors/pranavpandey","https://patreon.com/pranavpandey","https://opencollective.com/pranavpandeydev","paypal.me/pranavpandeydev","https://paypal.me/pranavpandeydev"],"categories":["Java"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavpandey%2Fdynamic-support","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpranavpandey%2Fdynamic-support","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpranavpandey%2Fdynamic-support/lists"}