# gjiazhe/WaveSideBar

An Index Side Bar With Wave Effect

Repository: https://github.com/gjiazhe/WaveSideBar
Canonical: https://ross.abutalabs.com/products/wavesidebar
Language: Java
License: MIT
License Family: permissive
Last push: 2017-04-05T06:48:07+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3662, "days_push": 3437, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1257, forks 195 (observed 2026-08-28T04:04:09.426769+00:00)

## What it is
An Android UI library providing a side bar with an animated wave effect for alphabetical or custom index navigation, commonly used in contacts-style list screens. It is distributed via Gradle and supports customizable text, position, and touch listeners.

## Use cases
- add an A-Z quick scroll sidebar to an Android contacts list
- navigate a long list by letter with a wave animation
- create a custom index sidebar with Japanese kana characters
- place an index bar on the left side of the screen
- trigger actions when the user touches sidebar letters

## When to choose
- you need an Android index side bar with a polished wave animation
- you want a simple drop-in view configurable via XML attributes
- you need custom index characters beyond A-Z

## When to avoid
- you need an iOS, web, or cross-platform component
- your project uses Kotlin-first Jetpack Compose UI
- you need actively maintained software with recent releases

## Facets
- artifact type: library
- maturity: maintenance
- function: ui-components, animation
- domain: mobile-development, android-tools
- platform: jvm
- tags: android-view, sidebar, index-navigation, contacts, wave-effect, android, mobile

## Member repositories
- gjiazhe/WaveSideBar (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:09.426769+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T05:07:11.577460+00:00, confidence not recorded.
  - readme: https://github.com/gjiazhe/WaveSideBar (fetched 2026-08-28T04:04:09.426769+00:00, sha 7ab2775506e4)
- Data as of 2026-08-30T08:39:29.467469+00:00.