The Shopping List Project

Project Background

The Shopping List Project is a minimalist Android application developed using C# and .NET 8 MAUI. It leverages the CommunityToolkit and SQLite for efficient data management and UI enhancements. This project represents an initial foray into mobile app development, specifically targeting the Android platform, and aims to provide users with a simple yet effective tool for managing shopping lists. The application is designed to be lightweight and user-friendly, focusing on essential functionalities that enhance the shopping experience.

Motivation

The motivation behind this project was to explore the capabilities of .NET MAUI for cross-platform development and to gain hands-on experience in Android app creation. By developing this application, the goal was to understand the intricacies of mobile development, including UI design, data storage, and user interaction. Additionally, the project serves as a stepping stone towards more complex applications, with the potential for future expansion into multi-list management and enhanced configuration options. The minimalist design reflects a desire to create a tool that is both practical and easy to use, without unnecessary complexity.

Code Explanation and Logics

The codebase is structured to ensure modularity and maintainability. Key components include:

Logger Utility: The Logger class in Utilities provides a simple logging mechanism that adapts to different platforms. For Android, it uses Android.Util.Log.Info, while for debugging purposes, it outputs to the console and trace logs. This ensures that developers can easily track application behavior across different environments.
MainPage Logic: The MainPage.xaml.cs file contains the core logic for the application's main interface. It handles user interactions such as adding items, selecting stores, and managing quantities. The page adapts its layout based on the platform, ensuring a consistent user experience across devices. The use of asynchronous methods for database operations (LoadStoresFromDatabase, LoadItemsFromDatabase) ensures smooth performance without blocking the UI.
Themes and Styles: The application supports both light and dark themes, defined in LightTheme.xaml and DarkTheme.xaml. These themes provide a cohesive look and feel, with colors and styles that enhance readability and usability. The themes are dynamically applied based on user preferences, allowing for a personalized experience.
Welcome Popup: The WelcomePopup.xaml and its corresponding code-behind file introduce new users to the application. This popup is displayed on the first run, guiding users through initial setup steps and highlighting key features. It uses the CommunityToolkit's popup functionality to ensure a smooth and engaging introduction.
DetailPage Functionality: The DetailPage.xaml.cs file manages the detailed view of individual items. It allows users to adjust item properties such as importance and quantity, with real-time updates reflected in the UI. The use of data binding and converters ensures that changes are seamlessly integrated into the application's data model.

Features

The Shopping List Project includes several features designed to enhance the shopping experience:

Minimalist Shopping List: The application provides a straightforward interface for managing shopping lists, focusing on essential details such as item quantity, store location, and importance.
Configurable Store Names: Users can customize store names to match their preferences, ensuring that the application aligns with their shopping habits.
Clipboard Integration: Lists can be exported to the clipboard as text, allowing for easy sharing and backup. Additionally, users can import lists from comma-separated strings, merging them with existing data.
SQLite Data Storage: All data is stored locally on the device using SQLite, ensuring fast access and reliable persistence. This approach minimizes dependencies and enhances performance.
Native Confirmation Prompts: Destructive actions, such as item deletion, are accompanied by native confirmation prompts, reducing the risk of accidental data loss.
Dark Theme Availability: A dark theme is available for users who prefer a less bright interface, enhancing usability in low-light conditions.
Cross-Platform Compatibility: Developed using .NET MAUI, the application is designed to run on multiple platforms, with specific adaptations for Android and Windows.
UI Testing with Appium and NUnit: The project includes UI testing capabilities using Appium and NUnit, ensuring that the application behaves as expected across different scenarios.
CC0 Icons: Icons used in the application are sourced from iconsDB.com under the CC0 license, ensuring a visually appealing interface without licensing concerns.

This README provides a comprehensive overview of the Shopping List Project, highlighting its background, motivation, code structure, and features. The application is a testament to the power of .NET MAUI for creating efficient, cross-platform mobile solutions.

6002CEM-24-25/6002CEM_MyoMinKyaw

About

Resources

Stars

Watchers

Forks

Releases

Contributors 2

Languages