Customer.io Local Dev Loop

Overview

Set up an efficient local development workflow for Customer.io integrations with proper testing and isolation.

Prerequisites

• Customer.io SDK installed
• Separate development workspace in Customer.io (recommended)
• Environment variable management tool (dotenv)

Instructions

Step 1: Create Environment Configuration

Step 2: Create Dev Client Wrapper

Step 3: Set Up Test Helpers

Step 4: Create Dev Scripts

For detailed implementation code and configurations, load the reference guide: Read(${CLAUDE_SKILL_DIR}/references/implementation-guide.md)

Output

• Environment-aware Customer.io client
• Dry-run mode for safe testing
• Test mocks for unit testing
• Prefixed events for development isolation

Error Handling

Error	Cause	Solution
Wrong environment	Env vars not loaded	Use dotenv or env-specific files
Dev events in prod	Environment check failed	Verify NODE_ENV is set correctly
Mock not working	Import order issue	Mock before importing client

Resources

• Customer.io Workspaces
• Test Mode Best Practices

Next Steps

After setting up local dev, proceed to customerio-sdk-patterns for production-ready patterns.

Examples

Basic usage: Apply customerio local dev loop to a standard project setup with default configuration options.

Advanced scenario: Customize customerio local dev loop for production environments with multiple constraints and team-specific requirements.