Product Requirements Document

Free Bet Blackjack Strategy Trainer

← IST300 Sandbox
ProductFree Bet Blackjack Strategy Trainer
Document ownerTomoyoshi
StatusDraft for review
Last updated6 October 2026
Target releaseV1, December 2026
PrototypeTry the trainer

1. Summary

A browser-based trainer that deals Free Bet Blackjack hands and grades every player decision against published optimal strategy.

Free play for the variant exists. Optimal strategy for it is published. Nothing currently connects the two. Players who want to learn Free Bet either read a static chart with no way to practise against it, or drill standard blackjack and try to remember the differences at the table.

The same strategy engine also ships as a Chrome extension. A player adds it to Chrome, keeps it open in a side panel beside an online casino table, enters the hand, and gets the correct play before acting. The trainer builds the skill; the extension supports the player while it is still being learned.

V1 targets a single variant done correctly rather than several done approximately. The architecture separates the game module from the grading platform so additional variants become configuration rather than rebuilds.

2. Background

2.1 The problem

Learning a blackjack variant requires converting a strategy chart into decisions made at speed. That conversion needs repetitions against feedback. For standard blackjack, dozens of free tools provide exactly this. For variants, the tooling thins out sharply and, for Free Bet specifically, disappears.

The failure mode this creates is not ignorance but misapplication: players who know standard basic strategy apply it to a variant where several decisions differ, and have no mechanism to discover where they are wrong.

2.2 Competitive landscape

A survey of available tools was conducted on 17 September 2026.

GameFree playPublished strategyGraded trainer
Standard blackjackExtensiveYesExtensive
Spanish 21YesYesYes — HitOrSplit
Mississippi StudYesYesYes — Wizard of Odds, casinotrainer.net
Ultimate Texas Hold'emYesYesYes — dedicated product
Pai Gow PokerYesHouse way onlyPartial — teaches house way, not optimal
Free Bet BlackjackYesYesNone found
Blackjack SwitchYesYesNone found
Zappit 21YesYesNone found
Double ExposureYesYesNone found

Interpretation. The gap is narrower than "niche games are underserved" but real. Several variants assumed to be underserved are in fact well covered. Free Bet Blackjack is the clearest verified gap among variants with an active player base.

Counter-consideration. One research participant plays Spanish 21, has the problem this product solves, and never located the existing Spanish 21 trainer. Part of the observed gap is discoverability rather than absence, which bounds how strongly a market claim can be made.

3. Users

3.1 Primary user

A recreational player who already knows standard basic strategy and wants to learn a variant before playing it for money. Practises at home, in sessions of roughly ten to thirty minutes, typically ahead of a planned casino visit.

3.2 Secondary user

An online player of the same variant who wants the correct play during a hand. Plays in a desktop Chrome browser, where no other players are waiting and checking a source mid-hand costs nothing socially. Served by the Chrome extension (F9).

3.3 Explicitly not targeted

SegmentWhy not
Blackjack beginnersWell served by existing standard-blackjack trainers
Advantage playersCard counting is a distinct skill with its own mature tooling
Recreational gamblersThe product teaches and advises decisions; it takes no wagers and is not a gambling product

4. User research

Three participants, interviewed 17–22 September 2026. All three already knew standard basic strategy. Small sample; findings are directional.

4.1 Findings

Players do not consult references at a physical table. Two of three participants described making a decision under uncertainty and consulting a source only afterward. Both cited the same cause without prompting: other players waiting. One described asking the player beside him rather than checking his phone.

Context is lost before review happens. Both participants who reviewed a decision afterward reported being unable to recall the exact hand by the time they checked. The review therefore failed even when attempted.

Information is available; practice is not. Both had located a strategy chart and saved it. Neither had any means of practising against it. One asked specifically for randomly generated hands.

The constraint is the venue, not the game. The third participant plays online, where no other players are waiting, and does search for the correct play mid-hand. This bounds the first finding: the inhibitor is social, not informational.

4.2 What the research did not establish

No participant described tracking accuracy over time, drilling a specific situation deliberately, or checking table rules before sitting down. Requirements derived from those behaviours are marked as hypotheses in §6 and are scheduled after validation.

