marley icon indicating copy to clipboard operation
marley copied to clipboard

Modern Angular 7+ Starter Kit. (Angular 7+, Angular CLI, Karma, Protractor, Stylelint, Prettier, TypeScript, Global Error Handling, Gitlab CI) by Petr Nikolas Prokop (http://www.petrnikolas.com/)

Marley

Table of Contents

  • Benefits
  • Libraries
  • Project Setup
  • Creating an Application
  • Creating a Library
  • Creating Libraries with Tags
  • Creating components in a library or app
  • Ngrx Store Generation
  • Updating Nx
  • Development server
  • Build
  • Running unit tests
  • Running end-to-end tests
  • Affected Apps
  • Gitlab CI

Benefits

  • Quickstart a project in seconds and focus on features, not on frameworks or tools
  • Scalable architecture with base app template including example components, services and tests

Libraries

Coding guides

  • Angular
  • TypeScript
  • Sass
  • HTML
  • Unit tests
  • End-to-end tests

Other documentation

  • I18n guide
  • Working behind a corporate proxy
  • Updating dependencies and tools
  • Using a backend proxy for development
  • Browser routing

Project Setup

  1. Clone this repo.
  2. Run yarn install to install dependencies.

Development server

Run yarn serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Run with proxy

  1. Run yarn start:proxy to build the project for development and serve with proxy config.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive|pipe|service|class|guard|interface|enum|module.

Build

Run yarn build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

To build only the changed files since the last build run:

Running unit tests

Run yarn test to execute the unit tests via Karma.

Running end-to-end tests

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

Gitlab CI

  • In .ci folder are two prepared files for Heroku and AWS deploy. You can choose one of these.