apache / apache/cordova-docs

Document differences between file-based Cordova app vs HTTP(S) web app

Open
#1,044 1 comment 0 reactions 0 assignees View on GitHub
Dominant language
JavaScript
Stars
353
Forks
565
Avg merge
7h 15m
Merged PRs (30d)
5

Description

* While most apps would be based on a http: or https: origin domain, a Cordova app would be based on some kind of a file:// index URI path. I think both this difference and the potential consequences are not clear at all in the Cordova documentation. Examples of potential consequences include:
- Problems with postMessage call such as
- CORS (??? ???)
* It seems to be not 100% clear that a script tag to include cordova.js is needed when embedding an existing SPA web app in Cordova (see issue #852)
* etc. etc.

Contributor guide

Open the contributing guide

Research direction

Start by reviewing the existing Cordova documentation and the related issues #177 and #852. Document the differences between file:// and HTTP(S) origins, their consequences such as postMessage and CORS behavior, and when an embedded SPA needs cordova.js.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript
Domain
documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
35/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.