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: 4 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 (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-12-17T18:42:07.000Z (5 days ago)
- Last Synced: 2024-12-17T19:34:04.242Z (5 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.91 MB
- Stars: 52
- Watchers: 2
- Forks: 2
- Open Issues: 17
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- Codeowners: .github/CODEOWNERS
Awesome Lists containing this project
README
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)
## 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/