Join a party, request a song, track the status

• Active account - see the create-account guide
• Added card or funds - card guide or voucher guide
• Party QR code or party location or code from the organizer

Parties tab

The main party discovery page. Consists of:

• Filters (Discover) - pills "City" and "Date" at the top
• View toggle: "List" ⇄ "Map"
• Content of list or map
• Possible "Party nearby" popup

Filters

• City - tapping opens the "Cities" modal (list with search). One city at a time.
• Date - calendar with min date = today. No selection = all from today onwards.

No genre or status filter. The list defaults to Live and scheduled (Scheduled) public parties, sorted chronologically.

Party list

Each party card contains:

• Image, name, location (club or address), performer
• Badge "LIVE" if currently going, "Not started", "Ended", or "Expired"
• Genres (tags)
• Heart for favorites

Pull-to-refresh - swipe down to refresh. Empty state: "No available parties. Please adjust your search criteria."

Party map

• Shows all available parties as markers (pulsing for Live)
• Tap on marker centers map and opens details modal for the party
• From modal: "View party" goes to the details screen
• Multiple parties at the same location are grouped - priority goes to Live, otherwise earliest time

If you decline location permission, the map centers on a default location (e.g. Belgrade).

Club and performer profiles

"Clubs/Performers" tab:

• Top toggle: DJs / Bands / Clubs
• Filter "City" + field "Search by name" (300 ms debounce)
• Card grid with name, image and average rating

Tap on a card opens the profile with tabs:

• Parties - list of upcoming and current parties for this entity. Live ones get the "Live" badge
• Information - city, phone ("Reservations" for clubs, "Booking" for bands), about text
• Reviews - public ratings and comments from other users

1. Scan QR code

1. "Join party" (footer) → "Scan QR code"
2. Allow camera (first time)
3. The app recognizes:
   • Club or band QR (typical table/poster QR) - takes you to that entity's party (Live has priority, otherwise scheduled)
   • Specific party QR (form JUKEBOX_xxxx)

If the QR isn't valid, the screen silently ignores scanning. If it's valid but the code doesn't exist in the system → "Invalid code".

2. Enter code manually

1. "Join party" → "Enter code manually"
2. Field "Type the code here" → "Confirm"
3. Screen "Validating code" checks and opens party details

3. From the list/map (party details)

On the party details screen you see:

• Name, club/location, performer, genres, description
• Status (Live / Not started / Ended)
• Big "Join party" button - available only when party is Live
• For scheduled: countdown "Starts in…" or pulsing "Party starts any moment"

4. Party nearby (automatic)

If you're within ~100 m of a public Live party with location permission, it prompts:

"Party nearby!" "A live party is happening near you! Want to join?"

Buttons: "Not now" / "Join party". Tap the latter to go straight to the room (skipping details).

Once you decline a specific party, it won't prompt for the same one again.

Takeover header

• ← Back on the left
• Party name in the middle
• QR code icon on the right → opens modal with large QR code of the party and numeric code (with copy-to-clipboard icon)

Sticky song list header

• State bar: Live (pulsing dot + "Live"), Paused (gold bar + "Paused"), Ended ("Ended")
• Actions (only while room is active):
  • Leaderboard (trophy) - opens party leaderboard
  • Story (Instagram icon) - active when you have at least one accepted song; tap opens the Instagram Story generator
  • Exit → confirmation "Leave party" → "Are you sure you want to leave the party?"
• Premium info card - current premium threshold: "Available when you enter {amount} or more"
• Genres (tags)
• Paused banner when requests are paused: "Ordering is paused"

List toggle

