SkyBeam Deployment

Complete guide for deploying SkyBeam edge workers to Cloudflare. This guide covers Cloudflare account setup and one-click deployment through the Tandem Beam interface.

User Guide
UI-Based Deployment

Technical Requirements

  • Cloudflare account with Workers plan ($5/month minimum)
  • Cloudflare API token with Worker:Edit permissions
  • Domain configured in Cloudflare (recommended for production)
  • SkyBeam access enabled for your advertiser account

Step 1: Cloudflare Setup

1.1

Enable Workers

In your Cloudflare dashboard, navigate to "Workers & Pages" and upgrade to a paid plan if necessary.

1.2

Create API Token

Create a Custom API token with the following permissions:

Zone:Zone:Read
Zone:Zone Settings:Edit
Account:Cloudflare Workers:Edit
1.3

Configure Domain

Add your domain to Cloudflare and ensure DNS is properly configured with proxy status enabled.

Step 2: Configure Cloudflare Integration

2.1

Add Cloudflare Credentials

Your Cloudflare API credentials will be used for automated deployment. These are configured in your advertiser settings under the Cloudflare integration section.

Required credentials:
  • Cloudflare API Token (with Worker:Edit permissions)
  • Cloudflare Account ID
  • Cloudflare Zone ID (for custom domain deployment)
2.2

Verify Configuration

Once your Cloudflare credentials are configured in your advertiser settings, the system will automatically verify them before deployment.

Step 3: Deploy SkyBeam Worker

3.1

Navigate to Advertiser Dashboard

Open your advertiser dashboard from the main navigation or advertiser list.

3.2

Click the Deploy Button

In the top-right corner of your advertiser dashboard, you'll find a green "Deploy" button. Click this to open the deployment modal.

Located in dashboard header
Deploy
3.3

Start Deployment

In the deployment modal, click "Start Deployment" to begin the automated deployment process.

Deployment Progress Tracking:
  • ClickBeam: Builds and deploys tracking script
  • SkyBeam Build: Compiles worker from modules
  • SkyBeam Deploy: Deploys to Cloudflare Workers
  • Verification: Confirms successful deployment

Each step shows a pulsing green indicator during processing and a green checkmark when complete.

3.4

Monitor Deployment Progress

The deployment modal displays real-time progress with visual indicators for each deployment phase:

Green checkmark = Step completed successfully
Pulsing green border = Step in progress
Gray border = Step pending
3.5

View Deployment Results

Once deployment completes, the modal displays detailed results including:

  • Worker name and deployment environment
  • Cloudflare worker URL
  • Deployment timestamp
  • Verification status

Advanced Configuration

Event Settings

Configure which events SkyBeam should capture through the SkyBeam configuration interface:

  • URL pattern matching
  • HTTP method filtering
  • Parameter extraction

Deployment Environments

SkyBeam automatically deploys to the appropriate environment:

  • DEV
    Development and testing
  • PROD
    Production deployment
  • NULL
    Null environment for testing

Troubleshooting

Common Issues

Deployment Modal Not Appearing
Ensure SkyBeam access is enabled for your advertiser account. Contact support if you need access activated.
API Token Permissions
Verify your Cloudflare API token has Worker:Edit permissions for your account and zone. Check your advertiser's Cloudflare integration settings.
Deployment Fails During SkyBeam Deploy Step
Check that your Cloudflare credentials are correctly configured. Verify your domain is properly configured in Cloudflare with proxy status enabled.
Worker Limits Exceeded
Free Cloudflare accounts are limited to 10 workers. Upgrade to a paid Workers plan ($5/month minimum) to deploy additional workers.
Verification Step Fails
The worker may have been deployed successfully even if verification fails. Check your Cloudflare Workers dashboard to confirm worker status.

Next Steps

Once SkyBeam is deployed, configure event settings through the SkyBeam configuration interface and test your implementation.

Configure Event Settings → Testing Guide