Lando integration

You can take screenshots from your local Lando-powered website and upload them to Diffy. For this, you need a few steps.

Snippet to your .lando.yml file

The snippet to add is:

services:
  diffy:
    type: compose
    webroot: .
    build:
      - rm -rf /app/.diffy-worker
      - mkdir -p /app/.diffy-worker
      - cd /app/.diffy-worker && wget -qO- https://github.com/DiffyWebsite/diffy-worker/archive/refs/heads/main.tar.gz | tar xz --strip-components=1
      - cd /app/.diffy-worker && npm install
    services:
      image: diffywebsite2/screenshot-worker:0.0.2
      command: app
tooling:
  screenshot:
    service: diffy
    cmd: cd .diffy-worker && node diffy-screenshots --url=https://diffy-marketing.lndo.site --screenshot-name=lando

This will add a container diffywebsite2/screenshot-worker:0.0.2 to your setup and download the worker code to .diffy-worker directory.

Pay attention that you need to replace diffy-marketing.lndo.site with whatever you local environment URL is. Also if you like you can name your screenshots somehow differently than just lando.

Provide API Key and Project ID to .env file

Inside of .diffy-worker directory, you need to create a .env file (copy it from .env.example) and provide DIFFY_API_KEY and DIFFY_PROJECT_ID. These are to be obtained from the Diffy application. You can generate the API Key on the Keys page.

Run screenshots

To run the screenshots you can call

land screenshot

This will take screenshots and upload them to Diffy.

Here is a video walkthrough of setting up a project and taking screenshots from your Lando site