useburrow/statamic-burrow

Connect your Statamic site to Burrow — event tracking for native forms, Cargo ecommerce, system snapshots, and operational visibility.

dev-main 2026-06-15 20:01 UTC

Requires

• php: ^8.2
• statamic/cms: ^5.0 || ^6.0
• useburrow/sdk-php: ^0.9.2

Requires (Dev)

• phpunit/phpunit: ^11.0

Suggests

• duncanmclean/cargo: Required for Cargo ecommerce tracking.

proprietary

• Burrow Analytics, LLC

• ecommerce
• analytics
• Forms
• cargo
• agency
• statamic
• orchestration
• operations
• burrow
• statamic-addon
• observability
• backfill
• event-tracking

README

Install an addon. See everything.

Burrow is the orchestration layer for agency operations. This addon connects your Statamic site to Burrow — detecting native forms and Cargo, syncing event data, publishing system snapshots, and giving your team operational visibility across every client project.

No webhook configurations in form plugins. No CSV imports. One addon, total visibility.

Supported integrations

Integration	What Burrow tracks
Statamic Forms	Form submissions, field mapping, per-form sync modes
Cargo	Orders, line items, ecommerce funnel events
Statamic	System snapshots — Statamic version, PHP version, installed addons

Control Panel flow

The addon setup is a multi-step wizard:

1. Connection — Save Burrow baseUrl and account apiKey, run SDK discovery
2. Project — Select the Burrow project/client to link
3. Integrations — Choose Statamic Forms and/or Cargo
4. Per-integration config — Form modes and Cargo tracking settings
5. Review — Sync form contracts, publish system snapshot
6. Finish — Mark onboarding complete

After onboarding:

• Dashboard — linked project, outbox stats, backfill controls, recent logs
• Outbox — pending/failed rows with retry/delete actions
• Setup — re-run the wizard

Installation

composer require useburrow/statamic-burrow

Add the path repository when developing locally:

{
  "repositories": [
    { "type": "path", "url": "path/to/statamic-burrow" }
  ]
}

Requirements

• Statamic 5.x or 6.x
• PHP 8.2+ (Statamic 6 sites require PHP 8.3+ per Statamic)
• Optional: Cargo for ecommerce tracking

Configuration

Environment variables:

Variable	Description
BURROW_BASE_URL	Burrow API endpoint
BURROW_API_KEY	Burrow account API key (onboarding only)
BURROW_PLUGIN_NAME	CP nav label (default: Burrow)

Runtime state (linked project, ingestion key, integrations, contracts) is stored in plugin database tables — not committed to project config.

Event model

• Forms: forms.submission.received (source: statamic-forms, formId: sf_{handle})
• Ecommerce: canonical ecommerce.* events via SDK (source: cargo)
• System: system.stack.snapshot, system.heartbeat.ping

Development

composer install
./vendor/bin/phpunit

About Burrow

Learn more at useburrow.com.