<LEARN/>
← /paths/qa

<project · advanced>

Automated test suite

Add end-to-end and accessibility tests to an open source project.

Build automated test suite one manageable milestone at a time. Keep your decisions, tests and finished work together so your portfolio shows what you learned, not only the final result.

Build it step by step

  1. Pick a project and flow

    Choose an open-source app you can run locally and read its contribution guide. Select a small user flow and avoid running tests against the maintainer’s production data.

  2. Create stable fixtures

    Install Playwright, seed synthetic test data and isolate each run. Use role and label selectors and reset state so tests do not depend on execution order.

  3. Cover end-to-end behaviour

    Test success, validation errors and one recovery path. Wait for visible state rather than arbitrary delays and avoid putting credentials in committed scripts.

  4. Add accessibility checks

    Run axe-core at meaningful flow states and add manual keyboard assertions. Document the checks’ scope and limitations rather than treating them as complete accessibility certification.

  5. Run in continuous integration

    Configure GitHub Actions to run tests against the local app. Save traces on failure, verify a deliberate regression fails and prepare a focused pull request.

  6. Share your finished work

    Commit your source and a README explaining setup, decisions, tests and limitations. Remove secrets and personal data, credit dependencies and assets, then add the public repository or portfolio link and an optional working demo to LEARN Showcase. Hosting is optional; a clear repository or design case study is enough.

// done when

  • Tests pass from a fresh isolated state
  • A deliberate regression causes a failure
  • Accessibility checks cover meaningful states
  • CI runs without committed secrets
  • README includes setup, credits and limitations; shared links are safe and accessible

// stretch goals

  • Run a second browser
  • Add visual checks for critical elements

Finished? Show it off

Add your project to the LEARN showcase so other learners and employers can see it.

Sign in to add your finished project to the showcase.