BridgePlay — User Guide

What every option in Settings and every button in the top bar does. The app lives at https://servetsvm.github.io/bridge/  ·  Norsk · Türkçe · Español · Français · Italiano · Deutsch · Русский · Polski · 中文

1. Top bar and buttons

PartWhat it does
Board boxThe board number. Red edges mark the vulnerable side, D marks the dealer.
ContractThe contract and declarer, with tricks taken (“Us / Them”). Tap it to see the whole auction with explanations.
TodayToday's IMP total (or MP average) and the result of the last board.
New DealDeals a new board. In the middle of a board it asks once more (“Sure?”) so you cannot lose a board by accident.
UndoTakes back your last call or card, together with the robots' moves after it. Tap again to go further back.
HintShows what the robot would do in your place: the suggested call with its meaning, or the suggested card (it rises in your hand).
ClaimAvailable with 8 tricks or fewer left. The remaining tricks are settled by perfect (double-dummy) play and the board ends.
🚪 / 💬Leave the table (asked inside the page) / the chat, with a red count of new messages.
☰Menu: Online, the turn sound 🔔 / 🔕, 📜 History, Results, Settings and Help (the guide in English, Türkçe, Norsk, Español or Français).

Bid explanations: tap any call in the auction table to see what it means and which convention it belongs to; tap again to close. Calls with a dotted underline are conventional.

Last trick: during play, tap the green middle of the table to see the last finished trick (the winning card is outlined). Tap again, or wait 4 seconds, to go back.

End of the board: all four hands stay open on the table and the yellow banner shows the result and IMPs. Tap the banner for details (robot tables, normal contract, double-dummy result); Next deal starts a new board.

Partner's signals on defence: when your robot partner signals in the first tricks (a Lavinthal discard, or a high/low card on your lead), a yellow line under the table tells you what it asks for.

2. Practise conventions

This is what the site is for: playing hands where the conventions you choose come up. Use the 📚 Practise conventions box at the top of the home page.

Review at the end of the board

The result in the middle shows a short summary (e.g. 📚 Stayman ✓). Tap it for the Convention review:

"Right" means what the robots' system bids: your base system and your convention card.

Your progress

Under the box: for each convention, the hands played and how often your calls were right (green 80%+, orange 50%+, red below). 🎯 Practise my weak spots picks your three weakest and deals at once. Progress belongs to your account and shows on your other devices when you are signed in.

➕ Add a convention — ask for a convention the robots do not know yet; requests go to the administrator and are added to the robots.

3. Play a specific deal

From a photo or screenshot

  1. Enter a deal → 📷 Read from a photo or screenshot → choose the picture.
  2. The four hands it read are shown. If a card is wrong, fix it in the code below.
  3. Play this deal.

It reads the end-of-board screen of your bridge app (four open hands drawn as card tiles) and hand records that list ♠ ♥ ♦ ♣ for each hand (ten written as “T” or “10”).

Privacy and memory: the picture is read on your device only. It is never saved, uploaded or kept by the app, and it is cleared from memory as soon as the cards are read. The cards that were read are forgotten when you start the deal or close the window. (The screenshot in your gallery is untouched — delete it yourself if you like.)

Typing the hands

Each hand as spades.hearts.diamonds.clubs, e.g. AKQ2.K73.J5.T942 (T = 10). Three hands are enough — leave the fourth empty and it is filled with the remaining cards. Or paste a PBN code: N:AKQ2.K73.J5.T942 … (four hands clockwise from North). Choose Dealer and Vulnerable.

4. Basic settings

SettingExplanation
Card styleClassic tiles: flat white card tiles side by side, like club bridge apps. Modern fan: overlapping fanned cards.
Your seatWhere you sit (North, East, South, West). Your hand is always at the bottom. When your side declares you play partner's hand too.
ScoringEvery board is also played at 10 expert robot tables. IMP: your score is compared with each table and converted to IMPs, then averaged (teams scoring). Matchpoints (%): the percentage of tables you beat (pairs scoring).
Opponents' systemSame as ours: the opponents use your card. Standard (SAYC): a plain standard system (Stayman, Jacoby 2NT, Gerber; no Lavinthal). Their calls are explained by their own system.
Robot speedHow fast the robots bid and play.
Bid explanationsWhether tapping a call shows its explanation.
Play a forced card automaticallyPlays your only legal card for you.
Delete score historyDeletes the score history on this device (cannot be undone).

