Ghost Inspector Netlify Plugin

We’ve recently released a new plugin for Netlify that allows you to automatically run Ghost Inspector tests on every deploy, including deploy previews! By default, Netlify deploys your production branch on every change. To enable deploys for other branches, follow the Netlify instructions:

To generate branch deploys for other branches in your repository, select your site on the Sites page. Then go to Site settings > Build & deploy > Continuous Deployment > Deploy contexts, and select Edit settings. You can choose to deploy all branches (including future branches), or select individual branches you would like to deploy.

With branch deploys enabled, you can now run Ghost Inspector tests on your website before deploying to production!

Installation

You can install this plugin in the Netlify UI from this direct in-app installation link or from the Plugins directory.

File-based Installation

If you prefer to use file-based installation, you’ll need to add our plugin to your projects list of dependencies (devDependencies is fine). Our official Netlify plugin is available from npm, you can install it with the following command:

npm install --save-dev netlify-plugin-ghost-inspector

Next you will need to update your Netlify configuration file (netlify.toml) to reference our plugin, like so:

[[plugins]]
package = "netlify-plugin-ghost-inspector"

Netlify Environment Variables

Whether you chose UI or file-based installation, now you need your Ghost Inspector API key (found in your account settings) and the ID of the suite you want to run (found in the URL). You’ll need to add these to your Netlify deploy settings as environment variables. The Ghost Inspector API key and suite ID are required.

The GitHub API token is optional, but without it you will not see commit status changes on your PR — you will need to visit to the Netlify deploy log to see the result of the Ghost Inspector tests. With a GitHub API token, our plugin will automatically add a pending status before the tests start and a pass/fail status based on the results of the tests:

Add these environment variables and their values to the Netlify Dashboard via: Site Settings > Build & deploy > Environment.

With all three environment variables, you should see a new “check” on your GitHub pull requests. First it will show “pending” while the Ghost Inspector tests are running. Once they complete, it should update to either a pass or fail based on the results of the tests.

GitHub fail status

The icon will be the avatar of the account associated with your GitHub API token (usually your own). Clicking on “Details” will take you to the suite so you can review exactly what failed in your tests.

Pushing changes to the branch will trigger a Netlify deploy and cause the tests to run again. You can also manually run a deploy of the last commit via the Netlify interface.

You can even add this check to your merge requirements, so that all pull requests must pass your Ghost Inspector tests before being merged to your production branch!

Protected branches GitHub settings

If you’re interested in seeing exactly how the code works, or suggest an improvement, you can visit the public repository on GitHub.

Thanks to Jacob Arriola for the initial code and inspiration to make this plugin work.

Testing Before Releasing with Ghost Inspector and Netlify

Ghost Inspector Netlify Plugin

Ghost Inspector Netlify Plugin We’ve recently released a new plugin for Netlify that allows you to automatically run Ghost Inspector tests on every deploy, including deploy previews! By default, Netlify deploys your production branch on every change. To enable deploys for other branches, follow the Netlify instructions: To generate branch deploys for other branches in […]

Webinar: Accessibility & Automated Testing for GAAD 2021

Automated Accessibility Testing

This webinar took place on May 20th, 2021. Watch the full video recording below. May 20th, 2021 marks the 10th annual Global Accessibility Awareness Day (GAAD). According to the team at GAAD an estimated 1 billion people worldwide have disabilities. Common disabilities include hearing, cognitive, visual, and motor. The web is an essential resource in many aspects […]

Test Management with QADeputy & Ghost Inspector

Test Management with QADeputy & Ghost Inspector

Quality assurance is a broad initiative. Ghost Inspector strives to be an all-in-one tool when it comes to browser automation. However, QA testing teams often use a range of products to cover all their testing needs, like API testing and load testing. This can lead to testing-related data being scattered in various places. QADeputy is a […]

Browser & System Updates — July 2019

Browser & System Updates

These updates will be deployed at 10:00am Pacific Time on Tuesday July 16th, 2019 Here at Ghost Inspector, we’re continually rolling out new browser versions and automation logic updates. However, this month we’ve got a number of big changes launching at once and I wanted to discuss each in a little more detail. Here’s a […]

Continuous Integration Testing for WordPress

Continuous Integration Testing for WordPress

While continuous integration is a common practice for most development teams, the stateful nature of WordPress makes it difficult, but not impossible, to setup. For our open source WordPress plugin, we wanted to integrate our standard build and test process for every pull request using CircleCI. While it might be easier to setup a permanent staging environment, […]

Automated UI Testing for WordPress

Automated UI Testing for WordPress

Many people don’t test their WordPress websites, and it’s a problem. While the core of WordPress is fairly well-tested by its creators, users, and the open-source community, the same cannot be said for every plugin and theme. There’s an infinite combination of versions, hosting environments, plugins, themes, and configurations. You can’t trust the community to […]

Ghost Inspector’s New WordPress Plugin

Ghost Inspector’s New WordPress Plugin

Ghost Inspector is an automated browser testing tool for continously monitoring websites. Many of those websites run on WordPress. After lots of demand from our users, we’ve built a plugin to show your Ghost Inspector test results right inside your WordPress admin panel. The plugin enables you to display the latest test results for a […]

Develop a WordPress Plugin Using Webpack and React

Develop a WordPress Plugin Using Webpack and React

Ghost Inspector is an automated browser testing tool for continuously monitoring websites. We recently released our WordPress plugin to show test results inside your WordPress admin dashboard. In this tutorial, you will learn how to build your own plugin using React, Webpack, and the Ghost Inspector API. You can view the final source code on GitHub. Why Use […]

Headless Browsers and Testing at Scale

Headless Browsers and Testing at Scale

The Ghost Inspector team got together for our annual company offsite in Austin, TX this year. We always plan our offsite around presenting at an industry-related event. This year we were thrilled to present to the Austin Automation Professionals Meetup on the topic of headless browsers and testing at scale. A big thank you to Handsome for hosting the […]

Deploy and Test Your App using VSTS, Azure, and Ghost Inspector

Deploy and Test Your App using VSTS, Azure, and Ghost Inspector

Visual Studio Team Services is a one-stop-shop for managing source code, custom packages, agile workflow, and continuous integration. Having recently released our VSTS extension for Ghost Inspector I thought it would be a fun idea to test and deploy an app with a Microsoft toolchain, namely Visual Studio Team Services, Microsoft Azure, and Ghost Inspector using our new extension. […]