https://github.com/juliegibbs/angular-full-stack

Angular Full Stack project built using Angular, Express, Mongoose and Node. Whole stack in TypeScript.
https://github.com/juliegibbs/angular-full-stack

angular angular-cli bootstrap docker express jwt mongodb node typescript

Last synced: about 1 month ago
JSON representation

Angular Full Stack project built using Angular, Express, Mongoose and Node. Whole stack in TypeScript.

• Host: GitHub
• URL: https://github.com/juliegibbs/angular-full-stack
• Owner: JulieGibbs
• License: mit
• Created: 2024-03-20T16:55:47.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2024-03-20T16:58:07.000Z (8 months ago)
• Last Synced: 2024-10-14T05:40:32.799Z (about 1 month ago)
• Topics: angular, angular-cli, bootstrap, docker, express, jwt, mongodb, node, typescript
• Language: TypeScript
• Homepage:
• Size: 10.5 MB
• Stars: 3
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
# Angular Full Stack 

[![](https://github.com/davideviolante/Angular-Full-Stack/workflows/Build/badge.svg)](https://github.com/DavideViolante/Angular-Full-Stack/actions?query=workflow%3ABuild) [![](https://github.com/davideviolante/Angular-Full-Stack/workflows/Tests/badge.svg)](https://github.com/DavideViolante/Angular-Full-Stack/actions?query=workflow%3ATests) [![Donate](https://img.shields.io/badge/paypal-donate-179BD7.svg)](https://www.paypal.me/dviolante)

Angular Full Stack is a project to easly get started with the latest Angular using a real backend and database. Whole stack is in TypeScript, from frontend to backend, giving you the advantage to code in one single language throughout the all stack.

This project uses the [MEAN stack](https://en.wikipedia.org/wiki/MEAN_(software_bundle)):

* [**M**ongoose.js](http://www.mongoosejs.com) ([MongoDB](https://www.mongodb.com)): database

* [**E**xpress.js](http://expressjs.com): backend framework

* [**A**ngular 2+](https://angular.io): frontend framework

* [**N**ode.js](https://nodejs.org): runtime environment

Other tools and technologies used:

* [Angular CLI](https://cli.angular.io): frontend scaffolding

* [Bootstrap](http://www.getbootstrap.com): layout and styles

* [Font Awesome](http://fontawesome.com): icons

* [JSON Web Token](https://jwt.io): user authentication

* [Angular 2 JWT](https://github.com/auth0/angular2-jwt): JWT helper for Angular 2+

* [Bcrypt.js](https://github.com/dcodeIO/bcrypt.js): password encryption

## Prerequisites

1. Install [Node.js](https://nodejs.org) and [MongoDB](https://www.mongodb.com)

2. Install Angular CLI: `npm i -g @angular/cli`

3. From project root folder install all the dependencies: `npm i`

## Run

### Development mode with files watching

`npm run dev`: [concurrently](https://github.com/kimmobrunfeldt/concurrently) execute MongoDB, Angular build, TypeScript compiler and Express server.

A window will automatically open at [localhost:4200](http://localhost:4200). Angular and Express files are being watched. Any change automatically creates a new bundle, restart Express server and reload your browser.

### Production mode

`npm run prod`: run the project with a production bundle listening at [localhost:3000](http://localhost:3000) 

### Manual mode

1. Build frontend: `npm run builddev` for dev or `npm run build` for prod

2. Build backend: `npm run predev`

3. Run MongoDB: `mongod`

4. Run the app: `npm start`

### Docker

1. `sudo docker-compose up`

2. Go to [localhost:3000](http://localhost:3000)

### AWS EC2

1. Create a EC2 Linux machine on AWS

2. Edit the EC2 Security Group and add TCP port `3000` as an Inbound rule for Source `0.0.0.0/0`

3. Clone this repo into the EC2 machine

4. If you use a remote MongoDB instance, edit `.env` file

5. Run `npm ci`

6. Run `npm run build`

7. Run `npm start`

8. The app is now running and listening on port 3000

9. You can now visit the public IP of your AWS EC2 followed by the port, eg: `12.34.56.78:3000`

10. Tip: use [pm2](https://pm2.keymetrics.io/) to run the app instead of `npm start`, eg: `pm2 start dist/server/app.js`

## Preview

![Preview](https://raw.githubusercontent.com/DavideViolante/Angular2-Full-Stack/master/demo.gif "Preview")

## Please open an issue if

* you have any suggestion to improve this project

* you noticed any problem or error

## Running tests

Run `ng test` to execute the frontend unit tests via [Karma](https://karma-runner.github.io).

Run `npm run testbe` to execute the backend tests via [Jest](https://jestjs.io/) (it requires `mongod` already running).

## Running linters

Run `npm run lint` to execute [Angular ESLint](https://github.com/angular-eslint/angular-eslint), [HTML linting](https://github.com/htmlhint/HTMLHint) and [SASS linting](https://github.com/sasstools/sass-lint).

## Wiki

To get more help about this project, [visit the official wiki](https://github.com/DavideViolante/Angular-Full-Stack/wiki).

## Further help

To get more help on the `angular-cli` use `ng --help` or go check out the [Angular-CLI README](https://github.com/angular/angular-cli/blob/master/README.md).

### Author

* [Davide Violante](https://github.com/DavideViolante)