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:

TemplateWhat it does
Ship featuresIssue in Ready → plan, approve, build, test, review, merge
Fix bugs from SentryNew Sentry issue → reproduce, fix with a regression test, draft PR
Dependency upgradesWeekly: group upgrades, fix breakages, merge when green
Docs & changelogFriday: gather merged PRs, draft docs and changelog, ask for review

You’ll find more from other teams in Explore under Factories.

Install the template

  1. Open Explore in the sidebar and choose Factories. Or press G then E.
  2. Select a template to open its details. The preview shows the workflow’s steps, triggers and guardrails.
  3. 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”.
  4. Select Use template.
  5. Under Where, name the factory and choose its project.
  6. Under Set up, connect anything missing and add any secrets it asks for. Optional integrations can be skipped.
  7. 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

  1. Open the new factory from Factories in the sidebar.
  2. Open the Repos tab and check the repositories it will open pull requests in.
  3. Open the Workflows tab and select Test to try it on a sample issue. A dry run costs nothing; see Test a workflow.
  4. 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 -2 to clashing names. Rename the factory afterwards from its menu.

Developers can read what a factory is made of in Factories.

    Type to search the docs, help center and blog.