📝 To-Do List App (Android)

Read in English | Lire en Français

---

🇫🇷 Français

Bienvenue sur le dépôt de l'application To-Do List. Ce projet Android, développé en Kotlin, sert d'exemple pratique pour apprendre les fondamentaux du développement mobile moderne.

L'application permet de gérer une liste de tâches simple avec une interface utilisateur fluide utilisant les composants Material Design.

🚀 Fonctionnalités

• Ajout de tâches : Création rapide de nouvelles tâches via un bouton d'action flottant (FAB).
• Liste dynamique : Affichage optimisé des tâches avec RecyclerView.
• Navigation fluide : Utilisation d'Intents explicites pour passer d'un écran à l'autre.
• Gestion des résultats : Implémentation de l'Activity Result API (moderne) pour récupérer les données saisies.
• Interface sûre : Utilisation du View Binding pour éviter les erreurs liées aux IDs de vues.

🛠 Technologies & Concepts Clés

Ce projet met en œuvre les technologies suivantes :

• Langage : Kotlin
• Architecture UI : XML Layouts & Material Design 3
• Composants clés :
  • ViewBinding (remplace findViewById)
  • RecyclerView & Adapter (listes performantes)
  • Intent (navigation)
  • ActivityResultLauncher (récupération de données)
  • Menu (options contextuelles)

📖 Pour aller plus loin : Consultez le fichier EXPLICATIONS.md pour une documentation détaillée de chaque concept utilisé dans le code.

📱 Installation & Compilation

Option 1 : Via Android Studio (Recommandé sur PC/Mac)

1. Clonez ce dépôt :

   git clone https://github.com/votre-nom/todolist-android.git

2. Ouvrez le projet dans Android Studio.
3. Attendez la synchronisation Gradle.
4. Lancez l'application sur un émulateur ou votre appareil physique.

Option 2 : Via Termux (Directement sur Android)

Vous pouvez compiler et installer cette application directement depuis votre téléphone Android en utilisant l'application Termux.

👉 Voir le guide complet : COMPILATION_TERMUX.md

📂 Structure du Projet

• app/src/main/java/ : Code source Kotlin (MainActivity, AddTaskActivity, TaskAdapter).
• app/src/main/res/layout/ : Maquettes XML des écrans.
• app/src/main/res/menu/ : Définition des menus d'options.
• app/build.gradle.kts : Configuration des dépendances et du build.

📄 Licence

Ce projet est distribué sous licence MIT. Voir le fichier LICENSE pour plus d'informations.

---

🇺🇸 English

Welcome to the To-Do List application repository. This Android project, developed in Kotlin, serves as a practical example for learning the fundamentals of modern mobile development.

The application allows for processing a simple list of tasks with a smooth user interface using Material Design components.

🚀 Features

• Add Tasks: Quickly create new tasks via a Floating Action Button (FAB).
• Dynamic List: Optimized display of tasks using RecyclerView.
• Smooth Navigation: Use of Explicit Intents to navigate between screens.
• Result Handling: Implementation of the Activity Result API (modern approach) to retrieve input data.
• Safe UI Access: Use of View Binding to avoid errors related to view IDs.

🛠 Technologies & Key Concepts

This project implements the following technologies:

• Language: Kotlin
• UI Architecture: XML Layouts & Material Design 3
• Key Components:
  • ViewBinding (replaces findViewById)
  • RecyclerView & Adapter (performant lists)
  • Intent (navigation)
  • ActivityResultLauncher (data retrieval)
  • Menu (contextual options)

📖 Deep Dive: Check out EXPLICATIONS.md (in French) for detailed documentation of each concept used.

📱 Installation & Build

Option 1: Via Android Studio (Recommended on PC/Mac)

1. Clone this repository:

   git clone https://github.com/your-name/todolist-android.git

2. Open the project in Android Studio.
3. Wait for Gradle synchronization.
4. Run the app on an emulator or your physical device.

Option 2: Via Termux (Directly on Android)

You can compile and install this application directly from your Android phone using Termux.

👉 See the full guide: COMPILATION_TERMUX.md

📂 Project Structure

• app/src/main/java/ : Kotlin source code (MainActivity, AddTaskActivity, TaskAdapter).
• app/src/main/res/layout/ : XML layouts for screens.
• app/src/main/res/menu/ : Options menu definitions.
• app/build.gradle.kts : Dependencies and build configuration.

📄 License

This project is distributed under the MIT License. See the LICENSE file for more information.

---

Developed with ❤️ for learning Android development.