Dev Testing

Below are ways to locally evaluate how the system works with external resources.
These assume you're running a local dev server using bin/run-dev.
Many of these will assume you have the referenced host name in your /etc/hosts file and any browser proxies turned off as it blocks the /etc/hosts routes.


We run a local fake OIDC that you can use to log in with fake credentials.
  1. 1.
    Click the Log In button
  2. 2.
    Enter any username and password to make a new account or re-use a previous one, then click Sign In
  3. 3.
    Click Continue on the scopes Authorization page
You should now be logged in as a named Applicant. You can re-login as that applicant to see previous submissions and otherwise exercise flow that require a non-guest applicant.


Sent emails can be viewed at:
To view the output nicer you can use the JSON Formatter extension

File Upload

Make sure to add localstack and azurite to /etc/hosts prior to trying file upload within the dev stack. See these docs for details.


Known issue: AWS-based file uploads which use localstack only really work with empty PNG files due to Until this is fixed, generate an empty PNG file on your machine and use this to upload:
touch emptyfile.png


No extra configuration required.