Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/mozilla/goggles.mozilla.org

Update: This project is no longer maintained and has been archived. See https://foundation.mozilla.org/blog/putting-away-our-x-ray-goggles/ for more information.
https://github.com/mozilla/goggles.mozilla.org

Last synced: 3 months ago
JSON representation

Update: This project is no longer maintained and has been archived. See https://foundation.mozilla.org/blog/putting-away-our-x-ray-goggles/ for more information.

Awesome Lists containing this project

README

        

Mozilla X-Ray goggles
=====================

Important Update
----------------

This project is no longer maintained and has been archived. See [this blog post](https://foundation.mozilla.org/blog/putting-away-our-x-ray-goggles/) for more information.

About
-----

This is a client-side (with small server component) application that hosts the Mozilla X-Ray Goggles library. It is dependent on having an [id.wmo] and [publish.wmo] end point to talk to for its user authentication and data publication functionality, respectively. The end point URLs can be set in the `.env` file used.

Getting up and running
----------------------

In your Git directory (or whichever directory you want to place the goggles in), type:

```
$> git clone https://github.com/mozilla/goggles.webmaker.org
$> cd goggles.webmaker.org
$> npm install
$> cp env.dist .env
```

Then any time you wish to (re)compile the library and run the Goggles server, type:
```
$> npm start
```

Environment variables
---------------------

The following environment variables are important to change, if you want to use the goggles in an atypical enviroment (i.e. one where any of the services used or relied upon does not use the default supplied `.env` file)

```
PORT: the port the service will run on.
APP_HOSTNAME: the domain the service will be running on, port included.
HACKPUBURL: the domain the service will be running on, port included.
ID_WMO_URL: the URL for the id.webmaker.org service, port included.
ID_WMO_CLIENT_ID: the client identifier assigned to goggles by thje id.webmaker.org instance pointed to.
PUBLISH_WMO_URL: the URL for the publish.webmaker.org service, port included.
```

Deployment
----------

Deployment uses a Heroku pipeline.

- staging: https://goggles-mozilla-org-staging.herokuapp.com (https://goggles.mofostaging.net)
- production: https://goggles-mozilla-org-production.herokuapp.com (https://goggles.mozilla.org)