The application utilizes a customized Material 3 implementation that emphasizes fluid motion and smart layout adaptation. Key features include a centralized snackbar system that dodges floating action buttons, a card system with dynamic corner shaping based on list position, and a suite of playful, physics-based animations for loaders and buttons.
What it is: The foundational wrapper for every screen in the app.Key Feature: It automatically handles the top app bar and scrolling behavior. Uniquely, the “Back” button in the top bar renders with a randomized expressive shape (flower, clover, diamond, etc.) every time the screen loads, adding a playful touch.Variants:
What it is: A smart notification container that positions itself dynamically to avoid overlapping UI elements.Behavior:
FAB Awareness: If a Floating Action Button is visible, the snackbar floats above it.
Nav Bar Awareness: If the bottom navigation is visible, the snackbar floats above it.
Fallback: If neither is present, it sits at the bottom with safe padding.
Style: Renders as a “pill” shape with a high-elevation shadow. It includes special logic to show a trash icon if the message contains the word “uninstalled”.
What it is: A versatile card system for displaying statistics and app lists.Dynamic Shaping: These cards use a GroupPosition logic. If cards are stacked, the top card has rounded top corners, the middle card has sharp corners, and the bottom card has rounded bottom corners.Variants:
Component
Usage
DashboardCard
Large display for primary stats (e.g., Screen Time) with comparison text.
CompactStatCard
Smaller square card for secondary metrics (e.g., Unlocks).
AppListItemCard
Rows representing apps. Changes color to red if the app is uninstalled.
AppUsageCard
A complex card showing a list of top apps with progress bars.
What it is: A Floating Action Button that uses spring physics for interaction.Behavior: When pressed, the button scales down slightly and (for the extended version) rotates subtly using a bouncy spring animation, providing tactile feedback.
