{"id":13428570,"url":"https://github.com/oneHamidreza/MeowBottomNavigation","last_synced_at":"2025-03-16T01:32:42.022Z","repository":{"id":43714445,"uuid":"169960567","full_name":"oneHamidreza/MeowBottomNavigation","owner":"oneHamidreza","description":"Android Meow Bottm Navigation","archived":false,"fork":false,"pushed_at":"2023-10-06T05:46:36.000Z","size":4123,"stargazers_count":1337,"open_issues_count":44,"forks_count":200,"subscribers_count":13,"default_branch":"master","last_synced_at":"2024-10-28T07:48:16.318Z","etag":null,"topics":["android","bottomnavigationview","curved","library","material","navigaion"],"latest_commit_sha":null,"homepage":"http://etebarian.com","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/oneHamidreza.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2019-02-10T09:11:55.000Z","updated_at":"2024-10-27T08:06:26.000Z","dependencies_parsed_at":"2022-08-22T17:10:38.310Z","dependency_job_id":"4cd6ad0f-f4d3-4c48-baac-242f154583d2","html_url":"https://github.com/oneHamidreza/MeowBottomNavigation","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oneHamidreza%2FMeowBottomNavigation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oneHamidreza%2FMeowBottomNavigation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oneHamidreza%2FMeowBottomNavigation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/oneHamidreza%2FMeowBottomNavigation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/oneHamidreza","download_url":"https://codeload.github.com/oneHamidreza/MeowBottomNavigation/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243814901,"owners_count":20352037,"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":["android","bottomnavigationview","curved","library","material","navigaion"],"created_at":"2024-07-31T01:01:00.799Z","updated_at":"2025-03-16T01:32:41.641Z","avatar_url":"https://github.com/oneHamidreza.png","language":"Kotlin","funding_links":[],"categories":["Libraries"],"sub_categories":[],"readme":"# Meow Bottom Navigation\nA simple \u0026 curved \u0026 material bottom navigation for Android written in **Kotlin** with ♥ .\n\n![](https://github.com/shetmobile/MeowBottomNavigation/raw/master/resources/Preview.gif)\n\n## Download\n\nUpdate your `build.gradle` (project path) like below :\n\n```groovy\nbuildscript {\n    repositories {\n        jcenter()\n    }\n}\n```\n\nUpdate your `build.gradle` (module path) like below :\n\n```groovy\ndependencies {\n  implementation 'com.etebarian:meow-bottom-navigation:1.3.1'\n}\n```\n\nUse androidx by adding this lines to `gradle.properties`. If you want more info, just google **AndroidX**.\n\n```properties\nandroid.useAndroidX=true\nandroid.enableJetifier=true\n```\n\nIf you want to add this library to a JAVA Project, you must add kotlin library to `build.gradle`.\n\n```groovy\ndependencies {\n    implementation \"org.jetbrains.kotlin:kotlin-stdlib-jdk7:1.3.61\"\n}\n```\n## 😍 Donate \u0026 Support\n\nWe are developing this framework in open source community without financial planning but the maintenance \u0026 preparing updates at periodic times is Time-consuming.\nIf you like this project and you want to give us peace of mind, you can support us by clicking this button :\n\n\u003cp\u003e\n\u003ca href=\"https://cutt.ly/9jP8U6q\"\u003e\n\u003cimg width=\"20%\" src=\"https://raw.githubusercontent.com/oneHamidreza/Meow-Framework-MVVM/master/Resources/img_support.png\"/\u003e\n\u003c/a\u003e\n\u003c/p\u003e\n\n## Usage\n\nAdd Meow Bottom Navigation in you layout xml file.\n\n```xml\n\u003cmeow.meowbottomnavigation.MeowBottomNavigation\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"wrap_content\"/\u003e\n```\n\nAdd menu items in code.\n\n```kotlin\nval bottomNavigation = findView(R.id.bottomNavigation)\nbottomNavigation.add(MeowBottomNavigation.Model(1, R.drawable.ic_home))\nbottomNavigation.add(MeowBottomNavigation.Model(2, R.drawable.ic_explore))\nbottomNavigation.add(MeowBottomNavigation.Model(3, R.drawable.ic_message))\n```\n\nAdd vectorDrawables.useSupportLibrary = true to your build.gradle inside `defaultConfig{ ... }` to use vector drawable icons.\n\n## Customization\n\n```xml\n\u003ccom.etebarian.meowbottomnavigation.MeowBottomNavigation\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"wrap_content\"\n    app:mbn_circleColor=\"#ffffff\"\n    app:mbn_backgroundBottomColor=\"#ffffff\"\n    app:mbn_countBackgroundColor=\"#ff6f00\"\n    app:mbn_countTextColor=\"#ffffff\"\n    app:mbn_countTypeface=\"fonts/SourceSansPro-Regular.ttf\"\n    app:mbn_defaultIconColor=\"#90a4ae\"\n    app:mbn_rippleColor=\"#2f424242\"\n    app:mbn_selectedIconColor=\"#3c415e\"\n    app:mbn_shadowColor=\"#1f212121\"\n    app:mbn_hasAnimation=\"true\"    \n/\u003e\n```\n\n- You can change this properties in **Kotlin/Java** Realtime⌚. \n\n## Listeners\n\nUse `setOnShowListener()` function to access when a cell has been shown.\n\n```kotlin\nbottomNavigation.setOnShowListener {\n    // YOUR CODES\n}\n```\n\nUse `setOnClickMenuListener()` function to access when a cell has been clicked.\n\n```kotlin     \nbottomNavigation.setOnClickMenuListener {\n    // YOUR CODES\n}\n```\n\nIf you are Java Developer, use this examples :\n\n```java\nbottomNavigation.setOnClickMenuListener(new Function1\u003cMeowBottomNavigation.Model, Unit\u003e() {\n            @Override\n            public Unit invoke(MeowBottomNavigation.Model model) {\n                // YOUR CODES\n                return null;\n            }\n        });\n\nbottomNavigation.setOnShowListener(new Function1\u003cMeowBottomNavigation.Model, Unit\u003e() {\n            @Override\n            public Unit invoke(MeowBottomNavigation.Model model) {\n                // YOUR CODES\n                return null;\n            }\n        });\n```\n\n## Counter Badge\n\nSet counter badge on a specific cell by `setCount(Int,String)`.\n\n```kotlin\nbottomNavigation.setCount(CELL_ID, YOUR_STRING)\n```\n\nClear counter badge on a specific cell by `clearCount(Int)`.\n\n```kotlin\nbottomNavigation.clearCount(CELL_ID)\n```\n\nClear all counter badges on a specific cell by `clearCount(Int)`.\n\n```kotlin\nbottomNavigation.clearAllCounts(TAB_ID)\n```\n\n## Set Default CELL\n\nUse this function :\n\n```kotlin\nbottomNavigation.show(CELL_ID)\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FoneHamidreza%2FMeowBottomNavigation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FoneHamidreza%2FMeowBottomNavigation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FoneHamidreza%2FMeowBottomNavigation/lists"}