This article explains how Novus uses pull requests (PRs) to manage your tracking configuration and review code changes. Using automated PR workflows allows you to keep your tracking up to date while maintaining full control over your codebase.

When Novus creates a PR

Novus generates a PR when it needs to apply code changes to your repository. You can expect Novus to create a PR in the following scenarios:

• During initial setup: When you connect your repository, Novus scans your application to understand your framework and automatically generates an installation PR. Behind the scenes, Novus clones your code, adds the necessary configuration snippet or SDK, and pushes a ready-to-review branch to your repository.
• When your team updates code: If your developers open a new PR, Novus automatically reads the code differences in the background. It looks for new pages, features, or metadata, and updates your tracking artifacts to match the newest version of your app.
• When you request changes: If you use Novus to track a new event, configure an agent, or fix a detected issue, Novus writes the exact code required. It automatically creates a new branch, commits the changes, and opens a new PR for your team to review.
• Detected product issues: If Novus identifies a pattern that it believes is a product issue, then it will open a new PR to remediate the product issue and notify your team to review.

When Novus generates these changes, it creates a new branch and opens a PR targeting your default branch.

Human-approved PRs

Novus never merges code into your repository automatically. When Novus creates a PR, it requires human review and approval before any changes take effect.

You always retain full control over your codebase. You and your team can review the code, leave comments, make adjustments, and merge the PR using your standard development workflow. Novus tracks the status of the PR and updates your dashboard when the PR is closed or merged.

Additional PR functionality

Beyond creating PRs for code changes, Novus can monitor and analyze the PRs created by your development team. You can manage these automated workflows by going to Admin and updating your PR Settings.

• UX Review: When enabled, Novus analyzes code changes for user experience impact and leaves inline review comments directly on your PRs.
• Sync functionality: When enabled, Novus analyzes your code changes to detect updates to your tracked pages, features, and events. Novus automatically manages your configuration based on these changes.

You can view the status of all active and completed analyses by selecting PR Reviews from the left menu.