# RelativeCI

> Catch bundle regressions before merge, not in production. Automated bundle analysis, reviews, and monitoring for webpack, rspack, Vite, and Rollup projects.

RelativeCI integrates with your CI pipeline to collect the project's bundle stats, compare them against a baseline job, and surface regressions as GitHub checks, commit statuses, pull request comments, and Slack notifications. You can use the historical data to discover trends, track progress over time, and address slow, creeping bundle size regressions or prioritize performance improvements.

It is built on top of [bundle-stats](https://github.com/relative-ci/bundle-stats), an open-source bundle analyzer.

## Setup

- [Getting Started](https://relative-ci.com/documentation/setup): Step-by-step setup guide
- [Install GitHub App](https://relative-ci.com/documentation/setup/install-github-application): Install and configure the RelativeCI GitHub App for personal, organization, or enterprise accounts
- [Setup Project](https://relative-ci.com/documentation/setup/project): Create a new RelativeCI organization or project by connecting a GitHub repository
- [Send Data – Agent](https://relative-ci.com/documentation/setup/agent): Configure the agent to collect and send bundle stats (GitHub Action, CLI, webpack plugin, Rollup plugin)
- [GitHub Action agent](https://relative-ci.com/documentation/setup/agent/github-action): Set up `relative-ci/agent-action` for push, pull_request, and workflow_run events, including fork support and monorepo setups
- [CLI agent](https://relative-ci.com/documentation/setup/agent/cli): Set up `@relative-ci/cli` for advanced two-step CI configurations
- [Webpack plugin agent](https://relative-ci.com/documentation/setup/agent/webpack-plugin): Set up `@relative-ci/webpack-plugin` for webpack, rspack, Next.js, Gatsby, and Create React App
- [Rollup plugin agent](https://relative-ci.com/documentation/setup/agent/rollup-plugin): Set up `@relative-ci/rollup-plugin` for Vite, Rollup, and Rolldown
- [Agent build information](https://relative-ci.com/documentation/setup/agent/build-information): Environment variables collected by the agent and how to configure unsupported CI services
- [Configure Project](https://relative-ci.com/documentation/setup/configure): Configure project integrations and invite team members
- [GitHub Check report](https://relative-ci.com/documentation/setup/configure/integrations/github-check-report): Add a detailed bundle analysis report as a GitHub Check with rule-based conclusions
- [GitHub Commit Status review](https://relative-ci.com/documentation/setup/configure/integrations/github-commit-status-review): Set pass/fail/pending commit statuses based on configurable bundle metric rules
- [GitHub Pull Request comment](https://relative-ci.com/documentation/setup/configure/integrations/github-pull-request-comment): Post a bundle size comparison summary on pull requests
- [Slack notification](https://relative-ci.com/documentation/setup/configure/integrations/slack-notification): Send bundle analysis notifications to a Slack channel with optional rules
- [Metrics forwarding – InfluxDB](https://relative-ci.com/documentation/setup/configure/integrations/metrics-forwarding-influxdb): Forward bundle metrics to InfluxDB for custom dashboards and alerts
- [GitHub Enterprise Server](https://relative-ci.com/documentation/setup/enterprise/create-github-application): Create a custom GitHub App for GitHub Enterprise Server

## Guides

- [Output Bundle Stats](https://relative-ci.com/documentation/guides/bundle-stats): How to output the webpack-compatible stats JSON file
- [Output bundle stats – webpack CLI](https://relative-ci.com/documentation/guides/bundle-stats/webpack-cli-webpack-stats): Generate stats with `webpack --json`
- [Output bundle stats – rspack](https://relative-ci.com/documentation/guides/bundle-stats/rspack-webpack-stats): Generate stats with `rspack --json`
- [Output bundle stats – webpack-stats-plugin](https://relative-ci.com/documentation/guides/bundle-stats/webpack-stats-plugin): Generate stats with `webpack-stats-plugin`
- [Output bundle stats – Vite](https://relative-ci.com/documentation/guides/bundle-stats/vite): Generate stats with `rollup-plugin-webpack-stats`
- [Output bundle stats – Next.js](https://relative-ci.com/documentation/guides/bundle-stats/nextjs-webpack-stats): Generate stats in Next.js (webpack and Turbopack)
- [Output bundle stats – Gatsby](https://relative-ci.com/documentation/guides/bundle-stats/gatsby-webpack-stats): Generate stats in Gatsby
- [Output bundle stats – Create React App](https://relative-ci.com/documentation/guides/bundle-stats/create-react-app-webpack-stats): Generate stats with `react-scripts build --stats`
- [Webpack config for better monitoring](https://relative-ci.com/documentation/guides/webpack-config): Content hashes, named async chunks, deterministic chunk IDs
- [Vite config for better monitoring](https://relative-ci.com/documentation/guides/vite-config): File name patterns and unique async chunk names for Vite/Rollup
- [Identify and fix npm duplicate dependencies](https://relative-ci.com/documentation/guides/identify-and-fix-bundle-npm-duplicate-dependencies): Find and resolve duplicate packages using npm dedupe, overrides, or webpack aliases
- [Compare and analyze bundle changes locally](https://relative-ci.com/documentation/guides/analyze-and-compare-webpack-bundle-changes-locally): Use the `bundle-stats` CLI to diff builds on your local machine

## Reference

- [Metrics and Data](https://relative-ci.com/documentation/metrics-and-data): All bundle analyzer metrics for assets, modules, and packages, including definitions, units, and change directionality
- [Examples](https://relative-ci.com/documentation/examples): Agent setup examples for various bundlers, frameworks, and CI services
- [FAQ](https://relative-ci.com/faq): Frequently asked questions about setup, security, agent, usage, and pricing
- [Releases](https://relative-ci.com/releases): Release notes and changelog

## Pricing

- [Pricing](https://relative-ci.com/pricing): Free plans for developers, paid plans for teams and enterprises. Always free for open source.

## Open Source

- [bundle-stats](https://github.com/relative-ci/bundle-stats): Open-source webpack/rspack/Vite/Rollup bundle analyzer
- [agent](https://github.com/relative-ci/agent): RelativeCI agent packages (CLI, webpack plugin, Rollup plugin, GitHub Action)
- [rollup-plugin-webpack-stats](https://github.com/relative-ci/rollup-plugin-webpack-stats): Rollup/Vite plugin to output webpack-compatible stats JSON
- [rollup-plugin-stats](https://github.com/relative-ci/rollup-plugin-stats): Rollup/Vite plugin to output bundle stats JSON

Last update: June, 10th 2026