Extensions Developer Rig
The Developer Rig allows Extensions developers to develop and test Extensions quickly, easily, and locally. It is an Electron-wrapped web app that you install on your machine. It lets you test with production APIs and hosted assets on Twitch
The Developer Rig also can be used to manage your Bits product catalog, if you have completed Extensions monetization developer onboarding (required for non-Twitch partners/affiliates) and your extension is enabled for Bits monetization. See Bits in Extensions Guide.
If your extension is enabled for Bits monetization, when you configure the Developer Rig to run with your extension, you will see a Manage Products tab. Here, you can view, create, edit, and deprecate products — as long as your extension is enabled for Bits and you are logged in to the account that owns your extension.
The Developer Rig is supported on Windows and MacOS.
Starting Up the Rig
To get the Developer Rig:
- Download and extract the Zip file.
- Set up for the script to run:
- On Windows, go to Settings > Update & Security > For developers. Select Developer Mode.
- On MacOS, go to System Preferences > Security & Privacy > General. Under Allow apps downloaded from, select App Store and identified developers.
- In the
scriptsfolder, run (double click) the
configure.cmd(Windows) file. This script installs and configures all dependencies for the rig. As part of this process, you will need to provide your computer login credentials, since you are creating a certificate.
After installing the rig, you can launch it by either:
- Executing the
runscript in the rig’s
- Navigating to the root of the rig’s folder and typing
yarn startin your command line.
Then sign in with your Twitch credentials.
Creating a Project
From the rig, select Select an Extension Project > Create New Project.
At the center of the Developer Rig is your extension project, a combination of the extension code and the extension manifest (metadata needed to run the code on Twitch or in the rig). When you start the rig for the first time, you’ll need to create your first project.
To create an extension project:
- Add your extension information, to use an extension manifest already created on your Twitch developer dashboard. Enter the clientId (copy this from your Extensions overview page), secret (copy this from Settings > Secret Keys for your extension), and extension version number (the default is 0.0.1).
- Specify the root Project Folder for project files.
- Under Add Code to Project, indicate how you want to add the initial code: None (the rig creates just a project folder, no code) or Use Existing Sample Template (full code samples provided by Twitch, with front-end and, in some cases, back-end parts). If you choose to use an existing template, select a template.
- Click Save or Cancel.
Other Rig Functionality
The rig has several tabs to assist your development process and run your project:
|Tab||This is where you ...|
Run your project (following the steps on the page), manage project metadata, and run the commands to host your front- and back-end files.
Also, click here to refresh your extension project, if you change your extension manifest (and it was created on the Twitch dev site, not locally).
|Configuration Service||Access and manage extension configuration data, for use by the Configuration Service.|
Create and interact with different views of your extension, for testing. Select among these Extension Types:
To add a new view for the configured client ID, click the + button. To delete a view, click the X on the view.
Depending on the selected type, you also select one or more Viewer Types:
|Manage Bits Product||
Integrate Bits into your extension. Before this tab is available for use, you must complete Extensions monetization onboarding and include Bits monetization in your extension (see Bits in Extensions Guide).
I get an error when pulling in the example project
Ensure that Git is in your PATH variables by trying to run
git at your command line. If that works, also ensure that the local folder does not currently exist.
I’m sure my Developer Rig configuration is correct, but my extension doesn’t work
Clear your browser cache and local storage and restart the Developer Rig.
localStorage.clear(); then refresh.
Ensure you’ve included the Twitch Extensions Helper in your front-end files.