5. Goals

5.1 Product goals

  1. A player who has never played Free Bet can complete a graded practice session without consulting any source outside the product.
  2. Every decision is graded against a cited, verifiable strategy source.
  3. A player can review any hand from a session without having remembered it.

5.2 Success metrics

MetricTargetHow measured
Session completionA first-time user completes 20 hands without abandoningSession log
Grading correctness100% agreement with the cited chart across a fixed 200-hand regression setAutomated test suite
Time to first handUnder 60 seconds from landing to first decisionManual timing
Unassisted accuracy improvementMeasurable improvement across three sessions for a returning userSession summary

5.3 Non-goals

Growth, retention, and monetisation are out of scope for V1. The product has no acquisition strategy and none is planned.

6. Requirements

6.1 Product decisions

AreaDecisionRationale
Launch variantFree Bet BlackjackOnly verified gap with an active player base
PlatformResponsive web, desktop and mobile browser, plus a Chrome extension for online playThe web trainer needs no install; the extension goes where online players already are
Practice modelRandomly dealt hands, graded per decisionDirectly requested in research
Feedback timingImmediately after each decision, before the next dealNo social constraint in the practice context
Default rules6 decks · dealer hits soft 17 · dealer 22 pushes · free double on hard 9/10/11 · free split on all pairs except tens · blackjack pays 3:2Most common published configuration — pending confirmation against the chosen strategy source
Strategy sourceOne published Free Bet basic-strategy chart, cited in the repositoryGrading correctness is bounded by source correctness
AuthenticationNoneRemoves the largest barrier to a 60-second start
PersistenceBrowser local storage; chrome.storage.local in the extensionNo backend required
ExtensibilityGame logic and strategy data separated from the grading platformAdditional variants become configuration, and the extension reuses the same strategy data

Open dependency. The strategy source is not yet selected. If the chosen chart assumes a rule set other than the default above, the default changes to match the chart. This blocks F2 and must be resolved before implementation begins.

6.2 Features

F1 · Hand engine V1

Generates and resolves Free Bet Blackjack hands under the configured rule set.

Functional requirements

  • Deals from a six-deck shoe; reshuffles when penetration exceeds 75%
  • Applies free double on hard 9, 10 and 11
  • Applies free split on all pairs except ten-value pairs
  • Resolves a dealer total of 22 as a push against all non-busted hands
  • Pays 3:2 on blackjack, 1:1 otherwise
  • Offers hit, stand, double, split, and surrender where configured

Constraints

  • Must not deal a card combination impossible in a real six-deck shoe
  • Must not resolve any hand using standard blackjack payout rules

F2 · Decision grader V1

Compares each player action against the strategy source and returns a verdict.

Functional requirements

  • Resolves optimal play for the exact player total, hand composition and dealer upcard
  • Returns a verdict and names the optimal action regardless of outcome
  • Renders within 1 second of the action and before the next card is dealt
  • Flags hands where the player requested the answer before acting, and excludes them from unassisted accuracy

Constraints

  • Must report a gap rather than infer a verdict where the chart has no entry
  • Must never return an incorrect verdict for an optimal action

Depends on the strategy source decision in §6.1.

F3 · Session log V1

Records every hand for review after play.

Functional requirements

  • Stores player cards, dealer upcard, dealer final total, action taken, optimal action, verdict, assisted flag, and timestamp
  • Presents hands newest first, with misplays visually distinguished
  • Persists across page refresh

Constraints

  • Must not require re-entry of any card value to review a hand
  • Must surface storage failure rather than presenting an empty history

Addresses the context-loss finding in §4.1.

F4 · Rule primer V1

Explains how Free Bet differs from standard blackjack.

Functional requirements

  • Displays the three rule differences before the first hand of a first session
  • Remains reachable from a persistent control
  • Pauses play and preserves hand state when opened mid-hand

Constraints

  • Must not display automatically on return visits
  • Must not deal a card while open

F5 · Session summary V1.1 Hypothesis

Reports session performance.

Validation status. No research participant described tracking accuracy. This feature is scheduled after validation and is the designated cut if validation fails. Removing it does not affect V1.

