{"id":13607958,"url":"https://github.com/adrielcafe/krumbsview","last_synced_at":"2025-04-23T16:33:58.405Z","repository":{"id":149190540,"uuid":"171552930","full_name":"adrielcafe/krumbsview","owner":"adrielcafe","description":"🍞 The ultimate breadcrumbs view for Android!","archived":false,"fork":false,"pushed_at":"2021-08-09T01:36:41.000Z","size":2139,"stargazers_count":186,"open_issues_count":1,"forks_count":10,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-08-01T19:46:20.110Z","etag":null,"topics":["android","android-library","android-ui","android-view","breadcrumb","breadcrumb-navigation","breadcrumbs","kotlin","kotlin-android","kotlin-library"],"latest_commit_sha":null,"homepage":"","language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/adrielcafe.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"ko_fi":"adrielcafe"}},"created_at":"2019-02-19T21:30:16.000Z","updated_at":"2024-04-27T23:48:42.000Z","dependencies_parsed_at":null,"dependency_job_id":"2d86ee46-9088-43f5-ac27-663a9069f411","html_url":"https://github.com/adrielcafe/krumbsview","commit_stats":null,"previous_names":[],"tags_count":10,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrielcafe%2Fkrumbsview","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrielcafe%2Fkrumbsview/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrielcafe%2Fkrumbsview/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/adrielcafe%2Fkrumbsview/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/adrielcafe","download_url":"https://codeload.github.com/adrielcafe/krumbsview/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223521977,"owners_count":17159346,"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","android-library","android-ui","android-view","breadcrumb","breadcrumb-navigation","breadcrumbs","kotlin","kotlin-android","kotlin-library"],"created_at":"2024-08-01T19:01:23.126Z","updated_at":"2024-11-07T13:31:17.103Z","avatar_url":"https://github.com/adrielcafe.png","language":"Kotlin","funding_links":["https://ko-fi.com/adrielcafe"],"categories":["Kotlin"],"sub_categories":[],"readme":"[![JitPack](https://jitpack.io/v/adrielcafe/KrumbsView.svg)](https://jitpack.io/#adrielcafe/KrumbsView) \n[![API](https://img.shields.io/badge/API-14%2B-brightgreen.svg?style=flat)](https://android-arsenal.com/api?level=14)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) \n[![Android Arsenal](https://img.shields.io/badge/Android%20Arsenal-KrumbsView-green.svg?style=flat)]( https://android-arsenal.com/details/1/7562)\n\n# KrumbsView\nThe ultimate breadcrumbs view for Android!\n\nInspired by [JotterPad](https://play.google.com/store/apps/details?id=com.jotterpad.x)'s breadcrumbs.\n\n\u003cimg src=\"demo.gif\" width=\"400px\"/\u003e\n\nFeatures:\n\n- [X] Custom typeface (from /assets and /res/font folders, also works with [Downloadable Fonts](https://developer.android.com/guide/topics/ui/look-and-feel/downloadable-fonts))\n- [X] Customisable (text colors, text size, separator icon)\n- [X] Cool animations\n- [X] Swipe right to go back to the previous item\n- [X] Survive Activity recreations\n- [X] Extensible (open classes and protected members, extend it to get the job done!)\n\n## How to use\n\n### Import to your project\n\nFirst, add it in your root build.gradle at the end of repositories:\n\n```gradle\nallprojects {\n    repositories {\n        ...\n        maven { url 'https://jitpack.io' }\n    }\n}\n```\n\nNext, add the dependency to your app modules:\n\n```gradle\ndependencies {\n    ...\n    implementation 'com.github.adrielcafe:krumbsview:$latestVersion'\n}\n```\n\n#### Current version: \n\n[![JitPack](https://jitpack.io/v/adrielcafe/KrumbsView.svg)](https://jitpack.io/#adrielcafe/KrumbsView)\n\n### XML\n```xml\n\u003ccafe.adriel.krumbsview.KrumbsView\n    ...\n    app:krumbsStartItem=\"[string]\"\n    app:krumbsPaddingStartItem=\"[dimension]\"\n    app:krumbsPreviousItemCharacters=\"[integer]\"\n    app:krumbsTypeface=\"[string|font]\"\n    app:krumbsTextSize=\"[dimension]\"\n    app:krumbsBoldText=\"[true|false]\"\n    app:krumbsCurrentItemTextColor=\"[color]\"\n    app:krumbsPreviousItemTextColor=\"[color]\"\n    app:krumbsSeparatorTintColor=\"[color]\"\n    app:krumbsSeparatorIcon=\"[drawable]\"\n    app:krumbsAnimationType=\"[slideLeftRight|fadeInOut|growShrink]\"\n    app:krumbsAnimationDuration=\"[shortDuration|longDuration]\"/\u003e\n```\n\nExample:\n```xml\n\u003ccafe.adriel.krumbsview.KrumbsView\n    android:id=\"@+id/krumbsView\"\n    android:layout_width=\"match_parent\"\n    android:layout_height=\"wrap_content\"\n    android:background=\"@color/colorPrimary\"\n    app:krumbsStartItem=\"Home\"\n    app:krumbsTypeface=\"@font/quicksand\"\n    app:krumbsTextSize=\"24sp\"\n    app:krumbsCurrentItemTextColor=\"@color/colorAccent\"\n    app:krumbsPreviousItemTextColor=\"@color/colorPrimaryDark\"\n    app:krumbsSeparatorTintColor=\"@color/colorPrimaryDark\"\n    app:krumbsSeparatorIcon=\"@drawable/ic_play_arrow\"\n    app:krumbsAnimationType=\"growShrink\"\n    app:krumbsAnimationDuration=\"longDuration\"/\u003e\n```\n\n### Kotlin/Java\n```kotlin\nwith(krumbsView){\n    size\n    getItems()\n    getCurrentItem()\n    addItem(Krumb(\"Lorem Ipsum\"))\n    removeLastItem()\n    removeAllItems()\n    goToFirstItem()\n    setOnPreviousItemClickListener { /* ... */ } // Swipe right also triggers this listener\n    \n    // All XML options are available\n    setTypeface(\"fonts/quicksand.ttf\") // From /assets folder\n    setTypeface(R.font.quicksand) // From /res/font folder\n    setTypeface(MyCustomTypeface)\n    setTextSizeSp(20f)\n    setTextSizePx(40f)\n    setBoldText(true)\n    setPaddingStartItem(10f)\n    setPreviousItemCharacters(2)\n    setCurrentItemTextColor(Color.WHITE)\n    setPreviousItemTextColor(color(R.color.transparent_white))\n    setSeparatorTintColor(color(R.color.transparent_white))\n    setSeparatorIcon(R.drawable.ic_keyboard_arrow_right)\n    setAnimationType(KrumbsAnimationType.GROW_SHRINK)\n    setAnimationDuration(KrumbsAnimationDuration.SHORT)\n}\n```\n\nYou can also use your custom Krumb implementation:\n\n```kotlin\ndata class MyKrumb(val id: Int, \n                   val folderName: String, \n                   val createdAt: Date) : Krumb(folderName)\n\nwith(krumbsView){\n    addItem(MyKrumb(123, \"Folder XYZ\", now))\n\n    val myKrumb = getCurrentItem() as MyKrumb\n}\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadrielcafe%2Fkrumbsview","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadrielcafe%2Fkrumbsview","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadrielcafe%2Fkrumbsview/lists"}