Code Monkey home page Code Monkey logo

firefox-os-boilerplate-app's Introduction

Firefox OS Boilerplate App

This is a demo app for Firefox OS, loosely based on fxosstub, meant to act as a simple boilerplate for getting started with apps for Firefox OS.

It will give you a button to install it in Firefox OS - on a device, in the App Manager and in certain Nightly versions of Firefox.

It is a showcase of:

To add your own icon, I recommend using the Firefox OS app icons style guide.

The Firefox OS Boilerplate App apply the Gaia style of Firefox OS, but note that there is no obligation to add the same look, and feel to your application: Firefox OS applications are web applications, so no need to follow a UI guideline.

For up-to-date information on building Open Web Apps, visit the App Center on MDN.

Preview

To test/install this app, the recommended way is to download it or clone/fork this repository and run it in the App Manager (Tools > Web Developer > App Manager or go to the URL about:app-manager in Firefox) by clicking Add Packaged App and browse to where your local repository is.

Alternatively, you can test-run it from GitHub by installing it in the App Manager Dashboard - click Add Hosted App - by providing this URL:

For Packaged Apps

You can test packaged apps in version 2 and higher of the App Manager, by using the Add Directory button. If you want to access privileged APIs - such as deviceStorage, cross-domain XMLHttpRequest etc - you need to set type and permissions in the manifest file. E.g.

