README.md

Angular Full Stack

The frontend is generated with Angular CLI. The backend is made from scratch. Whole stack in TypeScript.

This project uses the MEAN stack:

• Mongoose.js (MongoDB): database
• Express.js: backend framework
• Angular 4: frontend framework
• Node.js: runtime environment

Other tools and technologies used:

• Angular CLI: frontend scaffolding
• Bootstrap: layout and styles
• Font Awesome: icons
• JSON Web Token: user authentication
• Angular 2 JWT: JWT helper for Angular
• Bcrypt.js: password encryption

Prerequisites

1. Install Node.js and MongoDB
2. Install Angular CLI: npm i -g @angular/cli
3. From project root folder install all the dependencies: npm i

Run

Development mode

npm run dev: concurrently execute MongoDB, Angular build, TypeScript compiler and Express server.

A window will automatically open at 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 and AOT compilation listening at localhost:3000

Deploy (Heroku)

1. Go to Heroku and create a new app
2. Install Heroku CLI
3. heroku login
4. cd my-project/
5. git init
6. heroku git:remote -a your-app-name
7. Download this repo and copy all files into my-project folder
8. Edit .gitignore and remove line with /dist
9. Edit in db.ts the url of MongoDB server to a real server. You can create a MongoDB server with Heroku or mLab.
10. npm i
11. ng build -prod or ng build -aot -prod
12. tsc -p server
13. git add .
14. git commit -m "Going to Heroku"
15. git push heroku master
16. heroku open
17. A window will open with your app online

Preview

Please open an issue if

• you have any suggestion to improve this project
• you noticed any problem or error
• you have a question

To do

• More tests

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor. Before running the tests make sure you are serving the app via npm start.

Running TSLint

Run ng lint (frontend) and npm run lintbe (backend) to execute the linter via TSLint.

Further help

To get more help on the angular-cli use ng --help or go check out the Angular-CLI README.

To get more help about this project, visit the wiki.

Author

• Davide Violante