Pa11y Sidekick

This is a new project based around Pa11y, code-named "Sidekick". Pa11y Sidekick will be a modern and well thought out replacement for Pa11y Dashboard and Pa11y Webservice. What exactly is Pa11y Sidekick going to do? Still to be defined, but our rough proposal at this stage:

like Travis, but for a11y testing, and with graphs.

✨ Click here for the full proposal document, project roadmap, and FAQs ✨

---

The Architecture

We maintain an Architecture Guide which outlines how the application works, and how everything fits together. It's strongly recommended that you read through it if you want to contribute. We're currently in the architecture stage of development so this application has no features – it's purely a demo how how we want to build things.

If you have any feedback, we'd love to hear it! This architecture is not yet set in stone.

• Have an idea for a feature?
• Want to help out?
• Think we're doing this all wrong?

Raise an issue on this repo, or get in touch on Twitter (our DMs are open). Also, feel free to open a PR to suggest changes.

Running locally

This application requires Node.js 4+ and PostgreSQL.

1. Install dependencies:

   make install

2. Create a database (assumes you have the psql command on your path) and run migrations:

   make db-create db-migrate-up

3. Optionally seed the database with test data if you want to see all of the features more quickly:

   make db-seed

4. Start the application in either production mode:

   make start

   or development mode (with auto reloading):

   make start-dev

Configuration

Pa11y Sidekick is highly configurable. You can configure the application with the following environment variables:

• DATABASE: A PostgreSQL connection string, used to connect to the database.
  Default: postgres://localhost:5432/pa11y_sidekick,
  Aliases: DATABASE_URL.

• LOG_LEVEL: The lowest level of logs to output, one of error, warn, info, verbose, debug.
  Default: verbose in production and debug in development.

• NODE_ENV: The environment to run the application in, one of production, development, test.
  Default: development.

• PORT: The HTTP port to run the application on. If set to an empty string, a random port will be assigned.
  Default: 8080.

• REQUEST_LOG_FORMAT: The log format to use for request logging, one of morgan's predefined formats.
  Default: combined.

Pa11y Sidekick will first attempt to load an .env file in the root of the project and read configurations from there. You can copy the sample environment config as a starting point:

make config

Alternatively you can set environment variables before running your command. Here's an example:

LOG_LEVEL=debug PORT=1234 REQUEST_LOG_FORMAT=tiny make start

Contributing

To contribute to Pa11y Sidekick, clone this repo locally and commit your code on a new branch. It's useful to read the Architecture Guide before contributing.

Please write unit tests for your code, and check that everything works by running the following before opening a PR:

1. Create a test database (assumes you have the psql command on your path):

   make db-create-test

2. Run the following command to verify the code and run all of the tests:

   make ci

You can also run verifications and tests individually:

make verify              # Verify all of the code (JSHint/JSCS/Dustmite)
make test                # Run all tests
make test-unit           # Run the unit tests
make test-unit-coverage  # Run the unit tests with coverage
make test-integration    # Run the integration tests

Licence

Licensed under the Lesser General Public License (LGPL-3.0).
Copyright © 2016, Team Pa11y.