nguyenvuvn / naperg

Fullstack Boilerplate GraphQL. Made with React & Prisma + authentication (permissions & roles) + upload file

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Node Apollo Prisma Express React GraphQL
 

Boilerplate for a Fullstack GraphQL App with React & Prisma

Authentication with permissions & roles. Backend & Frontend

Upload image with expressJs


image

🚀 Bootstrap your fullstack GraphQL app within seconds
Basic starter kit for a fullstack GraphQL app with React and Node.js - based on best practices from the GraphQL community.

Screenshots

Mobile Friendly Login with Avatar Profile
Mobile friendly avatar profile
Order by / pagination Email Validation
Mobile friendly image
Forget Password
image image
Users List User profile
connected object User profile
Login Resend Link to validate email
Login Link to validate email
Create Draft with connected object (car & user) Update Password in app
connected object connected object
Signup with key 'Enter' to change field
connected object

Getting started

1/ Install docker and Prisma cli. (https://www.prismagraphql.com/docs/quickstart/backend/node/node-phe8vai1oo)

2/ In 3 different terminals:

# Prisma: Graphql and mySql (port 4000)
cd server
yarn install
yarn start
# Backend: ExpressJs (port 8000)
cd express
yarn install
yarn start
# Front: ReactJs (port 3000)
cd react
yarn install
yarn start

Go to url: http://localhost:3000

Features

  • Scalable GraphQL server: The server uses graphql-yoga which is based on Apollo Server & Express
  • Pre-configured Apollo Client: The project comes with a preconfigured setup for Apollo Client
  • GraphQL database: Includes GraphQL database binding to Prisma (running on MySQL)
  • Tooling: Out-of-the-box support for GraphQL Playground & query performance tracing
  • Extensible: Simple and flexible data model – easy to adjust and extend
  • No configuration overhead: Preconfigured graphql-config setup

For a fully-fledged React & Apollo tutorial, visit How to GraphQL. You can more learn about the idea behind GraphQL boilerplates here.

Requirements

You need to have the GraphQL CLI installed to bootstrap your GraphQL server using graphql create:

npm install -g graphql-cli

More details in the tuto: https://github.com/graphcool/prisma/tree/master/examples/auth

Documentation

Commands

  • prisma local nuke

  • prisma reset

  • docker container ls list container

  • docker stop database_prisma_1 stop container

  • docker rm database_prisma_1 remove container

  • docker stop $(docker ps -a -q) stop all container

  • docker rm $(docker ps -a -q) remove all container

  • docker-compose up -d init app

  • yarn start starts GraphQL server on http://localhost:4000

  • yarn dev starts GraphQL server on http://localhost:4000 and opens GraphQL Playground

  • yarn playground opens the GraphQL Playground for the projects from .graphqlconfig.yml

  • yarn prisma <subcommand> gives access to local version of Prisma CLI (e.g. yarn prisma deploy)

Note: We recommend that you're using yarn dev during development as it will give you access to the GraphQL API or your server (defined by the application schema as well as to the Prisma API directly (defined by the Prisma database schema. If you're starting the server with yarn start, you'll only be able to access the API of the application schema.

Contributing

Your feedback is very helpful, please share your opinion and thoughts! If you have any questions or want to contribute yourself, don't hesitate!

To do

  • âś“Implement materials https://material-ui-next.com/
  • âś“Send emails: Welcome emails
  • âś“Send emails: Forget Password
  • âś“Send emails: validate Email
  • âś“change/Reset password. send email confirmation
  • âś“Organize logo image in readMe
  • âś“Create Screenshots GIFS. Mobile friendly / auth / Post
  • Implement Apollo Client 2.0
  • Write medium post
  • Upload all filetypes. A logo of a file will appear instead of picture
  • Use File Handling instead of express to upload file: https://github.com/graphcool/prisma/tree/master/examples/file-handling-s3

About

Fullstack Boilerplate GraphQL. Made with React & Prisma + authentication (permissions & roles) + upload file

License:MIT License


Languages

Language:JavaScript 96.9%Language:CSS 2.0%Language:HTML 1.1%