https://github.com/developer239/nest-vite-fullstack-microservices-poc

A robust Nest.js microservices example featuring Apollo Federation, Turbo monorepo, RabbitMQ for messaging, a shared backend codebase, and a Vite-powered web application. Includes a custom UI library with Storybook and more...
https://github.com/developer239/nest-vite-fullstack-microservices-poc

apollo-federation crud crud-api crud-sample docker docker-compose graphql-codegen graphql-gateway grapql microservice microservices monorepo nestjs nestjs-backend postgres rabbitmq tailwindcss typeorm vite vitest

Last synced: 6 days ago
JSON representation

A robust Nest.js microservices example featuring Apollo Federation, Turbo monorepo, RabbitMQ for messaging, a shared backend codebase, and a Vite-powered web application. Includes a custom UI library with Storybook and more...

• Host: GitHub
• URL: https://github.com/developer239/nest-vite-fullstack-microservices-poc
• Owner: developer239
• Created: 2023-07-11T13:28:01.000Z (over 1 year ago)
• Default Branch: master
• Last Pushed: 2024-07-22T19:34:35.000Z (4 months ago)
• Last Synced: 2024-07-23T15:46:03.573Z (4 months ago)
• Topics: apollo-federation, crud, crud-api, crud-sample, docker, docker-compose, graphql-codegen, graphql-gateway, grapql, microservice, microservices, monorepo, nestjs, nestjs-backend, postgres, rabbitmq, tailwindcss, typeorm, vite, vitest
• Language: TypeScript
• Homepage:
• Size: 4.21 MB
• Stars: 3
• Watchers: 2
• Forks: 1
• Open Issues: 15
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# Nest Vite Fullstack Microservices PoC

This repository is structured as a monorepo containing multiple NestJS microservices and Vite web application. It utilizes Turborepo for managing builds and TypeORM for database interactions and bunch of other cool stuff.

## TODO

- [ ] GitHub Actions

- [ ] CD (GCP + Terraform)

- [ ] Create docker-compose for local development (currently only databases and message broker are included)

- [ ] TODOs in code (and infinite number of small issues that I did not have time to fix)

## Apps

| Name                                      | Platform | Description                                                                       |

| ----------------------------------------- | -------- | --------------------------------------------------------------------------------- |

| [Service Gateway](./apps/service-gateway) | Backend  | The GraphQL gateway for routing queries and mutations between different services. |

| [Service Events](./apps/service-events)   | Backend  | Manages event-related data and interactions.                                      |

| [Service Auth](./apps/service-auth)       | Backend  | Handles authentication and user management.                                       |

| [Web](./apps/web)                         | Frontend | The main web application.                                                         |

| [Storybook](./apps/storybook)             | Frontend | Storybook for UI components.                                                      |

## Packages

| Name                                           | Description                                                                          |

| ---------------------------------------------- | ------------------------------------------------------------------------------------ |

| [Backend Contracts](./packages/amqp-contracts) | TypeScript interfaces and constants used across different backend services.          |

| [Backend Shared](./packages/nest-helpers)      | Shared configurations, utilities, and modules used across multiple backend services. |

| [UI Library](./packages/ui-library)            | A collection of reusable React components and utilities for frontend applications.   |

## Infrastructure

- **Message Broker**: RabbitMQ is used for communication between services.

- **Databases**: PostgreSQL is used with separate instances for authentication and event services.

## Development

This project uses Turborepo for build system management. You can find more information by [reading the Turborepo documentation](https://turborepo.org/docs).

### Setting up

- Run `docker-compose up` to start databases and rabbitmq.

- Run `yarn install` to install dependencies. This project uses Yarn workspaces to manage dependencies across all apps and packages.

- Run `yarn prepare:husky` to set up Git hooks.

- Run `yarn build` to build all packages and service (remember that packages are static and required to run the app services)

- Run `yarn dev` to start all services in development mode

  - The GraphQL gateway will be available at `http://localhost:8080/graphql`

### Common Commands

- `yarn dev` - Starts all services in development mode with live reloading.

- `yarn build` - Builds all services.

- `yarn lint` - Lints the codebase using ESLint.

- `yarn format` - Formats code using Prettier.