Netjack is a local-network Blackjack game with a server-authoritative rules engine, a realtime client, and a shared lobby flow for hosts and players.

It is built for LAN sessions, classroom play, and small trusted networks. It is not a public gambling service.

• Netjack
  • Showcase
• Lobby
• Game
  • Contents
  • Highlights
  • Why This Exists
  • Current Workflow
  • Tech Stack
  • Requirements
  • Quick Start
  • Configuration
  • Usage
  • Development
  • Roadmap
  • License

Netjack exists because the game should feel quick, local, and social without requiring a hosted backend.

The project focuses on:

• one host machine
• one shared local network
• a short code instead of account sign-in
• simple rules that stay consistent on the server

The result is a lightweight Blackjack table that works in the room, not in a cloud account.

1. Start the root dev command.
2. The server listens on port 3001 and the client on port 5173.
3. One player hosts a lobby and gets a 6-character code.
4. Other players join from the same LAN.
5. The server validates every move and broadcasts state updates to the client.

• Node.js 20.x
• npm 9+
• a shared local network for host and players

npm ci
npm run dev

Then open:

• Client: http://localhost:5173
• Server: http://localhost:3001

Safe environment templates are included in the repo:

Recommended setup:

1. Copy server values into a local server env file or shell session.
2. Copy client values into client/.env.local.
3. Keep secrets out of git.

Security defaults:

• the admin endpoint is off unless ADMIN_ENABLED=true
• CORS is restricted to CLIENT_URLS
• no default admin credentials are baked into runtime

1. Start the app with npm run dev.
2. On the host machine, create a lobby.
3. Share the 6-character code with other players.
4. Join from another device on the same network.
5. Play rounds and use chat or round history as needed.

For local network testing, the host IP can be found with:

# macOS
ipconfig getifaddr en0

# Linux
hostname -I

# Windows (PowerShell)
ipconfig

Useful commands:

npm run check
npm run test
npm run build
npm run ci

Workspace-specific commands:

npm run dev -w server
npm run dev -w client
npm run test -w server
npm run check -w client

• tighten mobile layout behavior for cramped LAN sessions
• improve admin visibility for round diagnostics
• add more round-history and analytics views
• keep the rules engine and UI aligned as the game evolves

MIT