From 277fbcb9fbcce4dd8d8f8c1102b0613f0a10e8c2 Mon Sep 17 00:00:00 2001
From: Michael Werner Czechowski <nextlevelshit@users.noreply.github.com>
Date: Tue, 19 Feb 2019 16:08:41 +0100
Subject: [PATCH] =?UTF-8?q?Added=20=C2=BBGetting=20started=C2=AB=20section?=
 =?UTF-8?q?=20for=20beginners?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

...and explained node scripts.
---
 README.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++++++-
 1 file changed, 56 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 7d387bd..d4a38ee 100644
--- a/README.md
+++ b/README.md
@@ -3,6 +3,61 @@ Stardust Example Code
 
 This repository provides a set of Web visualization and graphic examples using the Stardust library.
 
+Gettings started
+----
+
+### Requirements
+
+Before executing these examples, make sure you have [node.js](https://nodejs.org) installed:
+
+```bash
+node -v
+```
+Expected output could be `v10.0.0`, otherwise please instale `node` and `npm`. You will find detailed instructions how to install these on the web.
+
+### Clone the repository
+
+If you prefer SSH:
+
+```bash
+git clone git@github.com:stardustjs/stardust-examples.git
+```
+
+or if you prefer HTTPS:
+
+```bash
+https://github.com/stardustjs/stardust-examples.git
+```
+Both will work.
+
+### Install dependencies
+
+Change directory into the new repository (`cd stardust-examples`) and install all dependencies:
+
+```bash
+npm install
+```
+
+Or if you prefer `yarn`:
+
+```bash
+yarn
+```
+
+### Serve examples
+
+This package has a built-in node server from which you can serve the examples on your local machine. Therefore use one of these scripts:
+
+| command        | description                                                              |
+|----------------|--------------------------------------------------------------------------|
+| npm run build  | Transpile all examples for distribution on an external server            |
+| npm run start  | Serve examples on locale machine. Before serving, mind to build it first |
+| npm run watch  | Serve development server with hot reloads                                |
+| npm run deploy | Deploy examples                                                          |
+
+If you prefer `yarn`, just replace `npm run` with `yarn`. For example `yarn build`.
+
+
 Example Structure
 ----
 
@@ -29,4 +84,4 @@ Common code for all examples:
             "file.to.exclude",
             ...
         ]
-    }
\ No newline at end of file
+    }