aframevr · dmarcos · Apr 15, 2020 · Feb 12, 2020 · Feb 13, 2020 · Feb 15, 2020
diff --git a/docs/introduction/installation.md b/docs/introduction/installation.md
@@ -123,3 +123,88 @@ A-Frame.  `angle` can initialize a scene template with a single command:
 ```sh
 npm install -g angle && angle initscene
 ```
+
+## Cordova Development
+
+A-Frame is compatible with Cordova apps. Currently, network access is required as A-Frame and its dependencies load assets from CDN sources.
+
+[Cordova A-Frame Showcase App (demo)](https://github.com/benallfree/cordova-aframe-showcase)
+
+### Installation
+
+Install the [cordova-plugin-xhr-local-file](https://github.com/benallfree/cordova-plugin-xhr-local-file) plugin. This is needed because
+Cordova runs from `file://`, and XHR requests to local `file://` assets (JSON fonts, 3D models, etc) will fail without this plugin.
+
+```bash
+cordova plugin add cordova-plugin-xhr-local-file
+```
+
+In your `index.html`, adjust as follows:
+
+```html
+<head>
+  <meta
+        http-equiv="Content-Security-Policy"
+        content="
+          default-src 
+            'self' 
+            data: 
+            gap: 
+            https://ssl.gstatic.com 
+            'unsafe-eval' 
+            https://cdn.aframe.io         <-- required
+            https://dpdb.webvr.rocks      <-- required
+            https://fonts.googleapis.com  <-- required
+            https://cdn.jsdelivr.net      <-- your choice, see below
+            ; 
+          style-src 
+            'self' 
+            'unsafe-inline'
+            ; 
+          media-src *; 
+          img-src 
+            'self' 
+            data:                         <-- required
+            content:                      <-- required
+            blob:                         <-- required
+            ;
+        "
+      />
+  ...
+  <script src="https://cdn.jsdelivr.net/npm/aframe@1.0.4/dist/aframe-master.min.js"></script>
+  <script id='my-scene' type="text/html">
+    ...your scene goes here...
+  </script>
+  <script>
+    document.addEventListener('deviceready', function() {
+      // After the 'deviceready' event, Cordova is ready for you to render your A-Frame scene.
+      document.getElementById('scene-root').innerHTML = document.getElementById('my-scene').innerHTML
+    })
+  </script>
+</head>
+<body>
+  <div id='scene-root'></div>
+  ...
+</body>
+```
+
+### Discussion
+
+
+#### deviceready
+The most important difference between a browser environment and a Cordova environment is waiting for the `deviceready` event
+before rendering your scene. 
+
+The sample above shows a pure DOM+JS approach, but you can also use a framework like React:
+
+```javascript
+document.addEventListener('deviceready', () => {
+  ReactDOM.render(<Root />, document.getElementById('root'))
+})
+```
+
+#### Layout
+
+Depending on your target device, you may find that A-Frame's default CSS causes certain buttons and controls to appear out of
+position or too close to the edge of the phone screen. Supply your own CSS overrides to adjust positioning to fit
+the target device.
diff --git a/src/index.js b/src/index.js
@@ -17,7 +17,8 @@ if (!window.hasNativeWebXRImplementation && !window.hasNativeWebVRImplementation
   var polyfillConfig = {
     BUFFER_SCALE: bufferScale,
     CARDBOARD_UI_DISABLED: true,
-    ROTATE_INSTRUCTIONS_DISABLED: true
+    ROTATE_INSTRUCTIONS_DISABLED: true,
+    MOBILE_WAKE_LOCK: !!window.cordova
   };
   window.webvrpolyfill = new WebVRPolyfill(polyfillConfig);
 }
@@ -43,7 +44,7 @@ if (window.document.currentScript && window.document.currentScript.parentNode !=
 }
 
 // Error if not using a server.
-if (window.location.protocol === 'file:') {
+if (!window.cordova && window.location.protocol === 'file:') {
   error(
     'This HTML file is currently being served via the file:// protocol. ' +
     'Assets, textures, and models WILL NOT WORK due to cross-origin policy! ' +