Awesome Open Source
Awesome Open Source


A fullstack JavaScript project, using technologies from the modern stack, such as:

  • NestJS - a JS backend framework providing architecture out of the box with a syntax similar to Angular
  • Angular - a JS frontend framework created by Google
  • Angular Universal - Angular Server Side Rendering - prerendered crawlable pages
  • RxJS - reactive extensions for JavaScript
  • Webpack - the ultimate JS bundler - used for the server code since Angular has it under the hood
  • MongoDB - a NoSQL database
  • Mongoose - MongoDB object modeling designed to work in an asynchronous environment
  • TypeScript - superset of JS which compiles to JS, providing compile-time type checking
  • Passport - a popular library used to implement JavaScript authentication
  • jsonwebtoken - a JavaScript json web tokens implementation by auth0

Running the project

These instructions should be sufficient for one to get the project going on their local machine

Cloning the github repository

To clone the project, run

git clone

Installing the dependencies

To install the dependencies after you've cloned the project, go to its root folder and run

npm install

Building the Angular application

Before you start the server, you need to build the Angular application. To do so, run

npm run build:universal

Starting the server

Once you have the Angular app built, you can start the server by running

npm run watch:server

Notice that the server uses MongoDB so we need to have a MongoDB instance running so the server can connect to it

Alternative commands

If you need to work on the frontend and backend parts at the same time, you can run

npm run watch

Then, you can go to the Angular dev server at port 4200 and test server requests (to port 1337), we got a proxy to the backend

If you only need to work on the frontend, you can run

npm run watch:client

Alternatively, if you only need to work on the backend, you can run

npm run watch:server

Keeping in mind that you need to have the Angular app built and a mongodb connection established


Getting GraphQL to work

Currently there are issues with several packages so even though we have GraphQL implemented, it stays commented out because it doesn't work.. Here are the instructions to make it work:

  • Download - those are the apollo-angular and apollo-angular-link-http modules compiled in commonjs - then go in your node_modules folder and replace your apollo-angular and apollo-angular-link-http modules with these ones
  • Download - this is the fixed @nestjs/graphql module - there was an error when in combination with Angular Universal which is now fixed - then replace your @nestjs/graphql module with this one
  • Open node_modules/@types/ws/index.d.ts and find net.AddressInfo - you will see a type definition of a function: address(): net.AddressInfo | string - change it to address(): string

Now, you can go ahead and uncomment the GraphqlModules on both client/server side and it works decently, I am using it in another project which is a clone of this one and everything works..

Use Social login

Modify with your application credentials:

  • src/server/modules/auth/config/facebook-config.ts
  • src/server/modules/auth/config/google-config.ts
  • src/server/modules/auth/config/twitter-config.ts

To use it in mobile application with Facebook-token integration (Facebook App), use /api/auth/facebook/token endpoint.

Alternatives To Nest Angular
Select To Compare

Alternative Project Comparisons
Related Awesome Lists
Top Programming Languages
Top Projects

Get A Weekly Email With Trending Projects For These Topics
No Spam. Unsubscribe easily at any time.
Typescript (256,837
Server (66,088
Angular (54,858
Express (30,652
Mongodb (30,154
Auth (26,892
Webpack (23,675
Graphql (15,860
Facebook (13,847
Jwt (9,904
Mongoose (6,943
Nest (4,583
Nestjs (4,583
Apollo (4,465
Passport (4,217
Angular Cli (2,298
Jwt Auth (2,033
Jwt Authentication (2,032
Facebook Login (401
Google Login (263
Angular Universal (182
Passport Local (96
Passport Jwt (66
Twitter Login (30