Monorepo for the MetaGame applications, backend and databases.

We're using the following stack:

• NextJS
• Chakra UI
• Storybook

• Hasura
• GraphQL
• URQL
• Ceramic IDX
• Infura
• Docker

• Jest
• Prettier
• Lerna
• TypeScript
• Javascript

• Wiki
• Notion

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

• Video Walkthrough
• Backend Guide
• Frontend Guide
• C4 Guide
• Contributing Guide

Before you start contributing read the Contributing Guide!

Create your local .env file

cp .env.sample .env

yarn

Initial TS Compilation For Monorepo Packages

yarn typecheck

Start backend services

yarn docker:start

• 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-local-db

2. Populate the database with the initial dataset:

curl -X POST http://localhost:4000/actions/migrateSourceCredAccounts?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

If you want to locally start the backend server (not in Docker) for debugging purposes:

yarn backend:dev

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

yarn web:dev

Go to http://localhost:3000

Happy Coding!

yarn discord-bot dev

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

yarn docker:clean
yarn docker:start

yarn typecheck