{
    "version": "1",
    "name": "Firefox OS Boilerplate App",
    "type" : "privileged"
    …

And:

"permissions": {
    "device-storage:pictures": {
        "access": "readcreate"
    },
    "systemXHR":{},
    "contacts": {
        "description" : "Reading out contacts",
        "access": "readcreate"
    }
}

All options to test packaged apps are outlined in the How to install packaged apps in Firefox OS – options and tools article

Contribute

Localization (L10n)

Get a Transifex account

Transifex is the platform that we use to manage the localization workflow.

Sign up for a Transifex account and visit the Firefox OS Boilerplate project.

Find your language

Click on the language that you want to localize and click the button

If your language is not listed, click the button.

Start translating!

Select the project you want to translate and hit the button.

When your translation is complete, we'll pull it into this repository.

firefox-os-boilerplate-app's People

Contributors

amirouche avatar archaeopteryx avatar christi3k avatar dougreeder avatar fharper avatar jor3l avatar mpous avatar potch avatar robnyman avatar shiladittyapaul avatar taboca avatar zalun avatar zenorocha avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

firefox-os-boilerplate-app's Issues

URL not passed to Facebook app while sharing

When I click on Share URL and choose Facebook in the list, I dont see Facebook app actually getting the URL. Below is the snapshot of what I am getting.

I didnt change the boilerplate code at all. Also, there is no error in the console.

image

+ install looks like it works in Firefox 23 on Ubuntu, but doesn't

I'm running Mozilla Firefox 23.0 on Ubuntu 13.04. Clicking "the + button in the top right corner to install this app" gave me a plain notification saying, roughly, "Firefox OS Boilerplate was installed" (yay!), and I can now launch "Firefox OS Boilerplate App" from the Unity launcher (yay!), but the new window that appears shows

404
There isn't a GitHub Page here.

the same error page I get if I visit https://bad.github.com/

I realize this is probably various limitations of web apps/Firefox/Ubuntu rather than your fine demo app, but it feels close to working 😄

URL not passed to Twitter app while sharing

This issue is similar to issue # 64.

When I click on Share URL and choose Twitter in the list, I dont see Twitter app actually getting the URL. Below is the snapshot of what I am getting.

image

I didnt change the boilerplate code at all initially but later I tried setting the type of data to url and then the Twitter app wasnt listed in the list that appears after clicking on Share URL.

Also, there is no error in the console.

This is happening in Flame device with Firefox OS v2.0.

MANIFEST_URL_ERROR when publishing similar app

I've playing with this boilerplate app and just ziped my version. The problem is that my app got rejected and I just can't fix it: when user try to install it through FFOS Marketplace, the message "App install error: MANIFEST_URL_ERROR" appears.

Any tip? This sample app should be facing the same problem.

New Gaia Style

In Firefox OS 1.2 Gaia have a flat graphic and in the boilerpalte exist only the style of older versions.Iit's possible add a second folder with the new graphic? So the developer can choose the graphic or add a code that check the Firefox OS version and load the correct Gaia style.

Remove master branch

There's no need for maintaining a master branch.

  1. Go ahead and make gh-pages as the default one

  2. Then remove master.

    git push origin :master
    

bn-BD localization is not present

We completed localizing the app in bn-BD locale. But it is not added in this repo. Why it's not added? Do we need to do some more things?

fxosRate integration

fxosRate is a Library to help the promotion of your Firefox Marketplace apps by encouraging application users to rate the application. The library decides when it's the best moment to ask users to rate the app based on a set of parameters.

Also support l0n.js
https://github.com/dcoloma/fxosRate

Maybe is an useful library to integrate in the boilerplate.

Privileged apps does not work

Firefox OS Simulator 3.0.1 returns

File not found
Firefox can't find the file at app://9ae0db53-4940-46e4-a500-f20cb7aba03b/app/."

Content JS ERROR at app://homescreen.gaiamobile.org/js/page.js:161 in icon_fetchImageData: Got an exception when trying to load icon "app://9ae0db53-4940-46e4-a500-f20cb7aba03b/app/images/logo64.png", falling back to cached icon. Exception is: [Exception... "File error: Not found" nsresult: "0x80520012 (NS_ERROR_FILE_NOT_FOUND)" location: "JS frame :: app://homescreen.gaiamobile.org/js/page.js :: icon_fetchImageData :: line 158" data: no]

Firefox OS Simulator Dashboard errors:

Packaged App
Validation Result: WARNINGS (0 errors and 1 warnings)
Warnings: Denied permission 'bluetooth' for type 'privileged'.

Hosted App
Validation Result: INVALID (1 errors and 0 warnings)
Errors: Hosted App can't be type 'privileged'.

Pushing on device packaged app, shows alert "App installed", but actually it did not install it and app icon does not shows up on screen. And on pushing hosted app, nothing happens at all.

The manifest.appcache additions

"type": "privileged",
"permissions": {
    "bluetooth": {}
}

I tried also to add also CSP header for index.php, but it did not help ether

header("Content-Security-Policy: default-src *; script-src 'self'; object-src 'none'; style-src 'self' 'unsafe-inline'");

Any solution or reported bug for it?

Cancelling Pick Image glitched?

Cancelling Pick Image gives a "Can't view the image!" dialogue. Compare with Pick Anything which simply aborts as expected.

i18n by default

I'd love to get a basic i18n layer in this boilerplate app, just to get me started with translating apps.
It's still unclear to me what is the best practice when it comes to i18n-ing Firefox OS apps, if any.

There´s no "Developer mode" setting

I want to install a privileged package. It installs fine without "privileged", but with this config the install fails. So I wanted to turn on "Developer mode", but there´s no setting menu for it.

So how to turn on Developer mode?

Bildschirmfoto 2013-02-10 um 18 21 04
Bildschirmfoto 2013-02-10 um 18 21 15

Worng Parameter on "add contact" function

In webapp.js:121 "familyName" should be instead "lastName", as for the latest Firefox OS Simulator.

Note: The strange thing is, that inside internally it somehow calls it familyName, even though it expects a property called "lastName". As seen in contacts_form.js:254 of gaia: "familyName.value = params.lastName"

Alarm API doesn't work

Hi,

I tested the template but the AlarmAPI buttom doesn't work. All looks correct, any idea? I tested on a Unagi device.

Regards

Gitit

Fix apps so I can up grade

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.