Shoal Exonym CoCo

Application Functionality

### Core Functionality

- Life Countdown: Calculates lived time and remaining time.

- Dual Mode Switching: Death countdown mode vs. life countdown mode.

- Custom Events: Add birthdays, anniversaries, and custom important dates.

- Holiday Countdown: Built-in countdown timer for important holidays.

- Desktop Widget: Displays life progress on the home screen.

### Interface Features

- Immersive Status Bar: Automatically adapts to dark/light themes.

- Smooth Animations: Beautiful animations for page transitions and button clicks.

- Dual Theme Design:

- Death Mode: Dark theme, emphasizing the preciousness of life.

- Life Mode: Light theme, showcasing the beauty of life.

- Card Flip Effect: 3D flip animation during mode switching.

### Data Display

- Detailed Statistics: Heart rate, respiratory rate, blink rate.

- Percentage Display: Percentage of lived time and remaining time.

- Real-time Updates: Countdown automatically updates every minute.

- Zero-fill format: All numbers are displayed as two digits (e.g., 05 instead of 5).

## User Guide

### First Use
1. A welcome dialog box will appear after launching the application.

2. Click the "Set Birthday" button and select your birth date.

3. Set your life expectancy (default 80 years).

4. Click "Start Experience" to enter the main interface.

### Main Interface Operations

- Mode Switching: Click the switch button at the top to switch between Death Mode and Life Mode.

- View Statistics: Detailed statistics are displayed for each mode.

- Settings Adjustment: Click the settings button to modify your birthday and life expectancy.

### Custom Events
1. Click the "Custom Countdown" button on the main interface.

2. Click the "Add Event" button.

3. Fill in the event information:

- Event Name

- Event Type (Birthday/Anniversary/Custom)

- Event Notes (Optional)

- Select Date

4. After saving, the event will be displayed in the list and a real-time countdown will begin.

### Holiday Countdown

1. Click the "Holiday Countdown" button on the main interface.

2. View the built-in countdowns for important holidays.

3. Includes holidays such as Chinese New Year, Christmas, and New Year's Day.

## Technical Features

### Development Technology

- Language: Pure Java development, no third-party framework dependencies

- Minimum Supported Version: Android 6.0 (API 24)

- Target Version: Android 14 (API 35)

- UI Components: RecyclerView, CardView, Custom View

### Data Storage

- SharedPreferences: Local storage of user settings and event data

- Gson Serialization: JSON serialization and storage of complex objects

- Automatic Synchronization: Data is saved in real time and not lost upon application restart.

### Performance Optimization

- Memory Management: Automatic resource cleanup when Activity is destroyed

- Timer Optimization: Only updates visible countdown components

- Smooth Animation: Hardware acceleration ensures 60fps animation.