Performance Comparison Tool

PerfCompare is hosted on Netlify, and is updated every time commits are pushed to the following branches:

More information about our deployment process

• git
• nodejs

# Clone the repo
git clone https://github.com/mozilla/perfcompare.git
cd perfcompare

# Install node modules
npm install

# Runs on localhost:3000 by default
npm run dev

We welcome contributions to our project.

If you find an issue that you'd like to work on that is not assigned to anyone, leave a comment on the issue and request that it be assigned to you.

If you do not receive a response within 2-3 days, you can follow up in the #PerfCompare matrix channel.

After addressing the issue, ensure both tests and linting pass before submitting a pull request.

When submitting a pull request, please mention the issue number to link the pull request and issue to one another. You can do this by typing # following immediately by the issue number, i.e., #123

Submit your pull requests to the staging branch.

Submit your pull requests to the beta branch.

We recommend the following workflow to contribute to PerfCompare:

1. Set an upstream remote that points to the project repository, and an 'origin' remote that points to your fork.
2. To keep your fork up-to-date, use git rebase upstream rather than merging. This causes fewer merge conflicts and keeps the git history cleaner.

# Git commands for keeping your branch up to date with the lastest master
git fetch upstream
git rebase upstream/master
git push --force origin <local branch>

The following command will run nearly all the checks we have:

npm run test-all

It's handy to run before pushing your code to a pull request, so that you're sure that it obeys the rules we have in place.

The following command:

npm run fix-all

will automatically fix some of the errors.

If you want to run just specific tests, please read below.

We run our JavaScript code in the frontend through ESLint to ensure that new code has a consistent style and doesn't suffer from common errors.

# To run ESLint by itself, you may run the lint task:
npm run lint

# Automatically fix linting issues found (where possible):
npm run lint:fix

# Checking formatting issues with Prettier:
npm run format:check

# Automatically fix format issues found (where possible):
npm run format

ESLint and Prettier are usually integrated within your code editor and should run automatically when you edit a file.

Tests can be run with the following commands:

npm run test

# Run tests and watch for changes
npm run test:watch

# Run tests with coverage
npm run test:coverage

When making changes to the UI, snapshots should also be updated to match. Snapshot tests ensure no UI changes occur unexpectedly.

After manually verifying the UI renders as intended, run the following command to update snapshots: npm run test:update

Snapshot files should be included in your pull request(s).

You can submit feedback by filing a bug on Bugzilla, on the component Testing::PerfCompare. You can also find us on Element (ex-Matrix) on the #perfcompare or #perfcompare-user-research channels, as well as on Slack on the #perfcompare channel.