About Arcana & Setup

What is Arcana?

Arcana is a companion app designed to replace physical chips, scorepads, and complex calculations during your real-world card games. Whether you're playing Poker with friends or keeping score in Rummy, Arcana acts as the digital dealer and banker, handling all the math seamlessly across all devices at the table.

How it Works

  • Online Mode: Highly reliable, server-backed connection powered by Vercel Postgres. Bypasses restrictive browser extensions, firewalls, and carrier NATs. Requires internet.
  • No Accounts Needed: Players can jump into a game instantly by entering a 6-character room code or scanning a QR code.

Requirements Checklist

Online Mode Requirements

  • Internet connection is required for both the host and all guest players.
  • Host must have Clerk authentication configured on the deployment.
  • Requires a database connection string (DATABASE_URL environment variable configured on Vercel).
  • Any modern mobile or desktop web browser.

Hosting a Game

  • 1.Tap 'Start a Game' on the home screen.
  • 2.Select the game type, table name, and starting chips.
  • 3.Once created, the app becomes the "Host". Share the 6-character room code or QR Code displayed on your screen with your friends.

Joining as a Guest

  • 1.Tap 'Join Table' on the home screen.
  • 2.Enter the 6-character room code provided by the host.
  • 3.If the host is online, your device will pair automatically and sync the table state in real-time.