When you mention a 3rd party API in your spec, CodeSpeak will detect it and give you instructions to

• retrieve all necessary access tokens and configuration
• provide them to CodeSpeak to set up a testing environment
• configure your application to use them

This workflow requires manual steps from you, and though we try to simplify it as much as possible, you’ll need to carefully follow the instructions CodeSpeak gives you.

Example: Google Social Login in the Todo App

In this example, we take the Todoer spec from the Quick Start Guide, and add social login with Google:

### Users and permissions

- users can sign in with Google (no email/password sign in)
- every user sees only their own todo items

• Full spec

When you commit this change to the spec, the build will fail because it can’t proceed without credentials for Google login:

Note the instructions at the top of the page. The point is:

• you need to create an .env.local file on your machine (it will be needed once now, and once more later to run your app),
• copy the template that CodeSpeak provides to this file,
• follow the instructions in the comments in the template to obtain all the necessary configuration parameters and put them into the file instead of placeholders.

This is an example template instructing you how to create Google OAuth Credentials:

• .env.local

When you complete the instructions and fill out the template, create a GitHub Actions secret named CODESPEAK_ENV_LOCAL_FILE in your repo (use a shortcut link in the README.md if you like) with the entire .env.local text as its value:

Make sure the secret is saved successfully: