Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tomanagle/NextJS-NestJS-GraphQL-Starter
A production-ready NextJS & NestJS GraphQL starter pack
https://github.com/tomanagle/NextJS-NestJS-GraphQL-Starter
graphql javascript nestjs nextjs nodejs react reactjs
Last synced: about 1 month ago
JSON representation
A production-ready NextJS & NestJS GraphQL starter pack
- Host: GitHub
- URL: https://github.com/tomanagle/NextJS-NestJS-GraphQL-Starter
- Owner: tomanagle
- License: mit
- Created: 2020-06-25T07:07:56.000Z (over 4 years ago)
- Default Branch: master
- Last Pushed: 2023-03-05T02:23:29.000Z (almost 2 years ago)
- Last Synced: 2024-08-01T15:35:46.143Z (4 months ago)
- Topics: graphql, javascript, nestjs, nextjs, nodejs, react, reactjs
- Language: TypeScript
- Homepage:
- Size: 4.44 MB
- Stars: 391
- Watchers: 8
- Forks: 75
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-nestjs - NextJS & NestJS GraphQL Starter - GraphQL NestJS with NextJS boilerplace. Includes GitHub, Reddit & Google OAuth. (Resources)
README
# NextJS & NestJS GraphQL Starter
A NextJS frontend and NestJS backend GraphQL starter pack that includes GitHub & Reddit authentication.
## Is something missing?
If there is a feature missing that is used in most production-grade applications, please make an issue so we can discuss adding it in.
## Features
- [x] Google authentication
- [x] GitHub authentication
- [x] Reddit authentication
- [x] Subscriptions
- [x] Update basic profile information
- [x] Server rendering
- [x] Translation
- [x] Session management
- [x] docker-compose for client & server
## Technologies
* [NextJS](https://nextjs.org/)
* [Bumbag](https://bumbag.style/)
* [styled-components](https://styled-components.com/)
* [Apollo Client 3.0](https://www.apollographql.com/docs/react/)
* [GraphQL Code Generator](https://graphql-code-generator.com/)
* [Yup](https://github.com/jquense/yup)
* [TypeScript](https://www.typescriptlang.org/)
* [NestJS](https://nestjs.com/)
* [Mongoose](https://mongoosejs.com/)
* [TypeGraphQL](https://typegraphql.com/)
* [react-i18next](https://react.i18next.com/)
* [Docker](https://docs.docker.com/)
* [React Hook Form](https://react-hook-form.com/)
## Getting started
1. Install the required packages
```bash
cd client && yarn
cd server && yarn
```
2. Update the .env files in the client & server
```bash
cp client/.env.example .env
cp server/.env.example .env
```
3. Start the server & client
```bash
cd server && yarn dev
cd client && yarn dev
```
> The client requires that the server is started so it can read the schema to run codegen. To remove that functionality, remove the predev hook in `client/package.json`
## Deployment
The easiest way to deploy is:
1. Create a [DigitalOcean](https://m.do.co/c/1b74cb8c56f4) droplet using the Docker image
2. Setup Nginx with this guide: [How To Install Nginx on Ubuntu 18.04](https://www.digitalocean.com/community/tutorials/how-to-install-nginx-on-ubuntu-18-04)
3. Clone the repository onto the droplet
4. Add your .env files with your production configuration to the client and server
5. Signup for [MongoDB Atlas](https://www.mongodb.com/cloud/atlas) and get your connection string
6. Mode the build script to make it executable: `chmod +x ./build.sh`
7. Run the build script ./build.sh
8. Modify and copy the supplied `nginx.conf` into `/var/etc/nginx/sites-available/default`
9. Generate the SSL certificate with this guide: [How To Secure Nginx with Let's Encrypt on Ubuntu 16.04](https://www.digitalocean.com/community/tutorials/how-to-secure-nginx-with-let-s-encrypt-on-ubuntu-16-04)
## Contributing
Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.
## NestJS GraphQL tutorials
* Build a GraphQL Server with NestJS - https://youtu.be/bQPk4S_W-pc
* Adding MongoDB to a NestJS GraphQL Server - https://youtu.be/xnyULqzQ-Rk
* Username & password authentication - https://youtu.be/PXwnT25SZro
## Support
[Buy me a Coffee](https://www.buymeacoffee.com/tomn)
[Sign up to DigitalOcean](https://m.do.co/c/1b74cb8c56f4) I 💖 DigitalOcean
[Subscribe on YouTube](https://www.youtube.com/channel/UClEEzwG7Tl3-8eY11Qytsog)
## License
[MIT](https://choosealicense.com/licenses/mit/)