You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
> This is the seed project for the [Angular Fundamentals](https://ultimateangular.com/courses/#angular-2) course by [Todd Motto](https://twitter.com/toddmotto).
6
+
7
+
## Project Setup and Tooling
8
+
9
+
### Tools
10
+
11
+
This course is recorded with the following tools, you can optionally follow along using the same, or your favourite text editor/IDE and browser.
12
+
13
+
*Text editor*: Visual Studio Code, you can [download it here](http://code.visualstudio.com) for both Mac, Windows and Linux.
14
+
*Browser*: Google Chrome, you can [download it here](https://www.google.com/chrome)
15
+
16
+
### Prerequisites
17
+
18
+
Please make sure that you have the following installed:
19
+
20
+
* Install the _latest version_ of [Node.js](http://nodejs.org) (Mac or Windows)
21
+
* Mac users can optionally `brew install node` if they have [brew](http://brew.sh) installed
22
+
23
+
* Node Sass, you _may_ need it if you haven't already got it installed:
24
+
25
+
```bash
26
+
npm install -g node-sass
27
+
```
28
+
29
+
### Project Install
30
+
31
+
To grab the seed project, either Fork this repo or [click here to download](https://github.com/UltimateAngular/angular-fundamentals-seed/archive/master.zip) the `.zip` folder and extract the files wherever you like on your machine.
32
+
33
+
#### Step 1: Package Manager
34
+
35
+
To install the project dependencies, you will need to install `yarn`. To install `yarn`, run the following in your terminal:
36
+
37
+
```bash
38
+
npm install -g yarn
39
+
```
40
+
41
+
Mac users can alternatively use `brew` to install `yarn`.
42
+
43
+
```bash
44
+
brew update
45
+
brew install yarn
46
+
```
47
+
48
+
If you experience any issues when installing/using `yarn` you can checkout the installation instructions [here](https://yarnpkg.com/en/docs/install).
49
+
50
+
##### Step 2: Project Dependencies
51
+
52
+
Now that we have a package manager, we can install the project dependencies. You can do this by running:
53
+
54
+
```bash
55
+
yarn install
56
+
```
57
+
58
+
This will install our dependencies for running our Angular application.
59
+
60
+
#### Step 3: Running the project
61
+
62
+
During development, the project is built using `webpack-dev-server`. This provides a local development server as well as having webpack recompile our app when a file changes. The project will also automatically refresh the page whenever we make changes.
63
+
64
+
To start the project in development, run:
65
+
66
+
```
67
+
yarn start
68
+
```
69
+
70
+
This will output some information about the project (such as the TypeScript version and build progress). Once you see "build completed", you are ready to code!
71
+
72
+
Open your browser to [localhost:4000](http://localhost:4000) to start running the code.
73
+
74
+
### Project Tooling
75
+
76
+
The project uses `webpack` to build and compile all of our assets. This will do the following for us:
77
+
78
+
- Compile all our TypeScript code into JavaScript (starting from `main.ts` and branching outwards from imported files)
79
+
- Bundle all our JavaScript into one file to use
80
+
- Allow us to use SASS for our component's CSS files
81
+
- Provide the polyfills needed to run our app in all modern browsers
82
+
- Mock a JSON backend using [json-server](https://github.com/typicode/json-server)
0 commit comments