https://github.com/sogko/golang-relay-starter-kit

Barebones starting point for a Relay application with Golang GraphQL server
https://github.com/sogko/golang-relay-starter-kit

Last synced: about 2 months ago
JSON representation

Barebones starting point for a Relay application with Golang GraphQL server

• Host: GitHub
• URL: https://github.com/sogko/golang-relay-starter-kit
• Owner: sogko
• License: other
• Created: 2015-09-08T10:12:29.000Z (almost 9 years ago)
• Default Branch: master
• Last Pushed: 2016-08-03T10:55:51.000Z (almost 8 years ago)
• Last Synced: 2024-04-14T06:00:02.783Z (2 months ago)
• Language: Go
• Size: 24.4 KB
• Stars: 136
• Watchers: 5
• Forks: 31
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Lists

• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Implementations / Go)
• awesome-stars - sogko/golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server (Go)
• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Examples / Go Examples)
• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Examples / Go Examples)
• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Examples / Go Examples)
• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Examples / Go Examples)
• awesome-graphql - golang-relay-starter-kit - Barebones starting point for a Relay application with Golang GraphQL server. (Examples / Go Examples)

README

        
# Golang-Relay Starter Kit

This kit includes:

- a **NodeJS** app server: to serve the front-end written with `react-relay`

- a **Golang** GraphQL server: to serve the back-end `graphql-go` server that handles GraphQL queries

- a Babel transpiler workflow using `webpack` that you can use to get started building an app with Relay.

For a walkthrough, see the [Relay tutorial](https://facebook.github.io/relay/docs/tutorial.html).

### Notes:

This is based on alpha version of `graphql-go` and `graphql-relay-go`. 

Be sure to watch both repositories for latest changes.

## Installation

- Install dependencies for NodeJS app server

```

npm install

```

- Install dependencies for Golang GraphQL server

```

go get -v

```

## Running

Start a local server:

```

npm start

```

The above command will run both the NodeJS app server and Golang GraphQL server concurrently.

- Golang GraphQL server will be running at http://localhost:8080/graphql

- NodeJS app server will be running at http://localhost:3000

## Developing

### JavaScript

Any changes you make to files in the `js/` directory will cause the server to

automatically rebuild the app and refresh your browser.

### Golang

#### Schema data

Since Golang does not support loading package / module dynamically, remember to update the package import for schema data in:

- `graphql.go`

- `scripts/updateSchema.go`

For e.g

```go

import (

  ...

  "github.com/sogko/golang-relay-starter-kit/data" // <--- update to package containing schema

)

```

#### Schema updates

If at any time you make changes to `data/schema.go`, stop the server,

regenerate `data/schema.json`, and restart the server:

```

npm run update-schema

npm start

```

`schema.json` is needed by the JS code for `./build/babelRelayPlugin.js`

## Examples

- [todomvc-relay-go](https://github.com/sogko/todomvc-relay-go) - Port of the React/Relay TodoMVC app, driven by a Golang GraphQL backend

Feel free to submit a PR to add to this list.

## TODOs

- [x] Swap out `express-graphql` server with a Golang GraphQL server

- [x] GraphQL schema definition in Golang

- [x] Generate `schema.json` from schema definition for `babel-relay-plugin`

- [ ] Generate `schema.graphql` from schema definition

## Credits

This kit is build on top of https://github.com/relayjs/relay-starter-kit