updates for r24

Author: evanmcarlson

README.md

@@ -2,16 +2,16 @@
 
 8th Wall Web: WebAR for mobile devices!
 
-Built entirely using standards-compliant JavaScript and WebGL, 8th Wall Web is a complete implementation of 8th Wall’s Simultaneous Localization and Mapping (SLAM) engine, hyper-optimized for real-time AR on mobile browsers. Features include World Tracking, Image Targets, Face Effects, Lightship Visual Positioning System (VPS), and more.
+Built entirely using standards-compliant JavaScript and WebGL, 8th Wall Web is a complete implementation of 8th Wall’s Simultaneous Localization and Mapping (SLAM) engine, hyper-optimized for real-time AR on mobile browsers. Features include World Tracking, Image Targets, Face Effects, Lightship Visual Positioning System (VPS), Sky Effects, Hand Tracking, and more.
 
 - - -
 
 # Resources
 
-* [Getting Started Guide](https://github.com/8thwall/web/tree/master/gettingstarted)
+* [Getting Started Guide](https://www.8thwall.com/docs/guides/advanced-topics/local-hosting#getting-started)
+* [Serving projects over HTTPS](https://www.8thwall.com/docs/guides/advanced-topics/local-hosting#serve-projects-over-https)
 * [Documentation](https://www.8thwall.com/docs/web/)
 * [8th Wall Website](https://www.8thwall.com)
-* [Serving projects locally](https://github.com/8thwall/web/tree/master/serve)
 
 # Examples
 

examples/aframe/reactapp/README.md

@@ -21,8 +21,6 @@ If you're developing on Windows, modify the `start` script in package.json to ex
 set HTTPS=true&&react-app-rewired start
 ```
 
-In order to use the [serve script](https://github.com/8thwall/web/tree/master/serve) for testing the production build, you may need to run `export NODE_OPTIONS=--openssl-legacy-provider`, and execute the script on the build folder.
-
 ## Learn More
 
 This project was bootstrapped with [Create React App](https://github.com/facebook/create-react-app).

gettingstarted/README.md

@@ -1,16 +1,54 @@
 # Getting Started with 8th Wall
 
-## Download and run sample projects
+Use your own development workflow with 8th Wall self-hosting.
 
-To get started with 8th Wall web development, you will need to:
-* Create a Pro 8th Wall account at https://www.8thwall.com.
-* Create a new self-hosted project and [copy your App Key](https://www.8thwall.com/docs/web/#app-key) from the project settings page.
-* Download the source code from this repo, and replace the app key in `index.html` with your app key.
-* Serve the source code on your local network over https using the [serve script](https://github.com/8thwall/web/tree/master/serve).
-* Authorize access to your app key on your phone by [authorizing the device](https://www.8thwall.com/docs/web/#device-authorization) or [whitelisting the domain](https://www.8thwall.com/docs/web/#connected-domains) (localhost / IP address).
-* Connect to your sever from your phone, accept certificate warnings and camera permissions.
+## Clone and run sample projects
 
-## What you should see
+Follow the getting started guide by cloning self-hosted sample projects from this repository.
+
+To develop locally you need Node.js and npm installed. If you don't already have Node.js and npm installed, [get it here](https://www.npmjs.com/get-npm).
+
+1. Download the source code from this repository and `cd` into an example of your choice (aframe is recommended for beginners).
+2. Replace the app key in `index.html` with your [app key from the project settings page](https://www.8thwall.com/docs/guides/projects/project-settings/#app-key) in the 8th Wall console.
+3. Authorize access to your app key on your device by [authorizing the device](https://www.8thwall.com/docs/web/#device-authorization) or [whitelisting the domain](https://www.8thwall.com/docs/web/#connected-domains) (localhost / IP address).
+4. Serve a project directory on your local network over HTTPS with [http-server](https://github.com/http-party/http-server#readme). See [Serve projects over HTTPS](https://www.8thwall.com/docs/guides/advanced-topics/local-hosting/#serve-projects-over-https).
+5. Connect to your sever from your device, accept certificate warnings and camera permissions. See [View Project on iOS](https://www.8thwall.com/docs/guides/advanced-topics/local-hosting/#view-project-on-ios) or [View Project on Android](https://www.8thwall.com/docs/guides/advanced-topics/local-hosting/#view-project-on-android).
+
+## Serve projects over HTTPS
+
+Browsers require HTTPS certificates to access the camera. Use [http-server](https://github.com/http-party/http-server#readme) to serve project directories with HTTPS.
+
+First, you need to make sure that [openssl](https://github.com/openssl/openssl) is installed, and you have key.pem and cert.pem files. You can generate them using this command:
+
+```
+openssl req -newkey rsa:2048 -new -nodes -x509 -days 3650 -keyout key.pem -out cert.pem
+```
+
+You will be prompted with a few questions after entering the command. Use 127.0.0.1 as value for Common name if you want to be able to install the certificate in your OS's root certificate store or browser so that it is trusted.
+
+This generates a cert-key pair and it will be valid for 3650 days (about 10 years).
+
+Then you can run `http-server` with `-S` for enabling SSL and `-C` for your certificate file:
+
+```
+npx http-server [project-path] -S -C cert.pem
+```
+
+Example:
+
+```
+npx http-server gettingstarted/aframe/ -S -C cert.pem
+```
+
+**NOTE**: The first IP address listed is **127.0.0.1:8080** (which is the loopback
+device aka "localhost") and your mobile phone won't be able to connect to that IP address directly.
+Please use one of the other IP addresses.
+
+**WINDOWS USERS**: Run the http-server command using a standard Command Prompt window (cmd.exe). The script may generate errors if run from PowerShell.
+
+Learn more in the [http-server documentation](https://github.com/http-party/http-server#tlsssl).
+
+## What you should see 
 
 After following the steps above, you should have fully functional versions of: