Shuffle21 White Paper

LAST UPDATED: [INSERT DATE BEFORE PRODUCTION DEPLOYMENT]

1. Executive Summary

Shuffle21 is a free, entertainment-only classic card-game website developed and operated by Project Research LLC. It offers five well-known card games — Klondike Solitaire, Spider Solitaire, Blackjack, Go Fish, and Hearts — built entirely with HTML5, CSS3, and vanilla JavaScript, with no real-money gambling, no accounts required for basic play, and no server-side infrastructure beyond ordinary static web hosting. This white paper explains the product's purpose, how it is built, how its fictional play-money system works, and the principles guiding its development, including our approach to AI-assisted development, accessibility, and security.

2. Vision & Purpose

The goal of Shuffle21 is simple: give people a clean, modern, ad-free-feeling place to play classic card games casually, the way they might on a physical table with friends — without the visual language, mechanics, or monetary stakes of a gambling platform. Shuffle21 is designed to feel like a well-made casual game, not a casino.

3. Product Overview

Shuffle21 currently includes five fully playable games:

• Klondike Solitaire — the classic single-player patience game, with Draw 1 and Draw 3 modes.
• Spider Solitaire — sequence-building solitaire with 1, 2, or 4 suit difficulty levels.
• Blackjack — a simulated dealer-versus-player card game played entirely with fictional play money.
• Go Fish — a single-player game against a computer opponent, built around asking, matching, and collecting books.
• Hearts — a four-player trick-taking game against three computer-controlled opponents.

Every game includes an in-page "How to Play" reference, sensible defaults, and shared conveniences such as sound effects (off by default), a reduced-animation setting, and a persistent fictional play-money balance.

4. Technology Architecture

Shuffle21 is intentionally built without a framework, build step, backend server, or database. The entire site is static HTML, CSS, and vanilla JavaScript (ES6+), which keeps the codebase simple to audit, fast to load, and deployable on ordinary static web hosting. Card rendering, shuffling, and dealing logic live in a small shared engine (deck.js) reused by every game, rather than being duplicated five times. Preferences and the fictional balance are stored in the browser's localStorage under a site-specific key prefix; sound effects are synthesized at runtime with the Web Audio API rather than shipped as audio files. No third-party analytics, advertising, or tracking scripts are embedded in the games themselves.

5. The Virtual Economy

Shuffle21 uses a single fictional "play money" balance, starting at $10,000, primarily used for Blackjack wagers. This balance:

• Has no real-world monetary value under any circumstance.
• Cannot be purchased with real money, sold, transferred, or withdrawn.
• Can be reset back to $10,000 at any time from Settings.
• Is stored only in the visitor's own browser — there is no shared or persistent server-side ledger.

This design exists purely to make Blackjack function as a game with stakes that matter within a single session, without ever creating a real financial relationship between Shuffle21 and its visitors. See our Terms of Use for the complete legal treatment of virtual currency.

6. Responsible Entertainment Commitment

Shuffle21 is built and marketed as a casual entertainment product, not a gambling service. There are no deposits, no withdrawals, no cash prizes, no cryptocurrency integrations, and no gambling-related APIs anywhere on the site. Visual design deliberately avoids slot-machine aesthetics, flashing casino graphics, or imagery suggesting real cash winnings.

7. AI-Assisted Development Disclosure

Portions of Shuffle21's code, layout, and written content were produced with the assistance of AI tools and reviewed by Project Research LLC before publication. We believe in disclosing this plainly rather than leaving it implicit. Our governing principles — human review before production use, testing of AI-assisted output, and no autonomous AI decision-making about users — are set out in full in our AI Governance Policy.

8. Accessibility Commitment

We want Shuffle21 to be usable by as many people as reasonably possible, including people who use screen readers, keyboard-only navigation, or assistive technology, and people who are blind, have low vision, or are hard of seeing. Concretely, this includes semantic HTML, ARIA labeling and live regions for game state changes, keyboard-operable menus, modals, and card actions, visible focus indicators, a reduced-motion setting, and game state that is never communicated through color alone. Card games with spatial, drag-and-drop interactions are genuinely difficult to make fully equivalent for screen-reader users, and we are candid that this is an ongoing effort rather than a finished one during this Beta period. The complete current state of this effort, including known gaps, is documented in our Accessibility Statement.

9. Security Approach

Because Shuffle21 has no accounts, no payment processing, and no server-side application logic beyond static file hosting, its attack surface is intentionally small. We avoid unnecessary third-party scripts, unsafe HTML injection, and hard-coded secrets, and we defensively validate data read from localStorage so a corrupted value never crashes the page. Our full approach — including how to report a suspected vulnerability — is described on our Security page.

10. Data & Privacy Approach

Shuffle21 does not require an account to play any game. Gameplay preferences and the fictional balance are stored locally in the visitor's browser, not on a Shuffle21 server or database. Basic technical data (such as IP address and request logs) may still be processed by our hosting infrastructure, as is true of virtually any website. The complete picture is documented in our Privacy Policy.

11. Roadmap Considerations

As a Beta product, Shuffle21 may continue to evolve — for example, refined AI opponents, additional accessibility improvements, or optional analytics (which, if added, would first require an update to our Privacy Policy). This white paper describes the product as it exists as of the "Last Updated" date above and will be revised as the product changes materially.

12. Conclusion

Shuffle21 aims to prove that a genuinely well-built, accessible, and transparent card-game website doesn't need real-money stakes, opaque algorithms, or invasive data collection to be enjoyable. This white paper, together with our Privacy Policy, Terms of Use, AI Governance Policy, and Accessibility Statement, is intended to give visitors a complete and honest picture of how the product works.

13. Contact

Questions about this white paper may be directed to Project Research LLC at admin@projectresearchllc.com.