Skip to content
This repository was archived by the owner on Dec 20, 2022. It is now read-only.

1. Get started

Jump to bottom
borodean edited this page Jan 3, 2015 · 7 revisions

Installation

First of all, you need configure environment on your machine:

  1. Install nginx,
  2. Install NodeJS and npm, which goes bundled with node (you should consider installing it with nvm).

Then clone or download ngseed repo to your computer:

Run git clone [email protected]:StarterSquad/ngseed.git <PROJECT NAME> in your terminal or download ZIP

Configuration

After installation is done prepare application to run.

Nginx

You need to extend default nginx config with ngseed config to have dev website running locally.

In order to set it up you should:

  • open global nginx.conf in editor (e.g. mine was installed with homebrew and can be found here /usr/local/etc/nginx/nginx.conf),
  • insert content of nginx.conf.example into server { ... } block just before closing curly }
  • replace {{ABSOLUTE_PATH_TO_PROJECT_SOURCE}} placeholder with path to folder where ngseed is.

Don't forget to modify hosts (add 127.0.0.1 ngseed.dev build.ngseed.dev to /etc/hosts). Reload nginx, go to http://ngseed.dev in your browser and enjoy errors in javascript console.

Bower dependencies

Make sure that you have bower installed, if not run: npm install -g bower, then from ngseed folder run bower install. After it is done you can go back to site in browser and verify that there are no errors in the console anymore, but no styles as well.

Node modules

Almost there. Now from ngseed location run npm install and npm install -g gulp. Gulp is a build system. To run whole build flow type gulp and hit enter. After it's finished, you can see the project served from uncompiled source files at http://ngseed.dev and compiled + minified version at http://build.ngseed.dev.

You're all set now!

Clone this wiki locally