Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/biantris/koa-server

🗄️ GraphQL Back-end Server with Relay, Koa, MongoDB and Mongoose
https://github.com/biantris/koa-server

graphql graphql-server koa koajs mongodb mongoose node nodejs relay

Last synced: 16 days ago
JSON representation

🗄️ GraphQL Back-end Server with Relay, Koa, MongoDB and Mongoose

Host: GitHub
URL: https://github.com/biantris/koa-server
Owner: biantris
Created: 2021-05-29T21:30:45.000Z (about 3 years ago)
Default Branch: main
Last Pushed: 2024-06-07T15:00:29.000Z (20 days ago)
Last Synced: 2024-06-07T17:58:42.947Z (20 days ago)
Topics: graphql, graphql-server, koa, koajs, mongodb, mongoose, node, nodejs, relay
Language: TypeScript
Homepage: https://koa-server-production.up.railway.app
Size: 4.42 MB
Stars: 52
Watchers: 2
Forks: 2
Open Issues: 15
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Codeowners: .github/CODEOWNERS

Lists

my-awesome-stars - biantris/koa-server - 🗄️ GraphQL Back-end Server with Relay, Koa, MongoDB and Mongoose (TypeScript)

README

![image](https://user-images.githubusercontent.com/65451957/170831440-11ffbec9-5380-4513-9084-a6c09aa9dcdb.png)

koa-server

GraphQL Back-end Server with Relay, Koa, MongoDB and Mongoose

🚧 WIP 🚧

> **Note**
> See Front-end project [graphql-relay-web](https://github.com/biantris/graphql-relay-web)

### Stack

- [x] Koa
- [x] MongoDB
- [x] Mongoose
- [x] GraphQL
- [x] Relay
- [x] Jest
- [x] SuperTest
- [x] Code Coverage(Coverall) [see](https://github.com/biantris/koa-server/issues/129)
- [x] Linter (Eslint)
- [x] Prettier

### Project architecture

```
.
├── graphql/
│ └── schema.graphql
├── script
├── src/
│ ├── __tests__
│ ├── database
│ ├── graphql
│ ├── modules/
│ │ ├── event/
│ │ │ ├── __tests__
│ │ │ ├── fixure
│ │ │ ├── mutations/
│ │ │ │ ├── __tests__
│ │ │ │ ├── EventCreateMutation.ts
│ │ │ │ ├── EventDeleteMutation.ts
│ │ │ │ ├── EventUpdateMutation.ts
│ │ │ │ └── index.ts
│ │ │ ├── EventFilterInputType.ts
│ │ │ ├── EventLoader.ts
│ │ │ ├── EventModel.ts
│ │ │ └── EventType.ts
│ │ └── node/
│ │ └── typeRegister.ts
│ ├── schema/
│ │ ├── MutationType.ts
│ │ ├── QueryType.ts
│ │ └── schema.ts
│ └── shared
└── test
```

### Getting Started

- clone this repo

```sh
# install dependencies
> yarn
# or
> yarn install

# copy .env file
> cp .env.example .env

# start project
> yarn start

# see on GraphiQL graphql interface on localhost link
http://localhost:9000/graphql

# or see graphql Playground
http://localhost:9000/playground
```

### Generating the schema

```sh
> yarn schema
```

### Create events manually

```sh
> yarn seed
```

## to-do

- [projects](https://github.com/biantris/koa-server/projects/1)
![image](https://user-images.githubusercontent.com/65451957/214913343-0bcb661f-a6be-453a-ac89-b09736cc8738.png)

## demo

- 🔗 https://koa-server-production.up.railway.app/
- 🔗 https://koa-server-production.up.railway.app/graphql
- 🔗 https://koa-server-production.up.railway.app/playground

### Mutations

- Event Create Mutation

```graphql
mutation {
EventCreate(
input: {
eventId: 564654
name: "nice event"
start: "2022-07-01T00:00:00.000Z"
end: "2022-07-01T23:59:59.000Z"
allDay: false
}
) {
event {
id
name
start
end
allDay
}
error
success
}
}
```

- Event delete Mutation

```graphql
mutation {
EventDelete(input: { eventId: "629521641ff2c2c8f5f2e449" }) {
eventId
error
success
}
}
```

- Event Update Mutation

```graphql
mutation {
EventUpdate(
input: {
eventId: "62952906f5c651ced019adf3"
name: "nice event /o/"
start: "2022-07-01T00:00:00.000Z"
end: "2022-07-01T23:59:59.000Z"
allDay: false
}
) {
event {
id
name
start
end
allDay
}
error
success
}
}
```

### Queries

- Event queries

```graphql
query {
events {
edges {
node {
name
start
end
allDay
}
}
}
}
```

## contributions

Feel free to contribute to this project, if you find any bugs or improvements, open an issue and send a PR about it \o/