Functional requirements

  • Reports hands played, unassisted accuracy, assisted count, and most frequently misplayed situation type
  • Reports raw counts rather than a percentage below ten unassisted hands

Constraints

  • Must not present a percentage derived from fewer than ten hands
  • Must not pool assisted and unassisted hands into a single figure

F6 · Decision rationale V1.1

Explains why the optimal action is optimal.

Functional requirements

  • Presents the expected value of both the optimal action and the action taken
  • States that a decision is marginal where two actions fall within 0.1% EV

Validation status. Partially supported. One participant acted on a heuristic rather than understanding, which implies but does not establish the need.

F7 · Configurable house rules V2 Hypothesis

Allows the rule set to be matched to a specific casino's table.

Validation status. Not supported by research. No participant described checking table rules. Deferred pending validation.

F8 · Additional variants V2

Adds a second game module, Spanish 21 being the leading candidate.

Architecture supports this from V1; no implementation in V1.

F9 · Chrome extension for online play V1.1

Gives the correct play during a live online hand.

Functional requirements

  • Installs as a Chrome extension (Manifest V3) from the Chrome Web Store, and loads unpacked during development
  • Opens in Chrome's side panel so the casino table stays visible beside it
  • Lets the player enter their cards and the dealer upcard by click or keyboard in under 5 seconds
  • Returns the optimal action within 1 second of the last card being entered, including whether a free double or free split applies
  • Reads from the same strategy data as F2, so the trainer and the extension can never disagree
  • Works offline, with no network requests after install
  • Saves each looked-up hand so it can be reviewed afterward in the session log (F3)

Constraints

  • Must not read, click, or bet on the casino page. It advises; the player makes every choice
  • Must request no host permissions, so it has no access to any web page's content
  • Must state the rule set its advice assumes, and warn that the advice may be wrong at a table with different rules
  • Must not collect personal data, and must not send hand data off the device

Validation status. Supported by one participant: the online player searches for the correct play mid-hand (§4.1). One participant is a narrow base.

6.3 Screens

#ScreenPurposeFeatures
1StartVariant selection, rule primer, begin sessionF4
2TablePlay, act, receive verdictsF1, F2
3SummarySession performanceF5
4LogHand-by-hand reviewF3
5Extension side panelEnter a live hand, get the correct playF9

Screens 3 and 4 may be implemented as one page with two views.

7. Scope

7.1 In scope for V1

F1 through F4, across screens 1, 2 and 4. The releasable increment is: read the rule differences, play randomly dealt hands under correct variant rules, receive a graded verdict on each decision, review the session afterward.

7.2 Out of scope, with rationale

ExcludedRationale
Live assistance at a physical tableResearch finding — two of three participants will not consult any source mid-hand, both citing other players waiting. The product would be unused at the moment it was designed for
Reading the casino page or playing automaticallyThe extension (F9) only advises on hands the player enters. Reading or clicking the table needs page access, breaks with every casino's markup, and turns an advice tool into a bot that casino terms prohibit
Real-money playChanges product category, legal exposure, and audience
PokerNo fixed optimal-play table; correct play depends on opponent modelling. Grading model does not apply
Games requiring a runtime solverConnect 4, chess, checkers. Correct play must be computed per position rather than looked up, requiring a different engine
Card counting and count deviationsDistinct skill, mature existing tooling, limited applicability where continuous shufflers are used
Accounts, profiles, leaderboardsContradicts the no-authentication decision. No research support
Bankroll simulationChips are displayed so free doubles are legible. No bankroll is tracked. The product teaches decisions, not money management

8. Release plan

ReleaseContentsGate
V1F1, F2, F3, F4A first-time user completes 20 graded hands and reviews the session, unaided
V1.1F5, F6, F9F5 conditional on validation. F9: a user installs the extension, enters a hand, and receives the correct play unaided
V2F7, F8F7 conditional on validation

9. V1 launch readiness

V1 ships when every item below is true. Anything unchecked is a blocker, not a nice-to-have — the list is deliberately short so that it stays honest.

