Civ 6 Play By Cloud Webhook

This project is a hosted service for Civilization 6's Play By Cloud game format, for notifying players in Discord when it's their turn. The service is available at https://civ.halfstack.software.

Having issues? Reach out to me on Twitter @AWSBrett or open a GitHub Issue.

Development

Below is for development purposes only. If you're having problems using the service, reach out to me on Twitter @AWSBrett or open a GitHub Issue.

Architecture

Deploy to AWS

Update your ~/.aws/credentials with a profile called [civ6_dev] and run the following

cd packages/api
npm i
cd ../ui
npm i
cd ../..
npm run deploy:dev

Update the values in packages/ui/.env.development with the relevant values from stack-outputs.development.json

Testing

Running unit tests

npm test

Sending a test request to the service

1. Copy .env.sample to a .env file in the root directory and update it with your Discord Webhook URL
2. Run node packages/api/scripts/send-webhook-request.js

Setup

Domain

To use a custom domain, you must first manually create two certificates via Amazon Certificate Manager - one for UI, and another for API. For production, create certificates for example.com and api.example.com. For staging, create certificates for staging.example.com and staging.api.example.com.

After the stack is successfully deployed, create CNAME records in your DNS settings for both API and UI:

1. API:
   1. Navigate to Custom domain names in the API Gateway Console
   2. Copy API Gateway domain name from the API Gateway console into Domain name in DNS Settings
   3. Specify the subdomain in the @ field (e.g. api.civ or staging.api.civ)
   4. This takes time to propagate
2. UI:
   1. Navigate to Domain management in the Amplify Console
   2. Click Actions -> View DNS Records
   3. Create two CNAME records as descsribed