Download

Get ShowMyCards running on your machine.

Docker (recommended)

The quickest way to get started. Runs both the backend and frontend in a single container.

docker run -d \
  --name showmycards \
  -p 3000:3000 \
  -p 3001:3001 \
  -v showmycards-data:/app/data \
  ghcr.io/showmycards/showmycards:latest

Prefer Docker Compose? See the docker-compose.yml in the repository.

Configuration

ShowMyCards works out of the box for local use. If you're deploying on a custom domain or behind a reverse proxy, set these environment variables:

Variable	Service	Description
ALLOWED_ORIGINS	Backend	Origins allowed to call the API (CORS). Set to the URL users access the frontend from. Comma-separated for multiple origins. Default: `http://localhost:5173`
PUBLIC_BACKEND_URL	Frontend	URL the frontend uses to reach the backend API. Default: `http://localhost:3000`
ORIGIN	Frontend	The frontend's own origin (required in production by SvelteKit).
PORT	Both	Port each service listens on. Backend default: `3000`, Frontend default: `3001`

For example, if users access ShowMyCards at https://cards.example.com, set ALLOWED_ORIGINS=https://cards.example.com on the backend and ORIGIN=https://cards.example.com on the frontend.

From source

Clone the repository and build it yourself. Requires Go and Bun.

git clone https://github.com/showmycards/showmycards.git
cd showmycards
make install
make dev-backend   # terminal 1
make dev-frontend  # terminal 2