Skip to content

Randomly pick friends for fun stuff โ€” built with SwiftUI ๐ŸŽฒ

Notifications You must be signed in to change notification settings

actuallyhrishikesh/PICKERR

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

7 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

PICKERR ๐ŸŽฏ

A fun, multi-touch iOS app inspired by the "Chooser" app that allows groups of friends to randomly select a winner by placing multiple fingers on the iPhone screen simultaneously.

Features โœจ

Core Functionality

  • Multi-Touch Detection: Track up to 8 simultaneous touch points on the screen
  • Visual Feedback: Each touch gets a unique colored circle with participant numbers
  • Random Selection: Prominent "Choose Winner!" button for random selection
  • Winner Animation: Engaging animations with scaling, pulsing, and visual effects
  • Haptic Feedback: Medium impact on touch registration and success notification on winner selection

Customization

  • Custom Names: Input custom names for friends instead of generic numbers
  • Categories: Multiple game modes (Friends, Dinner, Tasks, Games, Custom)
  • Settings Screen: Comprehensive customization options

Additional Features

  • Game History: Track previous selections and winners
  • Sharing: Share results via Share Sheet
  • Modern UI: Dark-themed interface with gradient backgrounds
  • Instructions: Built-in tutorial for new users

Screenshots ๐Ÿ“ฑ

The app features a beautiful gradient background with:

  • Large touch-sensitive area for finger placement
  • Real-time participant count display
  • Animated winner announcements with confetti effects
  • Intuitive controls for game management
    • IMG_0767
    • IMG_0764
    • IMG_0765
    • IMG_0766

Technical Details ๐Ÿ”ง

Built With

  • SwiftUI: Modern declarative UI framework
  • UIKit: Multi-touch gesture handling and haptic feedback
  • Core Animation: Smooth animations and transitions
  • iOS 17+: Latest iOS features and APIs

Architecture

  • MVVM Pattern: Clean separation of concerns
  • ObservableObject: Reactive state management
  • Combine: Reactive programming for UI updates

Key Components

  • GameViewModel: Main game logic and state management
  • TouchDetectorView: Multi-touch gesture detection
  • TouchPointView: Individual touch point visualization
  • SettingsView: Customization and history management

Installation ๐Ÿš€

  1. Clone the repository:
git clone https://github.com/actuallyhrishikesh/PICKERR.git
  1. Open PICKERR.xcodeproj in Xcode

  2. Build and run on iOS Simulator or device (iOS 17+ required)

Usage ๐ŸŽฎ

  1. Start the App: Launch PICKERR and read the welcome instructions
  2. Add Participants: Place multiple fingers on the screen to add participants
  3. Customize: Tap the settings gear to customize names and categories
  4. Choose Winner: Tap "Choose Winner!" when you have at least 2 participants
  5. Share Results: Share the winner announcement with friends

Game Modes ๐ŸŽฏ

  • Friends: General friend selection
  • Dinner: Choose who pays for dinner
  • Tasks: Assign random tasks to group members
  • Games: Pick a game player
  • Custom: Create your own category

Requirements ๐Ÿ“‹

  • iOS 17.0 or later
  • Xcode 15.0 or later
  • iPhone or iPad with multi-touch support

Contributing ๐Ÿค

Contributions are welcome! Please feel free to submit a Pull Request.

License ๐Ÿ“„

This project is licensed under the MIT License - see the LICENSE file for details.

Inspiration ๐Ÿ’ก

Inspired by the popular "Chooser" app on the App Store, PICKERR brings the concept of random selection to a new level with multi-touch interaction, making it perfect for group decision-making scenarios.


Made with โค๏ธ using Swift and SwiftUI

About

Randomly pick friends for fun stuff โ€” built with SwiftUI ๐ŸŽฒ

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages