Skip to content

[Work in progress] Boilerplate repository aimed at helping developers kickstart automated testing projects using Cypress.

License

Notifications You must be signed in to change notification settings

ludovicobesana/CypressStarterKit

Repository files navigation

Cypress Starter Kit 🌿

Cypress Tests Cypress CI Badge

Overview

Cypress Starter Kit is a comprehensive boilerplate repository designed to help developers quickly set up an automated testing environment using Cypress and cypress-axe. It includes accessibility testing support, sensible defaults, and useful scripts to streamline testing workflows.

Features

  • Pre-configured Cypress environment with TypeScript
  • Accessibility testing with cypress-axe
  • Ready-to-use scripts for CI workflows
  • ESLint + TypeScript support

Installation

  1. Clone the repository:

    git clone https://github.com/your-username/CypressStarterKit.git
    cd cypress-starter-kit
  2. Install dependencies:

    npm install
  3. Open Cypress UI:

    npm run cypress:open

Usage

The repository includes several npm scripts for different testing scenarios:

  • npm run cypress:open: Launch Cypress in interactive mode
  • npm run cypress:run: Run all Cypress tests headlessly
  • npm run test: Alias for cypress run
  • npm run test:ally: Run accessibility tests only
  • npm run lint: Run ESLint on .ts and .js files
  • npm run type-check: Run TypeScript type checks
  • npm run clean:screenshots: Delete all screenshots in cypress/screenshots/

Configuration

For Cypress Cloud setup and advanced features, see CYPRESS_CLOUD_SETUP.md.

GitHub Actions & Artifacts

On every push or pull request to main, Cypress accessibility tests are run automatically via GitHub Actions.

  • All screenshots generated during the run are saved as a downloadable artifact named cypress-screenshots.

You can view the status badge at the top of this README and download artifacts from the Actions tab on GitHub.

Contributing

Contributions are welcome!

License

This project is licensed under the MIT License.

banner

About

[Work in progress] Boilerplate repository aimed at helping developers kickstart automated testing projects using Cypress.

Topics

Resources

License

Stars

Watchers

Forks