Use a factory template from Explore
Create a factory from a ready-made template, connect what it needs and turn it on when you're ready.
On this page
The fastest way to get a working factory is to start from a template. A template includes a workflow, triggers and guardrails that already work together. You can change any of it after installing.
Pick a template
Duun’s own templates cover the most common jobs:
| Template | What it does |
|---|---|
| Ship features | Issue in Ready → plan, approve, build, test, review, merge |
| Fix bugs from Sentry | New Sentry issue → reproduce, fix with a regression test, draft PR |
| Dependency upgrades | Weekly: group upgrades, fix breakages, merge when green |
| Docs & changelog | Friday: gather merged PRs, draft docs and changelog, ask for review |
You’ll find more from other teams in Explore under Factories.
Install the template
- Open Explore in the sidebar and choose Factories. Or press G then E.
- Select a template to open its details. The preview shows the workflow’s steps, triggers and guardrails.
- Read Before you install. Requires lists the integrations, secrets and runtimes it needs; Can access lists what it’s allowed to do, such as “Opens pull requests in repos you pick”.
- Select Use template.
- Under Where, name the factory and choose its project.
- Under Set up, connect anything missing and add any secrets it asks for. Optional integrations can be skipped.
- Under Review, check what will be created, then select Install. The factory is created paused, so nothing starts until you’re ready.
Turn it on
- Open the new factory from Factories in the sidebar.
- Open the Repos tab and check the repositories it will open pull requests in.
- Open the Workflows tab and select Test to try it on a sample issue. A dry run costs nothing; see Test a workflow.
- Select Resume when you’re happy with the result. From now on, its triggers start runs.
Staying up to date
When the template’s author publishes a new version, your factory shows Update available in Explore → Your library. Updating is your choice; see Update or uninstall.
If something goes wrong
- “Only admins can install factories”. Ask an Admin to install it, or to give you the right role.
- A requirement shows “Not connected”. Connect it from the install dialog, or later in Settings → Integrations & MCP.
- The name is taken. Duun adds
-2to clashing names. Rename the factory afterwards from its menu.
Developers can read what a factory is made of in Factories.