Changes apply from the next deal. A deal is never dealt to you twice (except when you choose “Replay this deal”).

5. Our convention card

Base system (“Your system” next to your name on the home page, Our convention card or Settings; it shows next to your name in the lobby): 2/1 Game Force, SAYC, Acol (4-card majors, weak 1NT 12-14), French Standard SEF (2♦ game force), Precision Club (1♣ 16+, 1NT 13-15, special 2♣ and 2♦) and Polish Club (1♣ 12-14 balanced / long clubs / 18+, Multi 2♦). Choosing a system switches on its conventions; you can then change any of them. Your robot partner bids the same system (and so do the opponents with “Same as ours”). Default: 2/1. Each convention below can be switched on or off; ✓ = on by default. Pairs marked “↔” replace each other: switching one on switches the other off.

ConventionShort description
✓ 2/1 Game ForceOver a major opening, an unpassed responder's new suit at the two level is game forcing (12+). 1NT is forcing for one round (6-12).
✓ RKCB 14304NT asks for five key cards: 5♣ = 1/4, 5♦ = 3/0, 5♥ = 2 without the trump queen, 5♠ = 2 with it.
RKCB 0314Instead of RKCB 1430: 5♣ = 0/3, 5♦ = 1/4, 5♥ = 2 without the trump queen, 5♠ = 2 with it.
✓ GerberOver partner's 1NT, 2NT or 3NT with no suit agreed, 4♣ asks for aces: 4♦ 0/4, 4♥ 1, 4♠ 2, 4NT 3.
✓ Bergen RaisesOver 1M: 3♣ = 4-card support 7-9, 3♦ = 4-card 10-12, 3M = 4-card 0-6 (preemptive).
✓ Cappelletti ↔ DONTOver their 1NT: X penalty 15+, 2♣ one-suiter, 2♦ both majors, 2♥ = ♥ + a minor, 2♠ = ♠ + a minor, 2NT both minors.
✓ Jacoby 2NTOver a major opening: 4+ support, 13+, game forcing. Opener: new suit at 3 = singleton/void, at 4 = good 5-card side suit, 3M = 18+, 3NT = 15-17, 4M = minimum.
✓ Weak Jump Shifts ↔ Strong Jump ShiftsResponder's single jump in a new suit: 6+ cards, 0-5 HCP, to play.
✓ Stayman2♣ over 1NT (3♣ over 2NT) asks for a 4-card major.
✓ 4-Way TransfersOver 1NT: 2♦→♥, 2♥→♠, 2♠→♣, 2NT→♦.
✓ SmolenAfter 1NT–2♣–2♦, 5-4 in the majors with game values: bid the 4-card major at the three level, so the strong hand declares.
✓ Michaels / Unusual 2NTA cue bid of their suit = 5-5 two-suiter; a jump to 2NT = the two lowest unbid suits.
✓ SplintersDouble jump over a major opening = 4+ support, singleton or void in that suit, 12-15.
✓ Texas TransfersOver 1NT/2NT: 4♦→4♥, 4♥→4♠ (6+ major, game).
✓ Texas after interferenceTexas stays on when they double our 1NT or overcall at the 2-3 level. A bid in their suit is not a transfer: after a 2♥ overcall, 4♦ still shows hearts but a spade hand bids 4♠ directly.
✓ LebensohlAfter our 1NT is overcalled at the two level, 2NT forces opener to 3♣; a fast 3NT denies a stopper. A cue bid of their suit is Stayman: direct = no stopper, via 2NT = with a stopper.
✓ Lavinthal DiscardsDefensive signals: the suit discarded is not wanted; a high card asks for the higher of the two other suits, a low card for the lower (trumps and the suit led excluded). On partner's lead a high spot card encourages, the lowest discourages.
Roman Discards (odd-even)Instead of Lavinthal: the first discard of an odd card (3, 5, 7, 9) asks for that suit; an even card (2, 4, 6, 8, 10) does not want it, a low even card asks for the lower, a high one for the higher of the other two suits.
Inverted MinorsOver a minor opening: 2m = strong raise, 10+ (forcing); 3m = preemptive.
DruryA passed hand answers a third/fourth-seat 1M with 2♣ = 3+ support, 10-12.
New Minor ForcingAfter 1m–1M–1NT, the other minor is artificial and forcing, asking about a major fit.
Fourth Suit ForcingAfter three suits have been bid, the fourth suit is artificial and game forcing.
OgustOver partner's weak two, 2NT asks: 3♣ min/bad suit, 3♦ min/good, 3♥ max/bad, 3♠ max/good, 3NT AKQ.
Support DoubleAfter 1m–(P)–1M–(overcall), opener's double = exactly three-card support.
Responsive DoubleAfter partner's takeout double and their raise, double = 8+ with both unbid suits.
Strong Jump Shifts ↔ Weak Jump ShiftsResponder's jump in a new suit = 19+, slam interest.
DONT ↔ CappellettiOver their 1NT: X a one-suiter, 2♣ ♣ + a higher suit, 2♦ ♦ + a major, 2♥ both majors, 2♠ spades.
Gambling 3NTA 3NT opening = a solid 7+ card minor with no outside ace or king.

