docs: add universal guide (#18707)

- based on original effort in PR 17573

PR Close #18707

aio/tools/example-zipper/customizer/package-json/universal.json

@@ -0,0 +1,41 @@
+{
+  "scripts": [
+    { "name": "build" },
+    { "name": "build:watch" },
+    { "name": "serve" },
+    { "name": "build:aot" },
+    { "name": "serve:aot" },
+    { "name": "build:uni" },
+    { "name": "serve:uni" },
+    { "name": "copy-dist-files" },
+    { "name": "i18n" }
+  ],
+  "dependencies": [
+    "systemjs",
+    "@angular/compiler-cli",
+    "@angular/platform-server",
+    "express"
+  ],
+  "devDependencies": [
+    "@ngtools/webpack",
+    "@types/angular",
+    "@types/angular-animate",
+    "@types/angular-cookies",
+    "@types/angular-mocks",
+    "@types/angular-resource",
+    "@types/angular-route",
+    "@types/angular-sanitize",
+    "@types/express",
+    "canonical-path",
+    "http-server",
+    "concurrently",
+    "lite-server",
+    "raw-loader",
+    "rollup",
+    "rollup-plugin-commonjs",
+    "rollup-plugin-node-resolve",
+    "rollup-plugin-uglify",
+    "source-map-explorer",
+    "webpack"
+  ]
+}

aio/tools/examples/shared/boilerplate/systemjs/package.json

@@ -30,6 +30,10 @@
     "test:webpack": "karma start karma.webpack.conf.js",
     "build:webpack": "rimraf dist && webpack --config config/webpack.prod.js --bail",
     "build:babel": "babel src -d src --extensions \".es6\" --source-maps",
+    "build:uni": "webpack --config webpack.config.universal.js",
+    "serve:uni": "node src/dist/server.js",
+
+    "clean": "rimraf src/dist && rimraf src/app/*.js* && rimraf src/universal/*.js* && rimraf src/main.js*",
     "copy-dist-files": "node ./copy-dist-files.js",
     "i18n": "ng-xi18n"
   },

aio/tools/examples/shared/boilerplate/systemjs/src/tsconfig.json

@@ -16,6 +16,7 @@
   "compileOnSave": true,
   "exclude": [
     "node_modules/*",
-    "**/*-aot.ts"
+    "**/*-aot.ts",
+    "universal/*"
   ]
 }

aio/tools/examples/shared/package.json

@@ -27,13 +27,15 @@
     "@angular/upgrade": "~4.3.1",
     "angular-in-memory-web-api": "~0.4.0",
     "core-js": "^2.4.1",
+    "express": "^4.14.1",
     "rxjs": "^5.1.0",
     "systemjs": "0.19.39",
     "web-animations-js": "^2.3.1",
     "zone.js": "^0.8.4"
   },
   "devDependencies": {
-    "@angular/cli": "1.3.1",
+    "@angular/cli": "^1.3.1",
+    "@ngtools/webpack": "^1.2.11",
     "@types/angular": "^1.5.16",
     "@types/angular-animate": "^1.5.5",
     "@types/angular-cookies": "^1.4.2",
@@ -41,6 +43,7 @@
     "@types/angular-resource": "^1.5.6",
     "@types/angular-route": "^1.3.2",
     "@types/angular-sanitize": "^1.3.3",
+    "@types/express": "^4.0.35",
     "@types/jasmine": "~2.5.53",
     "@types/jasminewd2": "^2.0.3",
     "@types/node": "^6.0.45",

aio/tools/examples/shared/yarn.lock

@@ -230,7 +230,11 @@
   version "2.0.46"
   resolved "https://registry.yarnpkg.com/@types/jquery/-/jquery-2.0.46.tgz#c245426299b43c4bb75f44b813090bd5918d00f2"
 
-"@types/node@^6.0.45", "@types/node@^6.0.46":
+"@types/mime@*":
+  version "1.3.1"
+  resolved "https://registry.yarnpkg.com/@types/mime/-/mime-1.3.1.tgz#2cf42972d0931c1060c7d5fa6627fce6bd876f2f"
+
+"@types/node@*", "@types/node@^6.0.45", "@types/node@^6.0.46":
   version "6.0.78"
   resolved "https://registry.yarnpkg.com/@types/node/-/node-6.0.78.tgz#5d4a3f579c1524e01ee21bf474e6fba09198f470"
 
@@ -242,6 +246,13 @@
   version "2.53.42"
   resolved "https://registry.yarnpkg.com/@types/selenium-webdriver/-/selenium-webdriver-2.53.42.tgz#74cb77fb6052edaff2a8984ddafd88d419f25cac"
 
+"@types/serve-static@*":
+  version "1.7.31"
+  resolved "https://registry.yarnpkg.com/@types/serve-static/-/serve-static-1.7.31.tgz#15456de8d98d6b4cff31be6c6af7492ae63f521a"
+  dependencies:
+    "@types/express-serve-static-core" "*"
+    "@types/mime" "*"
+
 abbrev@1:
   version "1.1.0"
   resolved "https://registry.yarnpkg.com/abbrev/-/abbrev-1.1.0.tgz#d0554c2256636e2f56e7c2e5ad183f859428d81f"