9.1 Blocking before implementation

  • Strategy source selected, cited, and stored in the repository with its assumed rule set recorded
  • Default rule set in §6.1 confirmed against that source, or amended to match it
  • Regression set of 200 hands with known-correct actions built from the source

9.2 Correctness

  • Free double applies on hard 9, 10 and 11, and on no other total
  • Free split applies on all pairs except ten-value pairs
  • Dealer 22 pushes against every non-busted hand, and only against non-busted hands
  • Blackjack pays 3:2; all other wins pay 1:1
  • Shoe cannot produce a card combination impossible in six decks
  • Grader agrees with the cited chart on all 200 regression hands
  • Grader reports a gap rather than inferring a verdict where the chart has no entry
  • No optimal action is ever returned as incorrect

9.3 Function

  • A session can be started and a first decision made within 60 seconds of landing
  • No account, email address, or payment detail is requested at any point
  • Verdict renders within 1 second of the action and before the next card
  • Assisted hands are flagged and excluded from unassisted accuracy
  • Session log records all nine fields listed in F3 and survives a page refresh
  • Any hand can be reviewed without re-entering a card value
  • Storage failure is surfaced rather than presented as an empty history
  • Rule primer displays on a first session, not on return visits, and never deals a card while open

9.4 Quality

  • Usable on a phone browser in portrait
  • Keyboard-operable end to end, with visible focus
  • No real-money wager, deposit, or cash-out path exists anywhere in the product
  • Automated test coverage on the hand engine and the grader

9.5 Acceptance

  • A user who has never played Free Bet completes 20 graded hands unaided, without consulting any source outside the product
  • The same user can then identify, from the log alone, which hands they misplayed

10. Future direction

Online play. The research indicates that the constraint on mid-hand reference is social rather than informational. Where no other players are waiting, users do consult sources during a hand. The Chrome extension (F9) serves that need from V1.1. Possible later steps are other browsers and per-casino rule presets (with F7). Reading table state automatically stays out of scope (§7.2).

Variant expansion. Blackjack Switch, Zappit 21 and Double Exposure show the same profile as Free Bet: free play available, strategy published, no graded trainer. Each is configuration against the V1 platform rather than new engineering.

11. Dependencies

DependencyBlocksStatus
Published Free Bet strategy chart, with its assumed rule setF2, and the rule-set decision in §6.1Unresolved
Validation of F5 and F7 hypothesesV1.1 and V2 scopeUnresolved
Chrome Web Store review of a gambling-related extensionPublic release of F9Unresolved

12. Risks

RiskImpactLikelihoodMitigation
Strategy source incorrect or assumes a different rule setEvery verdict is wrong; the product actively teaches errorMediumCite the source; cross-check against a second; regression-test 200 known hands
Variant rules implemented incorrectlyUsers drill the wrong strategyMediumEach rule tested in isolation against F1's constraints
Research sample of threeRequirements rest on a narrow baseHighHypotheses labelled rather than presented as findings; conditional features scheduled after V1
Discoverability, not absence, is the real gapThe product is built and never foundMediumAccepted. No acquisition strategy in V1
An online casino's terms forbid assistance softwareThe player's account is closed or winnings are voidedMediumNo page access and no automation, so the extension works like a printed chart. The store listing tells users to check their casino's terms
Extension advice used at a table with different rulesReal money is lost on plays that are wrong for that tableMediumAssumed rule set shown on every answer; per-casino rules deferred to F7
The extension reads as encouraging gamblingStore rejection; harm to at-risk usersLowNo wagers, deposits, bonuses, or affiliate links. Links to problem-gambling help in the panel

13. Open questions

  1. Which published Free Bet chart is authoritative, and what rule set does it assume? Blocks implementation.
  2. Do the F5 and F7 hypotheses survive further research, or are they cut?
  3. When the online player searches mid-hand, does he find variant-specific guidance or standard-blackjack advice? Unasked; would sharpen §10.
  4. Does the grading model need to handle composition-dependent decisions, or is total-plus-upcard sufficient for this variant?
  5. Which online casinos offer Free Bet Blackjack, and do their terms permit a strategy reference during play?
  6. Will the Chrome Web Store accept the extension, and under which policy category?