💵 Tip Calculator

A simple and flexible tool to calculate tips and split bills among multiple people. Supports custom splits, rounding, and currency formatting.

---

🚀 Features

• Calculate tip based on bill amount and tip percentage
• Split the total among multiple people
• Optional custom split for each person
• Round up per-person amounts for convenience
• Supports custom currency symbols
• Easy to integrate into automation pipelines or web apps

---

📥 Input Schema

Field	Type	Required	Default	Description
billAmount	number	✅ Yes	—	Total bill amount. Must be positive.
tipPercentage	number	❌ No	15	Tip percentage to apply. Range: 0–100.
numberOfPeople	integer	❌ No	2	Number of people splitting the bill. Minimum 1.
currency	string	❌ No	$	Currency symbol for display.
roundUp	boolean	❌ No	false	Round up per-person amount to nearest whole number.
customSplit	array	❌ No	[]	Optional custom amounts per person. Overrides equal split if provided.

---

🧮 Example

Input

{
  "billAmount": 120,
  "tipPercentage": 18,
  "numberOfPeople": 3,
  "currency": "$",
  "roundUp": true,
  "customSplit": []
}

Output

{
  "totalTip": 21.6,
  "totalAmount": 141.6,
  "perPerson": 48
}

---

Custom Split Example

Input

{
  "billAmount": 120,
  "tipPercentage": 15,
  "customSplit": [50, 30, 40]
}

Output

{
  "totalTip": 18,
  "totalAmount": 138,
  "perPerson": [58, 48, 58]
}

---

🏗️ Use Cases

• Restaurants or cafés splitting bills among friends
• Event or group dining calculations
• Integration into personal finance apps
• Automation workflows for payment distribution

---

⚡ Notes

• billAmount must be positive
• customSplit overrides equal split automatically
• Rounding only affects per-person amounts, not total tip

---

📄 License

MIT License