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
| Part | What it does |
|---|---|
| Board box | The board number. Red edges mark the vulnerable side, D marks the dealer. |
| Contract | The contract and declarer, with tricks taken (“Us / Them”). Tap it to see the whole auction with explanations. |
| Today | Today's IMP total (or MP average) and the result of the last board. |
| New Deal | Deals a new board. In the middle of a board it asks once more (“Sure?”) so you cannot lose a board by accident. |
| Undo | Takes back your last call or card, together with the robots' moves after it. Tap again to go further back. |
| Hint | Shows what the robot would do in your place: the suggested call with its meaning, or the suggested card (it rises in your hand). |
| Claim | Available 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.
- Base system ▾ — the system you and the robots play (2/1, SAYC, Acol, SEF, Precision, Polish Club). Its name is shown underneath.
- Practice a convention ▾ — tick the ones to practise, as many as you like. At the top, Basics (every system): Transfer, Strong 2♣, Weak two, Negative double… then the ones in your system and the ones not in it. A convention you tick is switched on in your card. Off — normal random deals ends practice.
- ▶ Deal practice — deals a hand where one of them comes up. For rare conventions (Gambling 3NT, Gerber, Smolen…) the hands they need are built for you, so there is no waiting.
- ⚠ warning — if a chosen convention never comes up in your base system (e.g. Strong 2♣ in Precision), a warning appears under the box.
- 📚 Show me when a practised convention can be used — when ticked, a yellow line appears over the bidding box on the turn where a practised convention fits. It does not say which call.
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:
- ✓ — your call is the system's; its meaning is shown.
- ✗ — your call and what the system bids, with the reason. 🔁 Play this hand again and find the right call deals the same cards again.
- 🤝 — partner's conventional call, what it means and a short description of the convention (not scored).
"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
- Enter a deal → 📷 Read from a photo or screenshot → choose the picture.
- The four hands it read are shown. If a card is wrong, fix it in the code below.
- 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”).
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
| Setting | Explanation |
|---|---|
| Card style | Classic tiles: flat white card tiles side by side, like club bridge apps. Modern fan: overlapping fanned cards. |
| Your seat | Where you sit (North, East, South, West). Your hand is always at the bottom. When your side declares you play partner's hand too. |
| Scoring | Every 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' system | Same 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 speed | How fast the robots bid and play. |
| Bid explanations | Whether tapping a call shows its explanation. |
| Play a forced card automatically | Plays your only legal card for you. |
| Delete score history | Deletes 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.
| Convention | Short description |
|---|---|
| ✓ 2/1 Game Force | Over 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 1430 | 4NT asks for five key cards: 5♣ = 1/4, 5♦ = 3/0, 5♥ = 2 without the trump queen, 5♠ = 2 with it. |
| RKCB 0314 | Instead of RKCB 1430: 5♣ = 0/3, 5♦ = 1/4, 5♥ = 2 without the trump queen, 5♠ = 2 with it. |
| ✓ Gerber | Over partner's 1NT, 2NT or 3NT with no suit agreed, 4♣ asks for aces: 4♦ 0/4, 4♥ 1, 4♠ 2, 4NT 3. |
| ✓ Bergen Raises | Over 1M: 3♣ = 4-card support 7-9, 3♦ = 4-card 10-12, 3M = 4-card 0-6 (preemptive). |
| ✓ Cappelletti ↔ DONT | Over their 1NT: X penalty 15+, 2♣ one-suiter, 2♦ both majors, 2♥ = ♥ + a minor, 2♠ = ♠ + a minor, 2NT both minors. |
| ✓ Jacoby 2NT | Over 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 Shifts | Responder's single jump in a new suit: 6+ cards, 0-5 HCP, to play. |
| ✓ Stayman | 2♣ over 1NT (3♣ over 2NT) asks for a 4-card major. |
| ✓ 4-Way Transfers | Over 1NT: 2♦→♥, 2♥→♠, 2♠→♣, 2NT→♦. |
| ✓ Smolen | After 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 2NT | A cue bid of their suit = 5-5 two-suiter; a jump to 2NT = the two lowest unbid suits. |
| ✓ Splinters | Double jump over a major opening = 4+ support, singleton or void in that suit, 12-15. |
| ✓ Texas Transfers | Over 1NT/2NT: 4♦→4♥, 4♥→4♠ (6+ major, game). |
| ✓ Texas after interference | Texas 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. |
| ✓ Lebensohl | After 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 Discards | Defensive 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 Minors | Over a minor opening: 2m = strong raise, 10+ (forcing); 3m = preemptive. |
| Drury | A passed hand answers a third/fourth-seat 1M with 2♣ = 3+ support, 10-12. |
| New Minor Forcing | After 1m–1M–1NT, the other minor is artificial and forcing, asking about a major fit. |
| Fourth Suit Forcing | After three suits have been bid, the fourth suit is artificial and game forcing. |
| Ogust | Over partner's weak two, 2NT asks: 3♣ min/bad suit, 3♦ min/good, 3♥ max/bad, 3♠ max/good, 3NT AKQ. |
| Support Double | After 1m–(P)–1M–(overcall), opener's double = exactly three-card support. |
| Responsive Double | After partner's takeout double and their raise, double = 8+ with both unbid suits. |
| Strong Jump Shifts ↔ Weak Jump Shifts | Responder's jump in a new suit = 19+, slam interest. |
| DONT ↔ Cappelletti | Over their 1NT: X a one-suiter, 2♣ ♣ + a higher suit, 2♦ ♦ + a major, 2♥ both majors, 2♠ spades. |
| Gambling 3NT | A 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.
- Open
github.com/settings/tokens/new?scopes=gist. Expiration: No expiration. Only gist ticked. Generate token. - Copy the code starting with
ghp_…(GitHub shows it only once). - In the app: Settings → Sync → paste → Connect. Do the same on your other 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
- 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).
- 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.
- 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.
- The table's owner answers each request with Accept or Decline, and presses Start when everyone is seated.
- 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
- The app always opens on the home page: nothing is dealt and no table is opened. At the top: 🌐 Language (English, Türkçe, Norsk, Español, Français), ⚙ Settings and ? this guide. Menus, buttons, seats and the convention card follow the language (the robots' bid explanations stay in English).
- Your name and Your system: the system shows next to your name in the lobby and your robot partner bids it too.
- The main buttons, each in its own colour: 🤖 Play with robots (green), 🌐 Open an online table (blue), Seat me at a table (yellow: finds an open table where a robot is playing and asks to join; when its host accepts, you take the robot's seat), 🏆 Tournaments (purple), 👁 Watch a table (teal) and 📋 Convention card (brown). ⌂ or 🚪 in a game goes back to a fresh home page (an unfinished board is not kept).
- Convention card: choose the base system and switch conventions on and off right on the home page; tap a name for its description.
- Lobby chat: a column on the right on a computer; on a phone (or a narrow window) the 💬 button opens it from the bottom of the screen (it shows unread messages) and it closes after Send or ✕. Tournaments, our convention card and the players in the lobby open with the buttons at the top too. Everyone who has the app open can talk. 🗑 clears the chat on this device for good (old messages do not come back). There is a chat while playing too: a column to the right of the table on a computer; on a phone the 💬 button in the top bar, next to ☰, opens it from the bottom (a red number shows new messages) and it stays open until ✕; at an online table it has Table and Lobby tabs.
- At an online table a guest who taps New Deal during play sends the host a request for a new deal. The Online panel shows the table score (NS–EW); a guest can ask for it to be reset. The host decides both.
Tournaments, spectators, profiles and turn alerts
- Tournament list: tabs All, Registering, Running and Mine; each tournament shows its name and organiser, format, boards, ranking, players, status and the time left, with its buttons (Register, Play, Standings…). On a phone each tournament is a small card.
- Tournament: 🏆 Tournaments → ➕ New tournament. On the set-up screen first choose a type: ⚡ Speedball (individual, 4 boards, MP, 3 hours), 🤖 Robot individual (8 boards, MP, a day), 🌙 Daylong (12 boards, IMP, a day), 👥 Pairs (MP) and 💼 IMP pairs (at tables), 🏅 Team match (two teams of four at two tables, the boards compared table against table in IMPs, with a running score) or ⚙ Custom. A type fills in the options; then: name, number of boards (4–24), format, ranking (MP % or IMP) and how long it is kept (3 hours, 1 day, 3 days). Individual: the invited players play the same deals at their own table with robots, sitting South. An individual tournament is open to everyone in the lobby: it shows in the Tournaments list and on the card of the table where it is being played, with “🏆 Join the tournament”; anyone can join and play the same boards while it is kept. At tables (the default, starting with 2 tables): pick the number of tables (1–6) and type each table's N, E, S and W players in advance (names from the lobby are suggested; robots play empty seats). Send the invitations → answers ✓/✗ → Start the tournament (even alone: robots play the empty seats, your table opens at once and is listed in the lobby, and anyone who comes later can ask for a robot's seat). Then the first player named at each table taps Open table N; the others are invited and sit down in their own seats at once (or tap Join table N). Every table plays the same boards; N–S and E–W pairs are ranked separately. Only the organiser can close a tournament: the ✕ next to it in the list is shown to them only. In an individual tournament you are asked where you sit (N, E, S or W) before the first board and keep that seat; N–S players are ranked with N–S, E–W with E–W. Every board is also played at 10 robot tables; the 🤖 IMP and 🤖 MP % columns in the standings are your score against them, and they rank the players while nobody else has played.
- Private message: tap 💬 next to a name under 👥 Players in the lobby to write to that player only; an incoming message plays a sound and shows a red count.
- Spectator: in the open tables list, tap 👁 Watch on an online table. When the host accepts, you see all four hands; you cannot bid or play, but you can write in the table chat.
- Player card: tap a name in the lobby: name, where the player is, Country/Region, Skill level, Joined (the first day they played), Logins (how often they opened the app: 50+, 100+ … 5000+), Title (from the boards played: Newcomer, Player 100+, Strategist 500+, Master 2000+, Grandmaster 5000+), their convention card in one line (system, notrump range and the conventions switched on), the all-time total (boards, IMP per board, MP %) and the buttons Message, Play as partners and Add as friend. On your own card (the “Today: …” line) you can change your name, system, skill level and country, and open the convention card.
- Turn alert: a short sound and a buzz when it is your turn to bid or play. Settings → “Sound and buzz when it is your turn”: at online tables (default), always, or off.
- Your device runs the table (rules, robots, scoring): keep the app open while you play. Each player only receives the cards they are allowed to see.
- Only the host deals a new board during play; after a board anyone can tap Next deal.
- Undo takes back your own last call or card; at an online table the other side is asked first (Accept / Decline) when a person sits there, with robots it happens at once. Claim: you choose how many of the remaining tricks you take; a player on the other side accepts or declines, robots check it double dummy and do not accept more than can be made. When the robots will surely take all the remaining tricks (the last 2–8), they claim and ask you; decline and play goes on. The table chat tells everybody what happened. When a claim is asked, the remaining cards of all four hands are shown face up on the table, with a small Accept / Decline box in the middle (no extra window). While playing: the name label of the player whose turn it is lights up yellow; the contract box shows both sides' tricks in large figures. 📜 History lists the boards you played today (contract, result, score, IMP, MP and the totals); tap one to see the hands, the auction and the play card by card, and ◀ ▶ to go to the previous or next board. The top bar keeps only the buttons used most; Online, the 🔔 sound, 📜 History, Results, Settings and Help are in the ☰ menu. The host's app reminds a player who has not called or played for 45 seconds (again at 90), and tells the host. Under a tournament's standings, Other tables lets you pick a board and see everyone's contract, result and score on it. A message to someone who is not in the lobby (mail) is delivered when they come (⏳ waiting, ✓ delivered). ☆ Add as friend on a player's card: friends show first in the lobby with ★ and you hear when they arrive. The dummy opposite you is laid out one suit per column, as on a real table; a card played slides in from its player and a finished trick slides to the side that won it. On a player's card, 🤝 Play as partners opens a table listed in the lobby and invites that player to the seat opposite you; the other two seats are for opponents. 👁 Watch a table on the home page takes you to the busiest online table as a spectator; the table’s host (or the player with robots) accepts or declines a spectator; a tournament board can only be watched by someone who has already played that tournament or been at that table. In the standings of a tournament you have finished, 🔁 Practice these boards lets you play the same boards again as practice (nothing is recorded), and after each board your score is compared with everyone who played it in the tournament.
- Chat (top bar): write to the whole table or tap a quick message (Well played, Sorry partner, 👍…). The button shows how many messages you have not read.
- Every player gets the board in their own results and statistics.
- When a player's connection drops, a robot plays their seat at once; the seat is kept for them for 10 minutes and they get it back without asking when they return (the app reconnects by itself). A player who wants another seat asks with Sit here in the waiting room (or from the Online panel after a board); the host accepts or declines. Close the table ends the session; guests return to their own game.
- The connection is direct between the devices. On some mobile networks it cannot be made — Wi-Fi usually works.
Daily tournament, rating, sharing and analysis
- 🗓 Daily tournament (home page): the same 8 boards for everyone each day, played with robots from South. The line shows how many boards you have played and your place; tap it for the next board or the ranking. The two previous days’ rankings are kept.
- Rating: 1500 + your IMPs against the robot tables over your last 200 boards (cautious with few boards). It shows on the player card. 🏅 Leaderboard: under 👥 Players in the lobby, the top 10 of the players seen this week.
- 🔗 Share: at the end of a board, or on a board in Results; the link goes through the phone’s share menu or is copied. Whoever opens it plays the same deal with robots. Tournament boards cannot be shared.
- 🔍 Check my card play: every card your side played is compared double dummy with the other cards; a card that lost tricks is shown with the better card and the tricks it would have gained.
- Settings: Screen (automatic / light / dark), Card size (normal / large), Table sounds, Notifications (while the app is open in the background; a closed app gets none).
- The robots’ bid explanations now come in your language.
- Name and PIN: when you first open the app you choose your name and a 4-digit PIN; nobody else can take the name, and you use the same name and PIN on another device. Change your name with ✏️ on your card.
- Lobby chat: the players are on the left — friends first, then those playing, those waiting in the lobby and last the ones offline; the counts of online / playing / offline are on top. Tap a name to write a private message: it shows in purple and only that player sees it (✕ goes back to the open chat). ⓘ opens the player card. During a game the chat is in the ☰ menu.
- Signing in: "🆕 I'm new here" takes a free name and a PIN (if the name is taken, free names are offered); "🔑 I have a name" signs in with your name and PIN. Your results, rating and settings come to every device with the same name and PIN.
- Look (Settings): Table (green, blue, wood, red, dark), Card back, Deck (2 colours or 4 colours: ♣ green, ♦ orange). The seat box is red when that side is vulnerable, green when not. Choose a picture on your card; it shows next to your name in the list.
- Keyboard (computer): bidding "1" then "s" = 1♠ (c d h s n), p = pass, x = double, r = redouble; playing ← → picks a card, Enter plays it, or type "a" then "s" = A♠.
- 🧩 Problem of the day (home page): the same deal and one question for everyone each day — what do you open, partner opened what do you answer, what do you lead. Afterwards you see the robot's call and its meaning, or for a lead how many tricks each card gives the defence (double dummy). Right answers on days in a row are counted.
- Opponent robots (Settings): Beginner, Medium or Expert. Only when you play alone with robots; your partner always plays its best, and tournaments and online tables use expert robots.
- Club: write your club on your card. In the leaderboard the "🏛 your club" tab is the club ranking; when you set up a tournament, "Who can play" can limit it to your club's players.
- When the host leaves: closing the table during a board, "Hand the table" gives the board to one player and the others move to their table; a robot plays your seat. If the host's app just closes, after a minute the players left go on at the first player's table with a new board.
- PBN / LIN files: in Results, "Save as PBN file" saves every board; in a board's details 💾 PBN / 💾 LIN saves that board. In "Enter a deal", "Open a PBN or LIN file" plays the file's deals one after the other.
8. Installing on phone and PC
- Phone: open the address in Chrome → ⋮ menu → Add to Home screen. It opens from its icon and works offline.
- PC: the “Install” icon in the address bar of Chrome or Edge.
- Updates: new versions install themselves the next time you open the app.