Skip to content

TABURELTER/HappyButton

Repository files navigation

🎉 HappyButton

Instant Dopamine for iOS / Мгновенный дофамин для iOS

iOS 17+ Swift 5.9 License

English | Русский


HappyButton Preview

🇬🇧 English

HappyButton is a simple and fun "dopamine button" for iOS. Feeling down? Just tap the button, get a burst of confetti, a satisfying sound, and a little hit of dopamine! 🌈

This is a lightweight pet project demonstrating smooth SwiftUI animations, haptic feedback, and custom user settings.

✨ Features

  • 🎉 Dopamine on Demand: One tap = instant celebration.
  • 🔊 Polyphonic Sound: Sounds stack up for a satisfying multi-pop effect (machine-gun style).
  • 📳 Haptic Feedback: Feel the "pop" with precise Taptic Engine support.
  • 🎨 Fully Customizable: Adjust confetti count, size, radius, and gravity.
  • 🖌 Custom Palettes: Create and save your own color sets using the built-in Color Picker.
  • 📈 Stats Tracker: See exactly how many times you've boosted your mood.

🚀 Quick Start

  1. Clone the repo:
    git clone https://github.com/TABURELTER/HappyButton.git
  2. Open HappyButton.xcodeproj in Xcode 15+.
  3. Run on an iOS 17+ device or simulator using Cmd + R.

🇷🇺 Русский

HappyButton — это простая и забавная «кнопка дофамина» для iOS. Грустно? Просто нажми на кнопку, получи залп конфетти, приятный звук и капельку дофамина! 🌈

Это легкий pet-проект, демонстрирующий плавные анимации SwiftUI, тактильную отдачу и работу с пользовательскими настройками (UserDefault/AppStorage).

✨ Особенности

  • 🎉 Дофамин по требованию: Одно нажатие = мгновенный праздник.
  • 🔊 Полифонический звук: Звуки накладываются друг на друга для эффекта непрерывных хлопков.
  • 📳 Тактильная отдача: Ощутите каждый хлопок благодаря поддержке Taptic Engine.
  • 🎨 Полная кастомизация: Настраивайте количество, размер, радиус разлета и высоту падения конфетти.
  • 🖌 Свои палитры: Создавайте и сохраняйте уникальные наборы цветов через встроенный Color Picker.
  • 📈 Счетчик счастья: Узнайте, сколько раз вы подняли себе настроение.

🚀 Быстрый старт

  1. Клонируйте репозиторий:
    git clone https://github.com/TABURELTER/HappyButton.git
  2. Откройте HappyButton.xcodeproj в Xcode 15+.
  3. Запустите на устройстве или симуляторе с iOS 17+ комбинацией Cmd + R.

📜 Attribution & License

Third-party

  • ConfettiSwiftUI: Amazing library by @[simibac] (Simon Bachmann). Used under its own license.
Click to view MIT License

MIT License

Copyright (c) 2026 Dmitry Bogdanov

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.


Created with ❤️ by TABURELTER. Make the world a bit happier!

About

HappyButton is a simple and fun "dopamine button" for iOS

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages