Back to home

PulseCup Docs

How to use PulseCup

Getting Started

PulseCup is a mobile-first World Cup companion app. It turns live match data into instant fan reactions, streak challenges, and shareable recap cards.

Quick start

  1. Open the app and browse matches on the Matches tab.
  2. Pick a live, upcoming, or finished match.
  3. React to moments as they happen.
  4. Answer challenges to build your streak.
  5. After the match, check your recap card on your Profile.

No sign-up is required. PulseCup uses a guest profile stored locally on your device.

Live Room

The Live Room is where you experience a match in real time. When a goal, card, corner, or other event occurs, PulseCup surfaces a reaction prompt or challenge.

Reaction prompts

Tap an emoji to react to goals, saves, cards, and momentum shifts. Your reaction is recorded with the match timeline.

Fan Pulse

See how other fans are reacting in real time. The pulse bar shows the split across reaction types.

Challenge cards

Answer quick yes/no questions about what happens next. Correct answers grow your streak.

Streak bar

Track your current streak and fan mood. Higher streaks unlock escalating mood tiers.

Live rooms poll match data every 10 seconds. Events are classified and matched to the correct moment in the match timeline.

Replay Mode

When no live match is available, Replay Mode lets you experience a full match flow using historical event data. It works exactly like a live room, but events are played back sequentially.

Replay controls

  • Play / Pause - Start or pause the replay at any time.
  • Speed - Adjust playback speed from 2x to 16x.
  • Restart - Jump back to the beginning of the match.
  • Auto-pause - The replay pauses automatically when a challenge appears so you can answer.

Try the demo replay at /app/replay/1 to see how it works.

Challenges & Streaks

Challenges are quick prediction questions triggered by match events. Answer correctly to build your streak and climb the mood ladder.

Challenge types

Next Goal

Predict whether the next event will be a goal.

"Will the next event be a goal?"

Total Goals Reach 3

Predict whether the total goals in the match will reach 3.

"Will there be 3 or more goals by the 60th minute?"

Next Major Event

Predict the next significant event (goal, card, or corner).

"What happens next - a goal, a card, or a corner?"

Streak mood tiers

Streak 0-1Casual Fan
Streak 2-3Getting Warm
Streak 4-5Sharp Eye
Streak 6-7Chaos Merchant
Streak 8+Legend

Recap Cards

After a match ends, PulseCup generates a recap card summarizing your performance. It includes your final streak, best call, total reactions, and overall fan mood.

What is on a recap card

  • Final score and match info
  • Best streak reached
  • Total correct challenge answers
  • Number of reactions
  • Overall fan mood tier
  • Unique shareable link

View your recap cards on your Profile page. Share a card by copying its link from the share button.

Guest Mode

PulseCup does not require an account. A guest profile is created automatically and stored in your browser's local storage.

What guest mode means

  • No sign-up or login required
  • Your reactions, streaks, and recaps are tied to your device
  • Clearing browser data will reset your guest profile
  • Solana wallet connection is optional and not required

FAQ

Is PulseCup a betting app?

No. PulseCup is a social fan experience. There are no wagers, escrow pools, odds trading, or payouts.

How does PulseCup get match data?

PulseCup uses the TxLINE sports data API to receive live match events, scores, and timelines.

Can I use PulseCup during any World Cup match?

Yes. PulseCup works with any match available through TxLINE. Live rooms activate when match data is streaming.

What happens if I clear my browser data?

Your guest profile, reactions, streaks, and recaps are stored locally. Clearing browser data will reset your profile.

Is there a Solana wallet requirement?

No. Wallet connection is optional. PulseCup works fully in guest mode without any blockchain interaction.

How do I share a recap card?

After a match, go to your Profile, tap a recap card, and use the share button to copy a unique link.

Back to PulseCup