A high-polish, local-first Android application designed to help you define, track, and achieve your life goals. Built with a modern iOS 18-inspired aesthetic, SelfGoals combines powerful functionality with a fluid, tactile user experience.
- iOS 18 Design Language: Modular "widget" layouts, glassmorphism, bold typography, and fluid squircle shapes.
- Custom Adaptive Icon: A unique brand identity featuring a growth-oriented design with a vibrant blue-to-purple gradient.
- Haptic Feedback: Tactile "clicks" and physical confirmation for key interactions (toggles, archiving, adding items) for a premium, responsive feel.
- Intelligent Analytics: Real-time activity dashboard showing goal and task completion rates via modular overview tiles.
- Goal Management: Create, edit, and track goals with detailed descriptions, custom categories, and Priority status (marked with a ⭐).
- Milestones (Sub-tasks): Break down large goals into smaller, actionable milestones with automated progress tracking and manual reordering (Up/Down controls).
- Advanced Sorting: Organize your dashboard by Deadline, Progress, Creation Date, Name, or Priority.
- Custom Theme Control: Persistent Light/Dark mode settings using Jetpack DataStore that remember your preference across app restarts.
- Goal Archives: Keep your dashboard focused by archiving completed goals. A dedicated view lets you manage and unarchive your history.
- Search & Filtering: Dynamic, iOS-style search bar and interactive category tags for instant goal discovery.
- Smart Reminders: Schedule local notifications using
WorkManagerto stay on top of your deadlines. - Localization Ready: All UI strings are externalized to
res/values/strings.xml, ready for translation. - Visual Deadlines: Integrated Material 3 DatePicker with overdue highlighting (Red alert for past-due tasks).
- Data Export: Share a comprehensive, beautifully formatted text summary of your goals, milestones, and stats with other apps.
| Dashboard | Goal Details |
|---|---|
 |
 |
- Language: Kotlin 1.9.22
- UI Framework: Jetpack Compose (Declarative UI)
- Architecture: MVVM (Model-View-ViewModel)
- Dependency Injection: Hilt 2.50
- Local Persistence: Room Database 2.6.1 & Jetpack DataStore
- Background Tasks: WorkManager (for robust reminders)
- Asynchronous Flows: Kotlin Coroutines & StateFlow
- Testing: JUnit 4, MockK, Turbine, and Hilt Testing
- Build System: Gradle 9.5.0 with KSP (Kotlin Symbol Processing)
SelfGoals/
├── app/
│ ├── src/main/
│ │ ├── java/com/example/selfgoals/
│ │ │ ├── data/ # Entities, DAOs, and Repositories (Settings & Goals)
│ │ │ ├── di/ # Hilt Dependency Injection modules
│ │ │ ├── ui/ # Compose Screens (Dashboard), ViewModels, and Themes
│ │ │ ├── worker/ # WorkManager background workers
│ │ │ └── utils/ # Helpers (Notifications, formatting)
│ │ ├── res/values/ # externalized strings.xml and colors
│ │ └── AndroidManifest.xml # App manifest and configuration
│ ├── src/test/ # DashboardViewModel Unit Tests
│ └── src/androidTest/ # Compose UI Instrumented Tests
└── build.gradle.kts # Root project dependencies
- Clone the repository.
- Open the project in Android Studio Hedgehog or newer.
- Sync Gradle and run on an emulator or physical device (API 24+).
- Run Tests: Execute
./gradlew testfor unit tests or./gradlew connectedAndroidTestfor UI tests.
- Visuals: Added high-resolution screenshots of the dashboard and goal details.
- Persistence: Integrated Jetpack DataStore for user preferences.
- Brand Identity: Custom-designed adaptive icon reflecting the philosophy of growth and achievement.
- Robust Testing: Full suite of Unit and UI tests implemented. Verified successfully on AVD (
SelfGoalsTest). - Visual Verification: High-resolution screenshots confirmed consistent UI across boot and post-test states.
- Localization Ready: 100% of UI strings moved to resource files.
- Architecture: Refactored for maximum testability with constructor injection.
SelfGoals is built with care using modern Android standards and a focus on UX.