• "All songs" - songs from all participants that are Accepted or Played (others' pending songs are not visible)
• "My songs" - all your songs, including pending

Empty: "No requested songs".

Song list

For each song you see:

• Song name, requester name
• Status (color + text)
• Amount paid
• Optional medal / trophy icons next to the player (their previous awards)
• If the song has a dedication: "With dedication" + text
• Likes (thumbs up + count) - see likes and rankings guide
• Cancellation (for your own pending songs)

Bottom: request button

Big "Request a song" button - visible only while the room is not ended. Opens the "Song request" screen.

The app remembers the active party - if you close the app, it brings you back to the same room until the party ends or you exit manually.

• Not started (Scheduled) - countdown "Starts in…" or "Party starts any moment". Only details visible, joining locked.
• Live - pulsing dot + "Live". Everything active: joining, ordering, likes, share.
• Paused - gold bar + "Paused" + banner "Ordering is paused". Existing songs wait, no new ones until resumed.
• Ended - "Ended" bar; toast "Party {name} has ended. Thanks for being with us!". App returns you to the party list; actions disappear.
• Expired - shown in list/map with the "Expired" badge. Doesn't open.

When the party resumes, you get a notification (provided Party status is enabled).

Party room → "Request a song" → opens "Song request".

Pick a song - 3 modes

1. Performer playlist (if it exists): tap the field "Pick a song" → modal "Song" with search. Empty: "No songs in the playlist match your search criteria."
2. Free input (when there's no playlist): field "Type song name" (up to 90 characters)
3. From favorites: heart icon → modal "Favorite songs". If a playlist exists, you only pick favorites that are also in the playlist. Empty: "No favorite songs".

Amount and request type

• Standard song - amount lower than the premium threshold. Classic queue. "Standard songs represent the minimum amount needed to send a request… higher amount = higher approval probability."
• Premium song - amount equal or above the premium threshold. Queue priority + optional dedication. "Premium requests have priority, and if the performer approves your request, your song will jump to the front of the queue…"

Premium threshold is shown in the song list header: "Available when you enter {amount} or more".

If the amount is too low (below the average offer): "Your offer is below the average price for this party. The chance of acceptance is low." - you can still confirm.

Dedication

The "With dedication" field is visible only:

1. if the performer allows dedications at this party, and
2. if the amount is at premium level

If you lower the amount below the premium threshold → the dedication is cleared.

Payment

• Funds - Jukebox points from your wallet
• Card - registered payment card

If you pick card with no card saved: "No payment card selected. Add a new card or pick an existing one." + add button.

Confirmation

• Title "Confirmation"
• Text: "You're paying {amount} for a song. Are you sure you want to continue?"
• Note: "You'll be charged only if the performer accepts your request."
• Checkbox for the "Terms of use and privacy policy" (required)

After sending: "Congratulations! Your song request was sent successfully. The performer will review your request and you'll be notified if it's accepted."

Cancelling a request

Only while the status is "Pending": × next to the song → confirm "Cancel song request" / "Are you sure you want to cancel the song request?".

• Cancellation is free (no charge has happened)
• Already accepted/played songs can't be cancelled

Cooldown 1 song / minute

After a successful submission, the button locks for 60s with the text "Wait". If you try too quickly: "You can request a song once per minute."

No global daily limit.

Editing a request - not possible

You can't change song/amount/dedication after sending. Cancel and send a new one.

• Pending - "Your song request has arrived! We'll let you know as soon as it's reviewed." You can cancel it.
• Payment in progress - the system is processing the payment, wait a few seconds
• Accepted - "Your request is accepted! Get ready, your song is coming up!" Charge has gone through.
• Live - "Your song is playing now! Enjoy the music and the vibe!"
• Played - "The requested song was performed. Your sound is on air! Enjoy!"
• Rejected - "Your request wasn't accepted. Don't worry, you weren't charged…"
• Cancelled - "You cancelled the song request. Don't worry, you weren't charged…"

Charge happens only on transition to "Accepted". Everything else: no charge.

Inbox (bell in the header)

Tapping the bell opens the notifications list. The red dot marks unread.

Notification types

• Song: sent, accepted, rejected, failed, cancelled, played, likes milestone
• Party: paused / resumed / ended
• Payment: successfully processed
• Voucher: voucher used
• Favorites: updates for favorite clubs/performers/parties
• Awards: referral points received, party winner, monthly city winner

Real-time toasts during the party

• Song accepted → "Your song ‘{name}’ was successfully accepted…"
• Song rejected → "Unfortunately, your song ‘{name}’ wasn't accepted…"
• Song failed → reason: insufficient funds, payment problem, or technical error
• Song cancelled → "Song request ‘{name}’ was cancelled…"
• Party ended → "Party {name} has ended. Thanks for being with us!"

Notification settings

Settings → Push notifications - 4 toggles:

• Payments - "Receive notifications when payment for a song request is successfully processed."
• Ordered songs - "… when your song request was successfully placed and added to the queue."
• Party status - "… about important updates regarding the party, such as ordering being re-enabled."
• Favorites - "… for clubs, performers or parties you've marked as favorites."

If system notifications are disabled on the device: "Notifications disabled. Open device settings to enable them." + button "Open settings".

Party QR code

In the party room → QR code icon in the header → modal with:

• Large QR code of the party
• Numeric code (below, with copy icon)

Useful for: showing friends, sharing with the table, or printing and putting on a table.

Can I request a song before the party starts?

No. The "Request a song" button is available only when the party is Live. You can order a song from anywhere (your home, car, abroad) - all you need is an active event in the app.

The party is paused - do I lose my place in the queue?

No. Existing songs wait, only new ones can't be sent while the pause lasts. You'll be notified when it resumes.

What if the song isn't in the performer's playlist?

If the performer doesn't use a playlist, you can type freely. If they use a playlist, you choose only from it (no free input).

Can I change the price after sending?

No. You can only cancel the request while it's "Pending" and send a new one.

The app puts me into the party room when I return - why?

Because it remembers you have an active party. If you want out, use the exit icon in the room header.

Nearby party doesn't show even though I'm close?

Check:

• that you have location permission
• that the party is Live and public
• that you didn't already say "Not now" for that exact party (once dismissed, it doesn't prompt again)

Can I share the party with a friend?

Yes - share the QR code from the party room (QR icon in the header) or the numeric party code.

Can I open another user's profile?

No - tapping a participant's name in the song list currently doesn't open their profile.