Firefox Accounts Content Server
JavaScript HTML CSS Shell
Latest commit 3af4e9a Aug 24, 2016 @vladikoff vladikoff committed on GitHub fix(oauth): set TTL for the authorization request (#4075) r=shane-tom…
…linson

Fixes #3982
Failed to load latest commit information.
app fix(oauth): set TTL for the authorization request (#4075) r=shane-tom… Aug 24, 2016
docs refactor(client): Remove support for fx_ios_v2 (#4080) r=vladikoff Aug 24, 2016
grunttasks refactor(client): Use cache busting URLs with require on demand. (#4002 Aug 13, 2016
locale fix(l10n): remove redundant l10n files Nov 16, 2015
scripts chore(awsbox): remove no longer used awsbox Dec 19, 2015
server feat(experiments): update latest experiments for train-68 (#4071) Aug 22, 2016
tests fix(tests): adjust timeouts and window handles for TeamCity tests (#4081 Aug 24, 2016
.bowerrc chore(build): disable bower analytics Jul 7, 2015
.editorconfig feat(oauth): suggest account to use during sign up if possible Apr 30, 2015
.eslintignore chore(lint): switch from JSHint to ESLint Jun 12, 2015
.eslintrc refactor(jscs): port jscs to eslint (#3946) r=vladikoff Jul 21, 2016
.gitattributes Generated basic Yeoman project. Dec 4, 2013
.gitignore feat(build): ES6 with babel (#3841) Jul 18, 2016
.htmllintrc chore(htmllint): add htmllint to repo Jul 13, 2015
.nsprc fix(client): update to latest able version (#4018) Aug 4, 2016
.sass-lint.yml chore(sass-lint): add sass linting (#3732) r=vladikoff,pdehaan May 16, 2016
.travis.yml chore(travis): retry nsp check on travis due to flaky api Aug 23, 2016
AUTHORS Release v0.65.0 Jul 12, 2016
CHANGELOG.md Release v0.68.1 Aug 24, 2016
CONTRIBUTING.md refactor(jscs): port jscs to eslint (#3946) r=vladikoff Jul 21, 2016
Dockerfile feat(docker): Dockerfile and README update for basic docker developme… Feb 18, 2015
Gruntfile.js chore(build): Include license header at the top of minified main.js Jul 1, 2015
LICENSE Add MPL 2.0 license file. Aug 18, 2014
README.md chore(dev): add remote development script and docs (#3971) r=pdehaan,… Jul 26, 2016
bower.json refactor(devices): remove timeago, use device last active from the fx… Aug 17, 2016
npm-shrinkwrap.json refactor(l10n): use shared source for l10n list (#4050), r=@vbudhram Aug 16, 2016
package.json Release v0.68.1 Aug 24, 2016

README.md

Firefox Accounts Content Server

Build Status: Travis Coverage Status

Static server that hosts Firefox Account sign up, sign in, email verification, etc. flows.

Quick Start

Clone the repository, make sure you have required prerequisites installed. Run npm install and npm run start-remote. This will start a local fxa-content-server on http://127.0.0.1:3030 that works with remote Firefox Accounts servers.

If you want to install all Firefox Accounts servers locally follow the instructions on: fxa-local-dev to get a full development setup running. Please note that fxa-local-dev is the preferred way of contributing to Firefox Accounts.

Development Notes

Changes to stylesheets

To have the css resources automatically rebuilt after changes, run grunt sass watch. Now whenever a change is made to the .scss files, the corresponding css resources will be rebuilt.

Changes to scripts and templates

Any changes made to the scripts or the template files will automatically be reflected on page refresh.

Testing

Prerequisites:

Setup

  • Run Selenium Server

e.g. in shell form:

java -jar selenium-server-standalone-2.53.0.jar 

To run tests locally with Selenium:

npm test

To change the default auth server edit server/config/*.json on your deployed instance.

{
  "fxaccount_url": "http://your.auth.server.here.org"
}

Note that testing with Selenium via Docker does not work at present, so all testing must be carried out via your normal operating system's npm & Java tooling.

Grunt Commands

Grunt is used to run common tasks to build, test, and run local servers.

TASK DESCRIPTION
grunt build build production resources. See task source for more documentation
grunt clean remove any built production resources.
grunt lint run ESLint, Sass-lint, amdcheck and JSONLint on client side and testing JavaScript.
grunt sass watch rebuild css resources automatically when changes are made to the .scss files (file needs to be saved).
grunt server run a local server running on port 3030 with development resources.
grunt server:dist run a local server running on port 3030 with production resources. Production resources will be built as part of the task.
grunt test run local Intern tests.
grunt version stamp a new minor version. Updates the version number and creates a new CHANGELOG.md.
grunt version:patch stamp a new patch version. Updates the version number and creates a new CHANGELOG.md.

Servers

License

MPL 2.0