Skip to content

Repository files navigation

Evolve Logo

Evolve

What will you improve today?

A self-improvement todo app that gamifies personal growth. Set goals across every area of your life — mental, physical, social, academic — complete them, earn XP, level up, and watch yourself evolve.

Android Kotlin License


About

Evolve is a gamified todo list app built around one simple question: What will you improve today?

It's not just a checklist. Every task you complete earns you XP based on its difficulty. Fill the bar and you level up — with confetti. Track your daily progress, see your streak, view weekly and monthly growth reports, and get inspired by a new motivational quote every time you open the app.

Evolve is a constant reminder that you need to upgrade yourself as a human being. Open it every day. Add tasks that matter. Complete them. Evolve.

Features

Core

  • Category-Based Tasks — Organize goals into Mental, Physical, Social, and Study
  • Task Difficulty Levels — Easy (+10 XP), Medium (+25 XP), Hard (+50 XP)
  • Level-Up System — Earn XP for every completed task; level up and trigger confetti
  • Daily Progress — Visual progress bar tracking how much you've done today
  • Streak Tracking — See how many consecutive days you've been active

Reports & Stats

  • Weekly Report — Tasks completed, XP earned, avg per day, best day, category breakdown
  • Monthly Report — Same stats for the entire month
  • Yearly Overview — See your entire year of growth at a glance
  • Share Stats — Share your level and task count with friends

Experience

  • Confetti Celebrations — Animated confetti bursts when you hit a new level
  • Motivational Quotes — A new quote on every splash screen and in-app quote card
  • Sound Effects — Satisfying audio for completions and level-ups
  • Offline — Works completely offline, no internet needed

How It Works

  1. Open the app — Animated splash with logo and app name
  2. Pick a category — Choose from Mental, Physical, Social, or Study
  3. Set difficulty — Tap E/M/H to set Easy, Medium, or Hard (more XP for harder tasks)
  4. Add a task — Type what you want to improve
  5. Complete it — Tap the check circle to mark it done and earn XP
  6. Level up — Fill your XP bar and get hit with a confetti celebration
  7. Check reports — Tap "Weekly Report" to see your growth stats
  8. Come back tomorrow — Keep your streak alive. New day, new tasks, new quote.

Screenshots

Screenshots coming soon. Check the docs/screenshots/ folder.

Architecture

com.evolve.todo/
├── MainActivity.kt          # Main screen: todo list, categories, difficulty, progress, share
├── SplashActivity.kt        # Animated splash with daily quote and version
├── TodoAdapter.kt           # RecyclerView adapter with difficulty badges and category tags
├── ConfettiView.kt          # Custom confetti animation on level-up
├── DataManager.kt           # JSON persistence, streak, weekly/monthly reports, backup/restore
├── QuoteManager.kt          # 35+ motivational quotes engine
├── SoundManager.kt          # Sound effects for interactions
└── TodoItem.kt              # Data model with difficulty, category, timestamps

Tech Stack

Component Technology
Language Kotlin
UI View Binding + Material Design 3
Theme Material 3 Dark Theme
Animations Custom Confetti View
Data Storage SharedPreferences + JSON
Min SDK API 24 (Android 7.0)

App Screens

Screen Description
Splash Logo animation and app title
Main Category filter chips, difficulty picker, todo list, progress bar, streak badge, quote card
Difficulty Dialog Select Easy/Medium/Hard with XP preview
Celebration Dialog Confetti animation, level-up message, share button
Stats Dialog Weekly or monthly report with category breakdown

Getting Started

Prerequisites

  • Android Studio Hedgehog (2023.1) or later
  • JDK 17
  • Android SDK 34

Installation

  1. Clone the repository

    git clone https://github.com/Tauseef666-ctrl/evolve.git
    cd evolve
  2. Open in Android Studio

    • Launch Android Studio
    • Select File > Open
    • Navigate to the cloned directory
  3. Build and Run

    • Connect an Android device or start an emulator
    • Click Run or press Shift+F10

Download

Download the latest APK from the Releases page.

Project Structure

evolve/
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.md
│   │   └── feature_request.md
│   └── workflows/
│       └── build.yml
├── app/
│   ├── build.gradle
│   ├── proguard-rules.pro
│   └── src/main/
│       ├── AndroidManifest.xml
│       ├── java/com/evolve/todo/
│       │   ├── MainActivity.kt
│       │   ├── SplashActivity.kt
│       │   ├── ConfettiView.kt
│       │   ├── DataManager.kt
│       │   ├── QuoteManager.kt
│       │   ├── SoundManager.kt
│       │   ├── TodoAdapter.kt
│       │   └── TodoItem.kt
│       └── res/
│           ├── layout/          # 6 layouts: main, splash, todo item, celebration, difficulty, stats
│           ├── drawable/        # backgrounds, circles, progress bars, chips, badges, icons
│           ├── mipmap-xxxhdpi/  # app icons
│           └── values/          # strings, colors, themes
├── assets/images/               # logo, logo_round
├── docs/screenshots/
├── .gitignore
├── build.gradle
├── settings.gradle
├── gradle.properties
├── CONTRIBUTING.md
├── LICENSE
└── README.md

Roadmap

  • Streak tracking with daily reminders
  • Weekly/monthly growth reports
  • Share your level and stats
  • Task difficulty levels (Easy/Medium/Hard)
  • Widget for quick task completion
  • Wear OS companion
  • Custom tags and subtasks
  • Dark/Light theme toggle

Contributing

Contributions are welcome! Please read our Contributing Guidelines before submitting a pull request.

  1. Fork the repository
  2. Create your feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'feat: add amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.


Made with passion for self-evolution

About

A gamified todo app that reminds you to evolve as a human. Set goals, complete tasks, earn XP, level up.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages