# 01gind-modulea
> QuickStart package.json from the documentation, supplemented with testing support
Latest version **1.2.0** (published 2017-10-17) · MIT license · 0 weekly downloads
## Install
```sh
npm install 01gind-modulea
pnpm add 01gind-modulea
yarn add 01gind-modulea
bun add 01gind-modulea
```
## Health
**Score 15/100 (F)** — status: abandoned.
Positive: no vulnerabilities.
Warnings: low downloads; no types; no esm support.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 1.2.0 |
| Published | 2017-10-17 |
| First published | 2017-10-17 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | none |
| Module format | CommonJS |
| Dependencies | 17 |
| Known vulnerabilities | 0 (+29 in 4 direct dependencies) |
| Install scripts | no |
| Maintainers | gindseb |
## Links
- npm: https://www.npmjs.com/package/01gind-modulea
- npm.io page: https://npm.io/package/01gind-modulea
## Dependencies (17)
- [rxjs](https://npm.io/package/rxjs.md) 5.0.1
- [core-js](https://npm.io/package/core-js.md) ^2.4.1
- [zone.js](https://npm.io/package/zone.js.md) ^0.8.4
- [systemjs](https://npm.io/package/systemjs.md) 0.19.40
- [typescript](https://npm.io/package/typescript.md) ^2.2.1
- [@angular/core](https://npm.io/package/@angular/core.md) ^5.0.0-rc.1
- [@angular/http](https://npm.io/package/@angular/http.md) ^5.0.0-rc.1
- [@angular/forms](https://npm.io/package/@angular/forms.md) ^5.0.0-rc.1
- [@angular/common](https://npm.io/package/@angular/common.md) ^5.0.0-rc.1
- [@angular/router](https://npm.io/package/@angular/router.md) ^5.0.0-rc.1
- [@angular/compiler](https://npm.io/package/@angular/compiler.md) ^5.0.0-rc.1
- [@angular/animations](https://npm.io/package/@angular/animations.md) ^5.0.0-rc.1
- [@angular/compiler-cli](https://npm.io/package/@angular/compiler-cli.md) ^5.0.0-rc.1
- [@angular/platform-server](https://npm.io/package/@angular/platform-server.md) ^5.0.0-rc.1
- [@angular/platform-browser](https://npm.io/package/@angular/platform-browser.md) ^5.0.0-rc.1
- [angular-in-memory-web-api](https://npm.io/package/angular-in-memory-web-api.md) ~0.3.0
- [@angular/platform-browser-dynamic](https://npm.io/package/@angular/platform-browser-dynamic.md) ^5.0.0-rc.1
## Recent versions
- 1.2.0 (latest) — 2017-10-17
- 1.0.0 — 2017-10-17
## README
# Angular QuickStart Source
[![Build Status][travis-badge]][travis-badge-url]
This repository holds the TypeScript source code of the [angular.io quickstart](https://angular.io/docs/ts/latest/quickstart.html),
the foundation for most of the documentation samples and potentially a good starting point for your application.
It's been extended with testing support so you can start writing tests immediately.
**This is not the perfect arrangement for your application. It is not designed for production.
It exists primarily to get you started quickly with learning and prototyping in Angular**
We are unlikely to accept suggestions about how to grow this QuickStart into something it is not.
Please keep that in mind before posting issues and PRs.
## Updating to a newer version of the Quickstart Repo
From time to time the QuickStart will be enhanced with support for new features or to reflect
changes to the [official Style Guide](https://angular.io/docs/ts/latest/guide/style-guide.html).
You can update your existing project to an up-to-date QuickStart by following these instructions:
- Create a new project using the [instructions below](#create-a-new-project-based-on-the-quickstart)
- Copy the code you have in your project's `main.ts` file onto `src/app/main.ts` in the new project
- Copy your old `app` folder into `src/app`
- Delete `src/app/main.ts` if you have one (we now use `src/main.ts` instead)
- Copy your old `index.html`, `styles.css` and `tsconfig.json` into `src/`
- Install all your third party dependencies
- Copy your old `e2e/` folder into `e2e/`
- Copy over any other files you added to your project
- Copy your old `.git` folder into your new project's root
Now you can continue working on the new project.
## Prerequisites
Node.js and npm are essential to Angular development.
Get it now if it's not already installed on your machine.
**Verify that you are running at least node `v4.x.x` and npm `3.x.x`**
by running `node -v` and `npm -v` in a terminal/console window.
Older versions produce errors.
We recommend [nvm](https://github.com/creationix/nvm) for managing multiple versions of node and npm.
## Create a new project based on the QuickStart
Clone this repo into new project folder (e.g., `my-proj`).
```shell
git clone https://github.com/angular/quickstart my-proj
cd my-proj
```
We have no intention of updating the source on `angular/quickstart`.
Discard the `.git` folder..
```shell
rm -rf .git # OS/X (bash)
rd .git /S/Q # windows
```
### Delete _non-essential_ files (optional)
You can quickly delete the _non-essential_ files that concern testing and QuickStart repository maintenance
(***including all git-related artifacts*** such as the `.git` folder and `.gitignore`!)
by entering the following commands while in the project folder:
##### OS/X (bash)
```shell
xargs rm -rf < non-essential-files.osx.txt
rm src/app/*.spec*.ts
rm non-essential-files.osx.txt
```
##### Windows
```shell
for /f %i in (non-essential-files.txt) do del %i /F /S /Q
rd .git /s /q
rd e2e /s /q
```
### Create a new git repo
You could [start writing code](#start-development) now and throw it all away when you're done.
If you'd rather preserve your work under source control, consider taking the following steps.
Initialize this project as a *local git repo* and make the first commit:
```shell
git init
git add .
git commit -m "Initial commit"
```
>Recover the deleted `.gitignore` from the QuickStart repository
if you lost it in the _Delete non-essential files_ step.
Create a *remote repository* for this project on the service of your choice.
Grab its address (e.g. *`https://github.com//my-proj.git`*) and push the *local repo* to the *remote*.
```shell
git remote add origin
git push -u origin master
```
## Install npm packages
> See npm and nvm version notes above
Install the npm packages described in the `package.json` and verify that it works:
```shell
npm install
npm start
```
>Doesn't work in _Bash for Windows_ which does not support servers as of January, 2017.
The `npm start` command first compiles the application,
then simultaneously re-compiles and runs the `lite-server`.
Both the compiler and the server watch for file changes.
Shut it down manually with `Ctrl-C`.
You're ready to write your application.
### npm scripts
We've captured many of the most useful commands in npm scripts defined in the `package.json`:
* `npm start` - runs the compiler and a server at the same time, both in "watch mode".
* `npm run build` - runs the TypeScript compiler once.
* `npm run build:w` - runs the TypeScript compiler in watch mode; the process keeps running, awaiting changes to TypeScript files and re-compiling when it sees them.
* `npm run serve` - runs the [lite-server](https://www.npmjs.com/package/lite-server), a light-weight, static file server, written and maintained by
[John Papa](https://github.com/johnpapa) and
[Christopher Martin](https://github.com/cgmartin)
with excellent support for Angular apps that use routing.
Here are the test related scripts:
* `npm test` - compiles, runs and watches the karma unit tests
* `npm run e2e` - compiles and run protractor e2e tests, written in Typescript (*e2e-spec.ts)
## Testing
The QuickStart documentation doesn't discuss testing.
This repo adds both karma/jasmine unit test and protractor end-to-end testing support.
These tools are configured for specific conventions described below.
*It is unwise and rarely possible to run the application, the unit tests, and the e2e tests at the same time.
We recommend that you shut down one before starting another.*
### Unit Tests
TypeScript unit-tests are usually in the `src/app` folder. Their filenames must end in `.spec.ts`.
Look for the example `src/app/app.component.spec.ts`.
Add more `.spec.ts` files as you wish; we configured karma to find them.
Run it with `npm test`
That command first compiles the application, then simultaneously re-compiles and runs the karma test-runner.
Both the compiler and the karma watch for (different) file changes.
Shut it down manually with `Ctrl-C`.
Test-runner output appears in the terminal window.
We can update our app and our tests in real-time, keeping a weather eye on the console for broken tests.
Karma is occasionally confused and it is often necessary to shut down its browser or even shut the command down (`Ctrl-C`) and
restart it. No worries; it's pretty quick.
### End-to-end (E2E) Tests
E2E tests are in the `e2e` directory, side by side with the `src` folder.
Their filenames must end in `.e2e-spec.ts`.
Look for the example `e2e/app.e2e-spec.ts`.
Add more `.e2e-spec.js` files as you wish (although one usually suffices for small projects);
we configured Protractor to find them.
Thereafter, run them with `npm run e2e`.
That command first compiles, then simultaneously starts the `lite-server` at `localhost:8080`
and launches Protractor.
The pass/fail test results appear at the bottom of the terminal window.
A custom reporter (see `protractor.config.js`) generates a `./_test-output/protractor-results.txt` file
which is easier to read; this file is excluded from source control.
Shut it down manually with `Ctrl-C`.
[travis-badge]: https://travis-ci.org/angular/quickstart.svg?branch=master
[travis-badge-url]: https://travis-ci.org/angular/quickstart
---
_Source: https://npm.io/package/01gind-modulea · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._