6. Sync between devices

Scores, statistics and the list of deals you have seen are kept in a private file on your GitHub account, so your phone and PC merge automatically. Offline, everything is kept on the device and merges when it is online again.

  1. Open github.com/settings/tokens/new?scopes=gist. Expiration: No expiration. Only gist ticked. Generate token.
  2. Copy the code starting with ghp_… (GitHub shows it only once).
  3. In the app: Settings → Sync → paste → Connect. Do the same on your other device.
The code works like a password — never share it. Disconnect removes it from the device.

7. Results and statistics

Statistics tab: boards played, total and per-board IMPs (or MP %), and total points for Today, This week, This month, This year and All time. Boards tab: date, contract, tricks, score and IMP/MP of the last 100 boards. Tap a board to see the four hands, the auction (tap a call for its meaning) and replay the play card by card at the table: ▶ plays the next card (◀ back, ⏮ ⏭ start/end, Play runs it by itself).

In the end-of-board details: the normal contract (the most common one at the robot tables), the double-dummy result of your contract and of the normal contract (tricks with perfect play), and each robot table's result. The screen shows both IMP and MP.

Play online with friends

  1. Everyone opens the app from the same link: https://servetsvm.github.io/bridge/. It always starts fresh on the home page: nothing is dealt and no table is opened. 🤖 Play with robots plays alone with robots (also offline).
  2. To open an online table (no password, anyone can): on the home page tap 🌐 Open an online table and choose: a Public table is listed in the lobby and anyone can ask to join; a Private table shows in the lobby with 🔒: invited players sit down at once, anyone else has to ask and you accept, and nobody can watch. To invite, tap Invite to my table next to a name under 👥 Players in the lobby (home page, waiting room or Online panel); the player gets a window and sits down at once with Join. A join request opens its own window with a sound; ✕ Close — answer later keeps the request waiting in the Online panel and the same request does not pop up again, even after a page refresh. Tap a player's name in the lobby to see their system and rating (today, this week, month, year, all time); tap the “Today: …” line on the home page to see your own (there is no Results button on the home page; the list of your boards opens with Results while playing). 🤖 Play with robots plays with robots; your table shows in the lobby as “playing with robots”, anyone can tap Ask to join and you accept. A player you declined or put off can ask again and you are asked again; only the automatic tries after a page refresh are not asked twice. The table opens as an empty waiting room and is listed under Open tables in everyone's lobby (the player's name or Robot at each side). If you opened the table, 🚪 Close table in the top bar closes it for everyone; during play tap a player's name to remove them (a robot takes the seat). 🔔 / 🔕 in the top bar turns the your-turn sound on and off. Sitting at or watching someone else's table, leave with 🚪 Leave in the top bar. A player who lost the connection shows “away · robot plays” next to their name; if they are not back within 10 minutes the seat is free.
  3. To join a table tap Ask to join (or Seat me at a table), type your name, pick partner, opponent or any free seat and tap Join. The request goes to the player who opened the table.
  4. The table's owner answers each request with Accept or Decline, and presses Start when everyone is seated.
  5. The host can take a player off with Remove. A player who drops out or closes the app goes straight back to the same table and seat when they open the link again within 10 minutes; a player who taps Leave the table leaves for good and the seat is freed at once.

Home page

Tournaments, spectators, profiles and turn alerts

Daily tournament, rating, sharing and analysis

8. Installing on phone and PC