Skip to main content
Fragments Cloud

Connect

Install the GitHub App on the repository, pick the manifest's FCID to pin, and Cloud installs fragments/contract-compliance as a check. Make it required on the protected branch. That is the gate.

  1. Create a workspace

    Fragments Cloud is invite-only for now — Get early access and we will email you when a spot opens. Once you are in, name your workspace; the wizard saves progress, including after the GitHub redirect.

  2. Install the GitHub App

    The wizard installs the Fragments GitHub App on your account or organization — or authorizes an installation that already exists. Grant the App access to the repository you want bound and select it. That repository is the binding.

  3. Pin the FCID

    Commit fragments.manifest.json from discover, then pin that file's FCID in Cloud. Every later verdict cites this pin. A pull request evaluated against a different FCID is indeterminate, not a pass.

  4. Require the check

    Cloud installs fragments/contract-compliance. In GitHub branch protection, mark that check required on the protected branch. Merges without a passing verdict or an exception are recorded as bypasses.

The loop on every save is local and does not need this binding. Connect when you want the same contract required to merge. Walkthrough from a fresh repo: the loop in five minutes.

Next steps

ContractWhat the pinned FCID contains and which rules it arms.Verdicts and receiptsWhat the check reports, and what the details link opens.The loopinit and discover before you connect.