devfreak-ui / onedon

OneDon is a mobile donation app that enables users to donate products and cash to activities and causes. It provides a user-friendly interface, donation tracking, and features like item descriptions, location viewing, and email communication.

OneDon - Donation App

OneDon is a mobile application developed with React Native and Expo that allows users to donate products and cash to various activities and causes. This README.md file provides an overview of the app's features, installation instructions, and usage guidelines.

Features

Product Donation

• Account: Users can create an account to manage their donations and preferences.
• List of Donated Items: Users can view a list of items they have donated.
• Item Description: Users can provide a description of the donated items.
• Single Click to View Location: Users can view the location of the donated items on a map with a single click.
• One Click to Email Item Donor: Users can easily contact the donor of an item via email.
• CRUD Operations on Item: Users can perform Create, Read, Update, and Delete operations on their donated items.

Cash Donation (Activity)

• List of Activities: Users can view a list of activities that require funding.
• Activity Status: Users can see the current donation status for each activity, including the amount donated and the remaining amount needed.
• Four Payment Options: Users have four payment options to choose from when making a cash donation.
• CRUD Operations on Activity: Users can perform CRUD operations on activities, such as creating new activities, updating existing ones, and deleting activities.

Cash Donation (General)

• Open Donation: Users can make open donations of any amount at any time. These donations can be used for unaccounted activities or emergencies.

Future Releases

• In-App Chat System: A chat system will be implemented to allow communication between donors, drivers, and interested parties without the need to switch to other apps.
• View Location of Item: Users will be able to view the location of an item directly within the app.

Installation

To install and run the OneDon app on your local machine, follow these steps:

1. Clone the repository: git clone https://github.com/DevFreak-ui/onedon.git

2. Navigate to the project directory: cd onedon

3. Install dependencies: npm install

4. Start the development server: expo start

5. Connect your device or launch an emulator to run the app.

Usage

Once the app is running, you can use it to:

• Create an account and manage your donations.
• Donate products by providing item descriptions and viewing their locations on the map.
• Email item donors with just one click.
• Donate cash to activities and view their status.
• Make open donations of any amount.
• Perform CRUD operations on items and activities.

Feel free to explore the app and provide feedback or report any issues.

Contributing

We welcome contributions to enhance the OneDon app. To contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix.
3. Make your changes and commit them.
4. Push your changes to your fork.
5. Submit a pull request.

Please ensure that your code adheres to the project's coding conventions and includes relevant documentation or tests.

License

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

Acknowledgements

We would like to acknowledge the following libraries and resources used in this project:

• React Native
• React Navigation
• Expo

Thank you for using OneDon! If you have any questions or need assistance, please contact our support team at [email protected].

Note: Customize the documentation according to your app's specific details and requirements.