What are Custom Workflows?
Custom Workflows enable you to run scheduled tasks and automated checks across all or a selection of repositories in your organization. This powerful feature extends beyond traditional CI/CD by creating an avenue to proactively monitor and automate compliance checking, ensuring your organization's standards are maintained consistently.
Custom Workflows are scheduled automation that run independently of your CI/CD pipelines. Unlike traditional workflows that only trigger when code changes, Custom Workflows run on your schedule—whether that's daily, weekly, or at any interval you define. This is especially valuable for repositories that are rarely updated but still need regular monitoring for security vulnerabilities, compliance checks, or organizational standards.
Real-World Value
Some companies have repositories that don't have CI pipelines, or changes are so infrequent that security data would be seriously out of date. For example, running a security audit daily gives you peace of mind in a repository you haven't touched in 6 months—just because you didn't make a code change doesn't mean it's not vulnerable to newly discovered threats.
Key Use Cases
- Security monitoring: Run
npm audit
or third-party security tools on regular intervals to detect vulnerabilities - Compliance tracking: Ensure all repositories meet organizational standards for linting, testing, or documentation
- Dependency management: Track library versions and identify outdated dependencies across your organization
- Data collection: Gather metrics and insights from repositories that rarely see code changes
- Proactive maintenance: Identify technical debt and maintenance issues before they become critical
Custom Workflows are available as part of Nx Enterprise and consume compute credits. Reach out to learn more about Nx Enterprise
Access Custom Workflows
Navigate to your organization's Custom Workflows page in Nx Cloud. You'll see an overview of all the current workflows. Polygraph and Conformance based workflows are currently available. In a future release of Nx Cloud, custom workflow creation will be released.
Apply a workflow
Polygraph workflows are designed to grab the latest graph information from Nx to keep the Workspace graph up to date for your organization.
- Click Polygraph or Conformance for your repeating workflows provided by Nx Cloud
- if using Conformance action, then make sure you've already configured and published a conformance rule
- Click Apply workflow and select the workspace you wish to use for the custom workflow.
Configure Workflow Settings
In the custom workflows overview, select the Launch Templates tab, and assign the launch template you wish to use for the given workspace.
You can also upload your own custom launch template by clicking Configure templates. Read more about custom launch templates
Perform First run
Back in the custom workflow action page, you can manually trigger a run via clicking Force
Once your workflow has run, you can view its most recent execution via clicking View Latest Execution. If you've used with Nx Agents, then this interface will be familiar. The execution shows each step taken by the workflow and the logs associated with each step.