pokipoki

Poker planning app in node.

@mattische

Docker Hub | GitHub Packages (ghcr.io)

Deploy with ONCE

The easiest way to self-host pokipoki is via ONCE CLI.

When prompted for a Docker image, enter:

ghcr.io/mattische/mattische-repos/pokipoki:latest

The app serves HTTP on port 80 and exposes a /up health check endpoint as required by ONCE.

npm install and run app

only if you wish to run the app locally

install

npm install

run app

# http://localhost:<port setting in .env>
# first user is host - invite users by sending session id to them

npm start

docker and caddy

create a Caddyfile

Create your own Caddyfile - this repo contains an example. Make sure to add correct values in .env such as domain (your servers ip or your domain).
Review docker-compose.yml - especially if you change ports.

Create a JWT_SECRET with for example openssl;

openssl rand -base64 32

and copy that to the JWT_SECRET in .env

docker compose

Probably the easiest way to get up and running is to use docker compose.
It runs 2 containers; poker planning app and a caddy server.

The caddy server uses reverse proxy and routes exposed port 80 to app port (default 3000 in production). Review settings in docker-compose.yml.

docker compose

# uses settings such as port as specified in .env
docker compose up

docker

# this creates a docker image from the current directory and tag it as pokipoki
# it shows up in docker images list as pokipoki in docker desktop
docker build -t pokipoki .

# Run and auto-remove container when stopped, exposing port 3000 on local network
docker run --rm -p 3000:3000 pokipoki

features

• run poker planning sessions with team, in browser
• 3 themes
• timer
• chat
• first participant will be host and a session id is created; share id with others to invite them

arch

backend

• server.js - express server with socket.io
• src/auth.js - JWT auth
• src/sessionManager.js - sessions
• src/socketHandler.js - event handling for socket

frontend

• public/index.html - html
• public/*.css - style sheet with themes
• public/js/client.js - client js
• public/js/socket.js - socket logic
• public/js/ui.js - ui scripts
• public/js/themeManager.js - theme management

env variables

• PORT - server port (default: 80 in production)
• NODE_ENV - environment (development/production)
• JWT_SECRET - secret key for JWT (use your own)

Generete JWT token with.

openssl rand base64 32

dev mode

# dev mode with watch
npm run dev

# dev with Docker
docker-compose --profile dev up