Skip to content

πŸ’₯ Monorepo template (seed project) pre-configured with GraphQL API, PostgreSQL, React, Relay, Material UI.

License

Notifications You must be signed in to change notification settings

axmachina/sandbox_

Β 
Β 

Repository files navigation

GraphQL
GraphQL API and Relay Starter Kit

Features

Β Β Β Β 


This project was bootstrapped with Relay Starter Kit. Be sure to join our Discord channel for assistance.

Directory Structure

β”œβ”€β”€.github β€” GitHub configuration including CI/CD workflows
β”œβ”€β”€.vscode β€” VSCode settings including code snippets, recommended extensions etc.
β”œβ”€β”€api β€” GraphQL API and authentication (Could SQL, Cloud Functions, GraphQL.js)
β”œβ”€β”€app β€” React / Relay web application with CDN rendering (Vite, Cloudflare Workers)
β”œβ”€β”€db β€” database schema, seeds, and migrations (Cloud SQL, Knex.js)
β”œβ”€β”€edge β€” Cloudflare Workers CDN endpoint (reverse proxy)
β”œβ”€β”€env β€” environment variables that are used for local development (local, test, prod)
β”œβ”€β”€img β€” dynamic image resizing (Cloud Functions, Cloud Storage)
β”œβ”€β”€infra β€” cloud infrastructure configuration (Terraform)
β”œβ”€β”€scripts β€” automation scripts shared across the project
└── ... β€” add more packages such as worker, admin, mobile, etc.

Requirements

Getting Started

Just clone the repo and run yarn install followed by yarn start:

$ git clone https://github.com/kriasoft/relay-starter-kit.git example
$ cd ./example                  # Change current directory to the newly created one
$ yarn install                  # Install project dependencies
$ yarn setup                    # Configure environment variables
$ yarn db:reset                 # Create or update PostgreSQL database
$ yarn api:start                # Launch GraphQL API and authentication server
$ yarn app:start                # Launch React/Relay front-end app

The API server must become available at http://localhost:8080/api.
The web application front-end must become available at http://localhost:5173/.

How to Deploy

Before you can deploy the app, ensure that the target GCP project exists and that all the environment variables (found in /env/*.env files) are up-to-date, for both test (QA) and prod (production) environments.

If you just created a brand new GCP project, you can configure it by running:

$ yarn gcp:setup --env=test
$ yarn gcp:setup --env=prod

OR, by using Terraform (found in /infra), which one is more convenient for you.

Once a new commit or PR lands onto the main (or, release) branch, it's going to be deployed automatically using a GitHub Actions workflow. Alternatively, you can deploy the app manually by running:

# Build and deploy the GraphQL API (GCF)
$ yarn api:build
$ yarn api:deploy --env=prod

# Build and deploy the web front-end to Cloudflare Workers (CDN)
$ yarn app:build
$ yarn app:deploy --env=prod

# Migrate the target database to the latest version
$ yarn db:migrate --env=prod

Where --env=prod is the target (production) deployment environment, using --env=test when not specified.

References

How to Update

In the case when you kept the original Node.js Starter Kit git history, you can always pull and merge updates from the "upstream" repository back into your project by running:

$ git fetch seed                # Fetch Node.js Starter Kit (upstream) repository
$ git checkout main             # Switch to the main branch (or, master branch)
$ git merge seed/main           # Merge upstream/master into the local branch

In order to update Yarn and other dependencies to the latest versions, run:

$ yarn set version latest       # Upgrade Yarn CLI to the latest version
$ yarn upgrade-interactive      # Bump Node.js dependencies using an interactive mode
$ yarn install                  # Install the updated Node.js dependencies
$ yarn dlx @yarnpkg/sdks vscode # Update VSCode settings

Backers

Β Β Β Β Β Β Β Β Β Β Β Β Β Β 

How to Contribute

Anyone and everyone is welcome to contribute. Start by checking out the list of open issues marked help wanted. However, if you decide to get involved, please take a moment to review the guidelines.

License

Copyright Β© 2016-present Kriasoft. This source code is licensed under the MIT license found in the LICENSE file.


Made with β™₯ by Konstantin Tarkus (@koistya, blog) and contributors.

About

πŸ’₯ Monorepo template (seed project) pre-configured with GraphQL API, PostgreSQL, React, Relay, Material UI.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • TypeScript 77.4%
  • JavaScript 18.2%
  • HCL 2.4%
  • Handlebars 1.6%
  • Other 0.4%