Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/nishkarsh25/myshoppinlistapp2

MyShoppingListApp2 is a simple Android application designed to help users create and manage their shopping lists efficiently. Built with Kotlin and Jetpack Compose, this app offers a modern and intuitive user interface for a seamless shopping experience.
https://github.com/nishkarsh25/myshoppinlistapp2

googlemaps-api jetpack-compose kotlin-android retorfit2

Last synced: 17 days ago
JSON representation

MyShoppingListApp2 is a simple Android application designed to help users create and manage their shopping lists efficiently. Built with Kotlin and Jetpack Compose, this app offers a modern and intuitive user interface for a seamless shopping experience.

Awesome Lists containing this project

README

        

# MyShoppingListApp2

MyShoppingListApp2 is a simple Android application designed to help users create and manage their shopping lists efficiently. Built with Kotlin and Jetpack Compose, this app offers a modern and intuitive user interface for a seamless shopping experience.

## Features

### 1. Add Shopping Items
Easily add items to your shopping list by providing the item's name, quantity, and associated address. This feature ensures that you never forget what you need to buy and where to buy it from.

### 2. Edit Items
Modify existing items on your shopping list to reflect any changes or updates. Edit the name, quantity, or address of the item with just a few taps, keeping your list accurate and up to date.

### 3. Delete Items
Remove unwanted items from your shopping list effortlessly. Whether you've already purchased an item or no longer need it, the delete function allows you to declutter your list with ease.

### 4. Location Integration
Integration with the Google Maps Android API enables seamless location-based functionality. Retrieve your current location or select a specific address for each item on your shopping list, ensuring you always know where to go to make your purchases.

## Screenshots

Screenshot 1     Screenshot 2

Screenshot 1     Screenshot 2

Screenshot 1     Screenshot 2

# GIF's
Screenshot 4

## JSON
Screenshot 1

Screenshot 2

## Tech Stack

### Programming Languages
- **Kotlin**: The primary language for Android app development.

### Libraries and Frameworks
- **Jetpack Compose**: A modern UI toolkit for building native Android apps.
- **Retrofit**: A type-safe HTTP client for making API calls.
- **Google Maps Android API**: Provides location services and mapping functionalities.

### Dependencies
- **Kotlin Coroutines**: For asynchronous programming and managing background tasks.
- **Material Components for Android**: Provides pre-designed UI components and styles for a Material Design aesthetic.
- **AndroidX Lifecycle**: Offers components for managing the lifecycle of Android UI components.
- **Retrofit**: A type-safe HTTP client for Android and Java.
- **Gson Converter**: A converter library for Retrofit that facilitates serialization and deserialization of JSON objects.
- **Google Play Services Location**: Provides APIs for accessing location services on Android devices.

## Usage

Follow these steps to set up and run the app:

1. **Clone the Repository**:
```bash
git clone https://github.com/nishkarsh25/MyShoppinListApp2.git
```

2. **Open the Project:**
Open the project in Android Studio.

3. **Provide API Key:**
Obtain an API key for the Google Maps Android API and add it to the `local.properties` file:

```makefile
GOOGLE_MAPS_API_KEY=your_api_key_here
```
4. **Build and Run:**
Build and run the project on an Android emulator or a physical device.

## Contributing

Contributions are welcome! If you'd like to contribute to this project, please follow these steps:

1. **Fork the Repository**.
2. **Create a New Branch** (`git checkout -b feature/your-feature-name`).
3. **Make Your Changes**.
4. **Commit Your Changes** (`git commit -am 'Add some feature'`).
5. **Push to the Branch** (`git push origin feature/your-feature-name`).
6. **Create a New Pull Request**.

## License

This project is licensed under the [The 3-Clause BSD License](LICENSE).

## Author

- **Nishkarsh Gupta**
- GitHub: [nishkarsh25](https://github.com/nishkash25)
- Email: [email protected]