Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

https://github.com/mariarodr1136/leave-a-tip

Leave a Tip! is a playful app for social gatherings. After doing a favor, let friends "tip" you by choosing an amount—though only the highest option works! It’s all for laughs, with no real transaction involved. Enjoy the fun!
https://github.com/mariarodr1136/leave-a-tip

comedy friendship fun-programming fun-project humor ios-app leave-a-tip playful prank-app socialapp swift tech-humor tip xcode

Last synced: 5 days ago
JSON representation

Leave a Tip! is a playful app for social gatherings. After doing a favor, let friends "tip" you by choosing an amount—though only the highest option works! It’s all for laughs, with no real transaction involved. Enjoy the fun!

Awesome Lists containing this project

README

        

# Leave a Tip! 😂

**A humorous tip-collecting app that ensures you always get the "maximum appreciation!"**

![Swift](https://img.shields.io/badge/Technologies-Swift-blue) ![SwiftUI](https://img.shields.io/badge/Technologies-SwiftUI-yellow) ![Xcode](https://img.shields.io/badge/Technologies-Xcode-orange)

## 📖 Overview
**Leave a Tip!** is a playful project that brings laughter to social gatherings. The idea is simple: when you've done a small favor, whip out the app and let your friends "show their appreciation" by choosing a tip amount. But here’s the twist—while they can pick different tip percentages, only the maximum option works! It’s all in good fun, as there’s no real transaction here. Just sit back and enjoy their reaction!

## Table of Contents
- [📖 Overview](#-overview)
- [📸 Screenshots](#-screenshots)
- [✨ Features](#-features)
- [🎉 How It Works](#-how-it-works)
- [🚀 Technologies Used](#-technologies-used)
- [⚙️ Customization](#️-customization)
- [🧑‍💻 Installation](#-installation)
- [🧑‍🧑‍🧒 Contributing](-#contributing)
- [🌐 Contact](#-contact)
- [🤔 Disclaimer](#-disclaimer)

---

## 📸 Screenshots

![IMG_9442](https://github.com/user-attachments/assets/08e98b1d-a3ca-44a0-a18c-225fa95b3814)
![IMG_9444](https://github.com/user-attachments/assets/78617a60-3dd7-49be-8168-469dd9997df9)

---

## ✨ Features
- **Customizable Name and Percentages**: Easily switch out `[Name]` in the code with your own name to make the app feel personal! You can also adjust the tip percentages to any values you like.
- **Choose Your Tip**: Users are presented with options to tip 15%, 25%, and the "maximum appreciation" option of 45%.
- **Maximum Appreciation Only**: The lower options (15% and 25%) don’t work, so they’re “forced” to leave a 45% tip—hilarious, right?
- **For Fun Only**: This app isn’t connected to any payment system, so no real money changes hands. It’s purely for laughs!

## 🎉 How It Works
1. After helping a friend or doing something nice, open the app.
2. Show them the tip options and watch them pick 15% or 25%.
3. When they realize only the 45% option works, it’s bound to get a laugh!

## 🚀 Technologies Used
- **Swift and SwiftUI**: Developed for iOS using Swift and SwiftUI for a smooth and responsive user experience.
- **Xcode**: Built in Xcode for iOS devices, making it a fun and portable app to show on your iPhone.

## ⚙️ Customization
- **Change the Displayed Name**: In the code, locate the placeholder `[Name]` and replace it with your own name to give the app a personal touch.
- **Adjust Tip Percentages**: You can also modify the 15%, 25%, and 45% values in the code to any percentage you’d like—make it as funny as you want!

## 🧑‍💻 Installation
1. Clone the repository:
```bash
gh repo clone mariarodr1136/Leave-a-Tip
2. Open the project in Xcode and build it on your device to start the fun!

## 🧑‍🧑‍🧒 Contributing
Feel free to submit issues or pull requests for improvements or bug fixes. You can also open issues to discuss potential changes or enhancements. All contributions are welcome to enhance the app’s features or functionality!

To contribute, please follow these steps:

1. Fork the repository.
2. Create a new branch for your feature or bug fix:
```bash
git checkout -b feat/your-feature-name
- Alternatively, for bug fixes:
```bash
git checkout -b fix/your-bug-fix-name
3. Make your changes and run all tests before committing the changes and make sure all tests are passed.
4. After all tests are passed, commit your changes with descriptive messages:
```bash
git commit -m 'add your commit message'
5. Push your changes to your forked repository:
```bash
git push origin feat/your-feature-name.
6. Submit a pull request to the main repository, explaining your changes and providing any necessary details.

---

https://github.com/user-attachments/assets/39ef89b0-f532-4c4e-b275-e199eeca1584

---

## 🌐 Contact
If you have any questions or feedback, feel free to reach out at [[email protected]](mailto:[email protected]).

## 🤔 Disclaimer
This app is meant for entertainment purposes only—no actual tips will be collected!

Enjoy making people laugh with **Leave a Tip!**