Workflow Examples

Real-world workflow examples and implementations for Zara automation

Try Examples

View Setup

npx zara-workflows run feature-dev

npx zara-workflows run bug-fix

npx zara-workflows run content-update

How It Works

1. Preset Execution

Each preset is a pre-configured workflow that:

• Listens for specific Linear triggers
• Executes a sequence of actions
• Emits real-time events via SSE
• Creates GitHub PRs automatically
• Deploys to Vercel preview environments

2. Real-time Monitoring

• SSE Events: Get instant updates on workflow progress
• GitHub Integration: Watch PRs being created in real-time
• Vercel Previews: See preview URLs appear automatically
• Linear Updates: Track issue status changes

3. Automated Actions

• Branch Creation: Automatic feature/hotfix branches
• Code Generation: AI-powered code creation
• Testing: Automated test execution
• PR Creation: GitHub pull requests with descriptions
• Deployment: Vercel preview deployments

Advanced Usage

Custom Preset Parameters

# Run with custom parameters
npx zara-workflows run feature-dev --branch=feature/new-auth --repo=my-org/my-repo
 
# Run with environment override
npx zara-workflows run bug-fix --env=staging
 
# Run with custom timeout
npx zara-workflows run content-update --timeout=300

Preset Configuration

Each preset can be customized via environment variables:

# Feature Development
FEATURE_BRANCH_PREFIX=feature/
FEATURE_TESTS_ENABLED=true
FEATURE_AUTO_MERGE=false
 
# Bug Fix
BUG_BRANCH_PREFIX=hotfix/
BUG_TESTS_REQUIRED=true
BUG_AUTO_DEPLOY=true
 
# Content Update
CONTENT_BRANCH_PREFIX=content/
CONTENT_AUTO_PUBLISH=false
CONTENT_REVIEW_REQUIRED=true

Monitoring & Debugging

Real-time Logs

# Follow workflow logs
npx zara-workflows logs --follow
 
# Filter by preset type
npx zara-workflows logs --preset=feature-dev
 
# Filter by status
npx zara-workflows logs --status=success

Event Monitoring

# Monitor SSE events
npx zara-workflows events --preset=feature-dev
 
# Export events to file
npx zara-workflows events --export=events.json

Health Checks

# Check preset health
npx zara-workflows health
 
# Test integrations
npx zara-workflows test --linear --github --vercel

Troubleshooting

Common Issues

Verify environment
npx zara-workflows env --check
Test integrations
npx zara-workflows test --all

Check webhook status
npx zara-workflows webhooks --status
Verify issue format
npx zara-workflows validate --issue=ISSUE_ID

Test GitHub access
npx zara-workflows test --github
Check repository permissions
npx zara-workflows repos --list

Next Steps

Get Started

1. Complete Setup: Follow the Setup & Configuration guide
2. Choose a Preset: Pick from feature-dev, bug-fix, or content-update
3. Run the Workflow: Execute npx zara-workflows run <preset>
4. Create a Trigger: Add the appropriate tag to a Linear issue
5. Watch the Magic: See automation happen in real-time

Learn More

• Setup Guide →: Complete configuration instructions
• Architecture →: Understand the workflow engine
• API Reference →: Complete API documentation
• Community →: Join the Vistara community