// todo: update these docs // todo: make a little docker container

source code for https://cards.jakedowns.com

ssstwitter_1651534939.mp4

basics:

1. use nvm or some other means to make sure you have at least node v12 (v14 recommended)
2. npm install to get the basic node dependencies
3. add a .env file with the following properties

HTTP_PORT=3090
WS_PORT=3091
HMR_PORT=3092
HOSTNAME="cards.site"
WS_HOSTNAME="cards.site"
SSL_CERT_PATH="../ssl/cert.crt"
SSL_KEY_PATH="../ssl/decrypted.key"
SSL_CA_CERT_PATH="../ssl/ca.crt"

note: you can generate certs via https://pkiaas.io/

ssl certs are required for MediaDevices API (Video/Audio streaming)

4. npx mix to do a one-time mix of js assets

   • npx mix watch to start a watcher
   • npx mix watch --hot to start a watcher AND set up hot-reloading
   • npx mix --production mix for a prod deploy

5. in a separate terminal run nodemon server/server.mjs (if nodemon is not found, npm i -g nodemon) // can also use forever

6. visit https://cards.site:3090 (or whatever hostname/port config you gave it)

Overview

• an engine for designing and playing card games collaboratively

• powered by THREE.js

• server is node

• 3d client is Vue + THREE.js

• 2d client is Vue + css animations (potentially could use canvas, but native dom is a fun challenge)

• future goals:

  • testing porting to Flutter
  • testing porting to React Native
  • (maybe) test port to Unity / Unreal