# @theorchard/generator-graphql-server

Yeoman project generator for new graphql server instances.

For a detailed guide on how to use this generator see the [Creating a new graphql service (Notion)](https://www.notion.so/Creating-a-new-graphql-service-a3997178685c4b8e8db3964794ef8917) page

## Basic Usage

```bash
# install yeoman and generator
yarn global add yo @theorchard/generator-graphql-server

# create folder for your new project
mkdir graphql-test
cd graphql-test

# run generator
yo @theorchard/graphql-server

```

## Running locally

During development, you may need to run the generator using your local working copy. To do so, add it as a file-based dependency:

```bash
# Remove the previously installed version
yarn global remove "@theorchard/generator-graphql-server"

# Add the local copy
yarn global add file:/path/to/orchard-suite/packages/generator-graphql-server
```

You should likely remove the local copy once finished making changes.

## Deployment

Please be sure to make PRs against [`terraform-infra`](https://github.com/theorchard/terraform-infra) to add your service to `qa/lambda-jwt-refresh/jwt_enabled_services.tf` and `prod/lambda-jwt-refresh/jwt_enabled_services.tf`. While we continue to make sure all parts of our application support JWT Bearer tokens, we need to maintain this list.