Firefox Accounts Content Server
JavaScript HTML CSS Shell
Switch branches/tags
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.circleci fix(ci): fix circle ci warning about 'env' (#6441) r=@shane-tomlinson Aug 13, 2018
app fix(recovery): use `enable` instead of `add` button (#6461) r=@shane-… Aug 16, 2018
docs chore(docs): Remove obsolete oauth-in-an-iframe docs. (#6041) r=@shan… Apr 11, 2018
grunttasks chore(deps): Remove grunt-contrib-watch (#6444) r=@vbudhram,@vladikoff Aug 13, 2018
locale refactor(deps): remove bower (#5915) r=@vbudhram Feb 15, 2018
scripts chore(install): Only clone the l10n repo if needed. (#6393) r=@vladikoff Jul 30, 2018
server fix(metrics): stop sending unused performance flow events Aug 16, 2018
tests fix(metrics): stop sending unused performance flow events Aug 16, 2018
.editorconfig feat(forms): replace our password advice with responsive message (#5940 Mar 3, 2018
.eslintignore refactor(deps): remove bower (#5915) r=@vbudhram Feb 15, 2018
.eslintrc feat(webpack): upgrade to webpack 4 r=@vladikoff Jul 25, 2018
.gitattributes Generated basic Yeoman project. Dec 4, 2013
.gitignore feat(css): build CSS using webpack instead of grunt-sass (#6351) r=@v… Jul 30, 2018
.htmllintrc chore(htmllint): add htmllint to repo Jul 13, 2015
.nsprc fix(config): Allow configuring statsd host (#6208) r=@vladikoff,@shan… May 17, 2018
.nvmrc chore(npm): update nvmrc to node 8 Apr 24, 2018
.sass-lint.yml feat(sass): SASS lint warnings are now errors. (#5700) r=@vladikoff Nov 10, 2017
.travis.yml fix(ci): clean up travis logs (#6119) Apr 25, 2018
AUTHORS Release v1.117.0 Jul 24, 2018
CHANGELOG.md Release v1.118.2 (#6450) Aug 13, 2018
CONTRIBUTING.md refactor(deps): remove bower (#5915) r=@vbudhram Feb 15, 2018
Dockerfile-build fix(docker): let's do only one npm version override Jun 13, 2018
Gruntfile.js chore(dependencies): upgrade away from deprecated mozlog usage (#5349)… Aug 11, 2017
LICENSE Add MPL 2.0 license file. Aug 18, 2014
README.md feat(css): build CSS using webpack instead of grunt-sass (#6351) r=@v… Jul 30, 2018
npm-shrinkwrap.json chore(deps): Remove grunt-contrib-watch (#6444) r=@vbudhram,@vladikoff Aug 13, 2018
package.json Merge pull request #6451 from mozilla/train-118 Aug 13, 2018
webpack.config.js feat(css): build CSS using webpack instead of grunt-sass (#6351) r=@v… Jul 30, 2018

README.md

Firefox Accounts Content Server

Build Status: Travis Build Status: Circle CI 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, scripts and templates

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


Testing

Prerequisites

Setup

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 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