← Home·This page is provided in English only.

Technical documentation

Chaos Cards Onlineis a browser-based party game (fill-in-the-blank black & white cards). This document describes the product at a high level for players and operators. It does not expose implementation details of the live service.

Overview

The product is available as a browser-based web app and as a native iOS app on the App Store. Both clients share the same hosted backend for real-time game state and persistence. Optional paid extras in the browser are processed by Stripe (cards and wallet methods such as Apple Pay or Google Pay where available); in the iOS app, purchases use Apple In-App Purchase only. The player-facing interface is in Ukrainian; legal pages are Ukrainian; this overview is English-only by design.

Identity & sessions

  • There are no user accounts or passwords.
  • Your browser keeps a random anonymous identifier so the service can recognise your seat in a room across page loads. Clearing site data creates a new identity.
  • Creating or joining a room requires confirming that you are at least 18 years old and accept the Terms and Privacy Policy (checkbox on the relevant screens).

Main pages

  • Landing — introduction and entry into the game.
  • Play — create a room or join by code; may list public rooms you can pick from; may redirect if you are already seated elsewhere.
  • Room — lobby, optional chat, and the game board for a specific room code.
  • Terms of Use and Privacy Policy — legal text.
  • About — how to play; includes a link to the iOS app on the App Store.
  • This technical overview.

Game flow

  • One player per round acts as the judge (“Card Bro”): reads the black prompt; others answer with white cards (or optional custom text where unlocked). The judge picks a winner; scores update; another round can follow after a short on-screen pause.
  • New players can join only while the table is still in the lobby; once the match has started, joining is blocked.
  • During judging, non-judge players typically see all answers as anonymous variants; your own submission may be highlighted for you.
  • The match can end when prompts or playable cards run out under the rules; the UI then shows final standings, including ties where applicable.
  • If someone leaves mid-game, remaining players may see a notice; under some conditions the game returns to the lobby. Behaviour depends on how many people remain and the current phase.

Optional paid features

The base game does not require payment. Optional extras may appear after enough rounds have been played:

  • Custom answer — send your own text instead of a white card from your hand (subject to unlock and cooldown rules shown in the room). One-time paid use may be offered when free uses are not available.
  • Refresh hand — replace your whole white hand with new cards from the deck when allowed; one free refresh per match may be available after a minimum number of rounds, then paid refresh if offered. Not possible when the deck cannot supply new cards or after you have already submitted for the round, as explained in the UI.

Data handling (summary)

The service processes only what is needed to run a session: display names you choose, game state for the room, optional chat content for that room, and technical data required for reliability and optional payments. Payment card numbers are not stored by this application; they are handled by the payment provider’s flow. For detail, read the Privacy Policy.

Rooms & retention

  • The host may close a room; guests may then see that the room is no longer available.
  • If everyone leaves, the room may be removed.
  • Idle rooms and finished sessions are cleaned up automatically after reasonable delays so storage does not grow indefinitely. Exact timings may evolve with product updates.

iOS app

  • A native iOS client is published on the App Store (iPhone). It uses the same rooms and game rules as the web version.
  • Universal Links — room invite URLs of the form /room/<CODE> on a device with the app installed open directly in the iOS client instead of Safari. Generic site pages (home, play lobby, about, and so on) remain web-first and are not claimed by the app.
  • The site exposes an Apple App Site Association file at the standard /.well-known/apple-app-site-association path for Universal Link verification.
  • Safari on iOS may show a Smart App Banner on web pages to promote install; this is separate from in-page links and badges on the site.
  • Optional paid features in the iOS app are fulfilled via Apple In-App Purchase, not Stripe. See the Payments section and the Terms / Privacy Policy for platform-specific billing rules.

Payments

  • Optional purchases in the browser are completed via Stripe’s embedded payment flow.
  • Optional purchases in the iOS app use Apple In-App Purchase only; the web Stripe flow is not offered inside the native client.
  • Successful payment unlocks the corresponding in-game permission for that session, subject to the rules shown before you pay.
  • For billing disputes, refunds, and card or Apple ID billing practices, see the Terms of Use and Privacy Policy.

Changelog

A product changelog may be published with releases. It describes user-visible behaviour and operator-facing notes, not internal architecture.