A lightweight, customizable Android UI library that adds a "shining" effect to buttons, similar to Twitter's heart animation.

• Customizable Shapes: Use any PNG mask as a button shape.
• Vibrant Effects: Adjust shine color, size, count, and distance.
• Interactive: Smooth animations for both clicking and shining.
• Random Colors: Option to enable random colors for the shine effect.
• Dialog Support: Works seamlessly inside Dialogs.
• Lightweight: Minimal dependencies and easy to integrate.

Add the dependency to your app/build.gradle file:

dependencies {
    implementation 'com.sackcentury:shinebutton:0.2.1'
}

<dependency>
  <groupId>com.sackcentury</groupId>
  <artifactId>shinebutton</artifactId>
  <version>0.2.1</version>
  <type>aar</type>
</dependency>

The simplest way to use ShineButton is in your XML layout:

<com.sackcentury.shinebuttonlib.ShineButton
    android:id="@+id/shine_button"
    android:layout_width="50dp"
    android:layout_height="50dp"
    android:layout_centerInParent="true"
    android:src="@android:color/darker_gray"
    app:btn_color="@android:color/darker_gray"
    app:btn_fill_color="#FF6666"
    app:allow_random_color="false"
    app:siShape="@raw/like" />

ShineButton shineButton = (ShineButton) findViewById(R.id.shine_button);
shineButton.init(activity);

Or create it dynamically:

ShineButton shineButtonJava = new ShineButton(this);
shineButtonJava.setBtnColor(Color.GRAY);
shineButtonJava.setBtnFillColor(Color.RED);
shineButtonJava.setShapeResource(R.raw.heart);
shineButtonJava.setAllowRandomColor(true);

LinearLayout.LayoutParams layoutParams = new LinearLayout.LayoutParams(100, 100);
shineButtonJava.setLayoutParams(layoutParams);
linearLayout.addView(shineButtonJava);

If you are using ShineButton inside a Dialog, call setFixDialog(dialog) to ensure it renders correctly:

shineButton.setFixDialog(dialog);

Small Shine	More Shine	Others

We are continuously working to improve ShineButton. Here is what we have planned:

• Kotlin Migration: Fully convert the library to Kotlin for better safety and modern features.
• Jetpack Compose: Provide a native Composable version of ShineButton.
• Vector Support: Allow using VectorDrawable as shape masks.
• Custom Animators: Support for custom easing and path-based animations.
• Material 3: Update the demo app with Material 3 design and dynamic colors.
• Performance: Further optimize canvas operations and memory allocation.

• Android API Level 14+ (Android 4.0+)

• Inspired by fave-button for iOS.
• Uses EasingInterpolator for smooth animations.
• Concepts from android-shape-imageview.

MIT License. See LICENSE for details.