• Features
• Installation
• Project Structure
• Core Components
• Database Schema
• API Reference
• Usage Guide
• Permissions
• Testing
• Troubleshooting
• Contributing
• Screenshots
• License

• 📝 Task management (CRUD operations)
• ⏰ Time-based reminders
• 🔄 Data persistence
• 📱 Responsive UI

• Material Design components
• RecyclerView with swipe gestures
• SQLite database with helper class
• AlarmManager for reminders
• BroadcastReceivers for system events

• Android Studio Flamingo (2022.2.1) or later
• Android SDK 33 (API Level 33)
• Java 17

1. Clone the repository:

   git clone https://github.com/Bitxo92/taskly.git
   cd taskly

2. Import into Android Studio:
   • Select "Open an Existing Project"
   • Navigate to the cloned directory
   • Wait for Gradle sync to complete
3. Build and Run:
   • Connect an Android device or start an emulator
   • Click "Run" (Shift+F10)
   • Select your target device

app/
├── manifests/
│   └── AndroidManifest.xml
├── java/
│   └── com.patino.todolistapp/
│       ├── activities/
│       │   ├── AddTaskActivity.java
│       │   ├── EditTaskActivity.java
│       │   ├── MainActivity.java
│       │   └── SplashActivity.java
│       ├── adapters/
│       │   └── TaskAdapter.java
│       ├── database/
│       │   └── DatabaseHelper.java
│       ├── models/
│       │   └── Task.java
│       └── receivers/
│           ├── BootReceiver.java
│           └── TaskReminderReceiver.java
└── res/
    ├── layout/
    │   ├── activity_add_task.xml
    │   ├── activity_main.xml
    │   └── activity_splash.xml
    └── values/
        ├── colors.xml
        ├── strings.xml
        └── styles.xml

public class DatabaseHelper extends SQLiteOpenHelper {
    private static final String DATABASE_NAME = "tasks.db";
    private static final int DATABASE_VERSION = 1;
    
    // Table creation SQL
    private static final String CREATE_TABLE = 
        "CREATE TABLE " + TABLE_TASKS + "(" +
        COLUMN_ID + " INTEGER PRIMARY KEY AUTOINCREMENT, " +
        COLUMN_TITLE + " TEXT, " +
        COLUMN_DESCRIPTION + " TEXT, " +
        COLUMN_TIMESTAMP + " INTEGER)";
}

public class Task {
    private int id;
    private String title;
    private String description;
    private long timestamp;
    
    // Constructor and getters
}

public static void scheduleTaskReminder(Context context, long taskTime, String taskTitle) {
    AlarmManager alarmManager = (AlarmManager) context.getSystemService(Context.ALARM_SERVICE);
    long reminderTime = taskTime - (10 * 60 * 1000); // 10 minutes before
    
    Intent intent = new Intent(context, TaskReminderReceiver.class);
    PendingIntent pendingIntent = PendingIntent.getBroadcast(
        context, 
        (int) taskTime, 
        intent, 
        PendingIntent.FLAG_IMMUTABLE
    );
    
    alarmManager.setExactAndAllowWhileIdle(
        AlarmManager.RTC_WAKEUP, 
        reminderTime, 
        pendingIntent
    );
}

1. Tap the floating action button (+)
2. Enter task details:
   • Title (required)
   • Description (optional)
   • Due date/time
3. Tap "Save"

• Triggers 10 minutes before due time
• Includes vibration
• Survives device reboots

<uses-permission android:name="android.permission.RECEIVE_BOOT_COMPLETED"/>
<uses-permission android:name="android.permission.VIBRATE"/>
<uses-permission android:name="android.permission.POST_NOTIFICATIONS"/>
<uses-permission android:name="android.permission.SCHEDULE_EXACT_ALARM"/>

./gradlew test

./gradlew connectedAndroidTest

1. Fork the repository
2. Create your feature branch:

   git checkout -b feature/new-feature

3. Commit your changes:

   git commit -m 'Add some feature'

4. Push to the branch:

   git push origin feature/new-feature

5. Open a pull request

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

• ✅ Commercial use
• ✅ Modification
• ✅ Distribution
• ✅ Patent use
• ✅ Private use

• ❗ License and copyright notice must be included
• ❗ Same license must be used for derivative works
• ❗ State changes made to original code
• ❗ Disclose source code

• ⚠️ No liability
• ⚠️ No warranty

For full license terms, see LICENSE file or read the GNU GPL v3.0 official documentation.