1356/lifetimer

LifeTimer Flutter Project

Overview

LifeTimer is a gamified life countdown app where users create a bucket list (up to 20 entries) and start a 1356-day countdown once they finalize their goals. The countdown cannot be stopped, paused, or extended.

Project Structure

This Flutter project follows a clean architecture with feature-based organization:

lib/
├── main.dart                    # App entry point
├── bootstrap/                   # Initialization
│   ├── bootstrap.dart
│   ├── env.dart
│   └── supabase_client.dart
├── core/                        # Cross-cutting concerns
│   ├── theme/
│   │   └── app_theme.dart
│   ├── routing/
│   │   └── app_router.dart
│   ├── widgets/
│   │   └── primary_button.dart
│   └── state/
│       └── providers.dart
├── data/                        # Data layer
│   ├── models/
│   │   ├── user_model.dart
│   │   └── goal_model.dart
│   └── repositories/
│       └── auth_repository.dart
└── features/                    # Feature modules
    ├── auth/
    ├── onboarding/
    ├── goals/
    ├── countdown/
    ├── social/
    ├── profile/
    └── settings/

Tech Stack

• Framework: Flutter
• State Management: Riverpod
• Backend: Supabase (Auth, Database, Storage, Realtime)
• Navigation: Go Router
• Local Storage: Hive
• Maps: Google Maps Flutter
• Notifications: Flutter Local Notifications

Getting Started

Prerequisites

1. Flutter SDK (>=3.10.0)
2. Dart SDK (>=3.0.0)
3. Supabase project

Setup

1. Clone this repository

2. Install dependencies:

   flutter pub get
   

3. Set up environment variables: Create a .env file or use build arguments:

   flutter run --dart-define=SUPABASE_URL=your_url --dart-define=SUPABASE_ANON_KEY=your_key
   

4. Run the app:

   flutter run
   

Key Features

Phase 1 (MVP)

• User authentication (email, Google, Apple)
• Bucket list creation (up to 20 goals)
• 1356-day countdown timer
• Goal progress tracking
• Basic profile management

Phase 2 (Social)

• Public/private profiles
• Social feed
• Leaderboards
• Following system

Phase 3 (Advanced)

• Charts and analytics
• Image API integration
• Map integration for location-based goals
• Offline support

Database Schema

The app uses Supabase PostgreSQL with the following main tables:

• users - User profiles and countdown data
• goals - Bucket list items
• goal_steps - Granular goal milestones
• followers - Social relationships
• activities - Timeline events

Architecture Patterns

• MVVM/Clean Architecture with clear separation of concerns
• Repository Pattern for data access
• Provider/StateNotifier for state management
• Feature-based organization for scalability

Development Notes

• All screens are currently placeholder implementations
• Core structure and dependencies are set up
• Authentication flow is partially implemented
• Database models and repositories are defined
• Navigation structure is in place

Next Steps

1. Complete authentication implementation
2. Implement bucket list creation and management
3. Build countdown timer functionality
4. Add goal progress tracking
5. Implement social features (Phase 2)
6. Add advanced analytics (Phase 3)