3-minute CI quickstart.

Drop .github/workflows/nifler-gate.yml into your repository—zero SDKs in your application code and zero source-code access required.

Get API token
.github/workflows/nifler-gate.yml
name: Nifler Release Gate

on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  release-gate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - name: Run Nifler Release Gate
        env:
          NIFLER_API_TOKEN: ${{ secrets.NIFLER_API_TOKEN }}
          PREVIEW_URL: ${{ vars.PREVIEW_URL }}
          COMMIT_SHA: ${{ github.sha }}
          PR_NUMBER: ${{ github.event.pull_request.number }}
        run: |
          set -euo pipefail

          if [ -z "${PREVIEW_URL:-}" ]; then
            echo "::error::Set PREVIEW_URL to your deployed preview or staging URL."
            exit 1
          fi

          PAYLOAD=$(jq -n \
            --arg url "$PREVIEW_URL" \
            --arg sha "$COMMIT_SHA" \
            --arg pr "$PR_NUMBER" \
            '{target_url: $url, async_run: true, commit_sha: $sha, pr_id: $pr, environment: "preview"}')

          DISPATCH=$(curl -s --max-time 15 -X POST "https://api.nifler.io/api/simulations" \
            -H "Authorization: Bearer $NIFLER_API_TOKEN" \
            -H "Content-Type: application/json" \
            -d "$PAYLOAD")

          RUN_ID=$(echo "$DISPATCH" | jq -r '.run_id // empty')
          if [ -z "$RUN_ID" ]; then
            echo "::error::Failed to start Nifler release gate: $DISPATCH"
            exit 1
          fi

          STATUS="running"
          for i in {1..60}; do
            POLL=$(curl -s --max-time 15 "https://api.nifler.io/api/runs/$RUN_ID" \
              -H "Authorization: Bearer $NIFLER_API_TOKEN" || true)
            if [ -n "$POLL" ]; then
              STATUS=$(echo "$POLL" | jq -r '.status // "running"' 2>/dev/null || echo "running")
            fi
            [[ "$STATUS" =~ ^(completed|failed|unreachable|error)$ ]] && break
            sleep 3
          done

          if [[ "$STATUS" == "unreachable" ]]; then
            echo "::error::Preview unreachable (0 credits billed under Fair-Billing Guarantee)."
            exit 1
          fi
          if [[ "$STATUS" != "completed" ]]; then
            echo "::error::Release gate did not complete cleanly (status: $STATUS)."
            exit 1
          fi

          GATE=$(curl -s --max-time 15 -X POST "https://api.nifler.io/api/merge-gate/check" \
            -H "Authorization: Bearer $NIFLER_API_TOKEN" \
            -H "Content-Type: application/json" \
            -d "$(jq -n --arg run "$RUN_ID" --arg pr "$PR_NUMBER" '{run_id: $run, pr_id: $pr}')")

          BLOCKED=$(echo "$GATE" | jq -r '.blocked // "unknown"')
          if [ "$BLOCKED" = "true" ]; then
            echo "$GATE" | jq -r '.findings[]? | "[\(.severity)] \(.finding_type): \(.message)"'
            echo "::error::Nifler held merge due to live runtime regressions."
            exit 1
          elif [ "$BLOCKED" != "false" ]; then
            echo "::error::Unexpected merge-gate response (failing closed): $GATE"
            exit 1
          fi

How multi-account & ticket checks connect

Add two non-production staging test roles in your Nifler workspace vault to verify Org A vs. Org B isolation, and connect Linear, Jira, or GitHub Issues via OAuth to match PRs against ticket acceptance rules.

0-credit pre-flight & 24h fix re-test

If a preview build fails or is unreachable on pre-flight, 0 credits are charged. When Nifler holds a pull request, pushing a fix within 24 hours re-verifies for 0 credits.

Fail-closed privacy & isolation

Sensitive tokens and personal fields are redacted automatically at the boundary, with private cloud clusters and offline lab runners available for enterprise teams.

Hardware stands & 100% air-gapped lab runner

Validating silicon boards, embedded firmware, or site gateways with zero outbound internet? Deploy the self-contained Nifler Lab Runner appliance on your bench host to correlate board reset states, register readouts, and local APIs with hardware safety limits locked.

Request offline lab bundle

Run your first 5 gates free.

Connect your preview environment in three minutes, or launch the interactive industrial fleet sandbox.

Start 5 free gatesBook 15-min call