Skip to content

vidvidvid/TheGame

This branch is 85 commits behind MetaFam/TheGame:develop.

Folders and files

NameName
Last commit message
Last commit date

Latest commit

8c8934c · Apr 1, 2024
Mar 21, 2024
Aug 24, 2023
Jan 23, 2024
Jan 30, 2024
Jan 25, 2024
Apr 1, 2024
May 15, 2023
Apr 16, 2020
Oct 8, 2023
May 15, 2023
May 15, 2023
Jan 25, 2022
Jan 29, 2021
May 1, 2021
Dec 2, 2023
Jan 25, 2022
Aug 10, 2022
Feb 28, 2022
Mar 13, 2023
Mar 13, 2023
Aug 9, 2023
May 1, 2021
Dec 15, 2023
Jul 12, 2022
Jan 25, 2024
Feb 28, 2022
Dec 6, 2022
Jul 13, 2020
Mar 21, 2024

Repository files navigation

The Game

Monorepo for the MetaGame applications, backend and databases.

We're using the following stack:

Architecture

Frontend

Backend

Overall

MetaGame

Guides

If you're new to the MetaGame codebase, check out the following guides to learn how to contribute.

Development

Before you start contributing read the Contributing Guide!

Bootstrap

Create your local .env file

cp .env.sample .env

Create a GitHub token at https://github.com/settings/tokens

Set GITHUB_API_TOKEN=your_github_token in .env

Install Packages

yarn

Initial TS Compilation For Monorepo Packages

yarn typecheck

Adding a package to the codebase can be done with Lerna

Run services

Start backend services

yarn docker:start

For M1 Mac Users

Official docker images of Hasura don't work on M1 yet

In hasura/Dockerfile Replace

FROM hasura/graphql-engine:v1.3.3.cli-migrations-v2

with

FROM fedormelexin/graphql-engine-arm64:v1.3.3.cli-migrations-v2
  • Runs docker containers for backend, Hasura Engine, and PostGres database
  • will auto-restart on any changes to packages/backend and packages/utils

If you are running for the first time on an empty database, once the services are running you have two options to populate the database:

  1. Populate the database with the production dataset:
yarn hasura:seed-db
  1. Populate the database with the initial dataset:
curl -X POST http://localhost:4000/actions/syncSourceCredAccounts?force=true

Rebuild backend services

If your docker containers fail to start due to changes in config, you may need to rebuild the containers. This can take several minutes.

yarn docker:build

Stop backend services

yarn docker:stop
  • Stops all the containers

Troubleshooting

Rebuild and run the containers (in attach mode):

docker-compose up --build

In case non of the above commands are working try purge the docker containers and images you can do this by running (notice: this removes all the containers and images on your computer!):

docker system prune -a

If you're working on the front-end and the build fails with something like the error below, you'll need to create a .env file in packages/web and add NEXT_PUBLIC_GRAPHQL_URL=https://api-staging.metagame.wtf/v1/graphql

[Error [CombinedError]: [Network] request to http://localhost:8080/v1/graphql failed, reason: connect ECONNREFUSED 127.0.0.1:8080] {
  type: 'CombinedError',
  graphQLErrors: [],
  networkError: {
    message: 'request to http://localhost:8080/v1/graphql failed, reason: connect ECONNREFUSED 127.0.0.1:8080',
    type: 'system',
    errno: 'ECONNREFUSED',
    code: 'ECONNREFUSED'
  }
}

** A note about environment variables **

If you need to add an environment variable, it will need to go in several places:

  • your own .env file
  • .env.sample
  • gcp-deploy.yaml
    • For backend variables, add to the deploy-backend step alongside the others
    • For frontend variables, add to the deploy-frontend step. You may also need to add it to the build-frontend step, if it is used in a page that is statically generated by next.js
  • gcp-deploy-frontend.yaml for frontend variables, this should be the same as the frontend actions in the other yaml file

Secrets will need to be added to the TheGame Github secrets; contact a senior builder for assistance.

As an aside, the gcp-deploy-frontend.yaml is the deployment configuration for our test and production frontend instances, while gcp-deploy.yaml is only for PR environments.

Run NextJS Web App dev mode (new)

yarn web:dev

Go to http://localhost:3000

Happy Coding!

Run Discord Bot

yarn discord-bot dev

This will automatically register with Discord and relay chat messages to your local instance! Pretty cool. Testing in a dedicated test Discord server (rather than MetaGame's) is recommended.

Tooling

Start Hasura console

yarn hasura:console

Hasura CLI example

yarn hasura migrate status
yarn hasura migrate squash --name "<feature-name>" --from 1598417879553
yarn hasura migrate apply --version "<squash-migration-version>" --skip-execution

Hasura CLI documentation Hasura Migrations Guide

Generate GraphQL Types

yarn generate

Reload Schema + Generate GraphQL Types (backend needs to be running)

yarn update-schema
yarn generate

Restart with fresh database

yarn docker:clean
yarn docker:start

Run typechecks

yarn typecheck

WIP Branch Push

Upon pushing to the repository a linting check will be initialized validating your code. If you want to push the branch to the repository (maybe for collaboration) while the code isn't completely valid yet you have the option of skipping the linting process:

git push -u origin <branch> [--no-verify]

Please use this only when absolutely necessary!

Debugging with Visual Studio Code

When running the backend stack locally using docker-compose, you can still debug the backend container using VS Code. Just add this configuration to your .vscode/launch.json.

Packages

No packages published

Languages

  • TypeScript 97.4%
  • JavaScript 1.6%
  • Other 1.0%