Geek Speak

First things first. Either create a .pgpass file in your home directory or edit the existing one to hold the following entry:

db:5432:*:postgres:demo

This allows the migration tool to update the local development database.

Second, make sure Docker is installed and running.

Third, add your own docker-compose.override.yml file like found in the example:

version: "2.4"

services:

  dbadmin:
    ports:
      - "9000:80"

  graphql:
    ports:
      - "3000:3000"

  ui-public:
    environment:
      GRAPHQL_URL: "http://localhost:3000/graphql"
    ports:
      - "4000:4000"
    command: npm run dev -- --port=4000 --host=0.0.0.0

  ui-admin:
    environment:
      GRAPHQL_URL: "http://localhost:3000/graphql"
    ports:
      - "4001:4001"
    command: npm run dev -- --port=4001 --host=0.0.0.0

Finally, run the following:

docker-compose up -d

Fourth, create a JWT with a role and an email address for use with the GraphiQL GraphQL tool. (None of the other options matter for local development.)

{
  "role": "user",
  "email": "youremail@example.com"
}

Architecture

Database

Sqitch migration files. To install Sqitch locally:

docker pull sqitch/sqitch
sudo curl -L https://git.io/JJKCn -o /usr/local/bin/sqitch && sudo chmod +x /usr/local/bin/sqitch

You'll need this if you want to change the database structure.

Infrastructure

AWS

AWS CDK implementation to deploy/update the Geek Speak AWS stack.

GraphQL

Postgraphile implementation that makes an existing database schema available through GraphQL.

This implementation allows for running as a server or deployed as an AWS Lambda behind API Gateway.

UI

Public

Public web site to be authored in SvelteKit, prerendered, and deployed to AWS S3.

Admin

Admin web site to be authored in SvelteKit, deployed to AWS S3, and interact with the GraphQL layer.