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.
You use the Developer Rig to create and run an extension project, using either your own extension code or example templates in the rig. An extension project is a combination of an extension manifest (metadata) and extension code. You create an extension manifest in the rig or on the Extensions developer console, and you can make this part of your extension project in the rig.
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 the Extensions Monetization 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, MacOS, and Linux.
Starting Up the Rig
Creating a Project
- On the Welcome screen, after logging in, click Add Project (top left), then Create Project. The first Create New Project setup screen appears.
- Fill out the fields:
- In the dropdown list, select New Extension (to create a new extension) or an extension you’ve already created.
- Give your project a name
- Specify the extension version. The default is 0.0.1.
- Click Next. The second Create New Project setup screen appears.
- Fill out the fields:
- Select a folder on your filesystem for your project files.
- In the dropdown, choose the code to add to your project: tutorials (recommended for new developers), boilerplate (great if you want your frontend to be in React), or your own code. If you choose tutorials, you can open the corresponding instructions from the list.
- Click Next. The code is pulled in and a final Create New Project setup screen appears, indicating your project was created.
- To proceed, click Get Started. The Project Details page appears; see below for details.
The rig has several tabbed pages to assist your development process and run your project.
|Tab||This is where you ...|
Manage project metadata, run your project (following the steps on the page), and provide information about your front and backend files. If you chose tutorial code above, some information here is automatically populated for you.
The rig can host your frontend files and your extension backend if it’s running locally. To do this, click Host with Rig under Front-end Host Command and/or click Activate under Run your back-end service locally with the Developer Rig.
Use the Project Actions menu (top right) to:
|Monetization||Monetize your extension. Before this tab is available for use, you must complete Extensions monetization onboarding and include monetization in your extension (see the Extensions Monetization Guide).|
Access and manage extension configuration data, for use by the Configuration Service.
You can select what user data you want to query for, by entering the ID or channel name. You can also edit this data from the rig and save it back up to the configuration service, for quick changes to the data.
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 Create New View. Then, depending on the selected extension type, you also select one or more Viewer Types, to simulate how the extension will look to different people:
I get an error when pulling in a tutorial or boilerplate
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.