TagadaPay Plugin CLI

Latest Version

v2.1.5 - Powerful CLI for deploying and managing plugins on TagadaPay

A comprehensive command-line tool for deploying React apps, static websites, and plugins on the TagadaPay platform with advanced routing and domain management capabilities.

Interactive Mode - The Best Way to Manage Plugins

The CLI’s Interactive Mode (tgdcli int) provides a beautiful, user-friendly interface for all your deployment needs:

tgdcli int

🎛️  Interactive Deployment Manager
───────────────────────────────────

? What would you like to do? (Use arrow keys)
❯ 🚀 Deploy Plugin
  📋 Manage Deployments (with mount/unmount actions)  
  🏪 Change Store
  🔄 Refresh
  ❌ Exit

Deploy Plugin Demo

When you select ”🚀 Deploy Plugin”, you get guided deployment:

🚀 Plugin Deployment Wizard
────────────────────────────

✅ Plugin detected: my-awesome-plugin v1.2.0
📁 Build directory: ./dist
📋 Manifest: plugin.manifest.json

? Select store to deploy to: (Use arrow keys)
❯ 🏪 My Production Store (store_prod_123)
  🧪 My Staging Store (store_staging_456) 
  🔧 My Development Store (store_dev_789)

? Select configuration: (Use arrow keys)
  ○ No configuration
  ○ .local.json
❯ ● config/production.json
  ○ config/theme-variant.json

🚀 Deploying... ████████████████ 100%

✅ Deployment successful!

📋 Deployment Details:
├── ID: dep_abc123xyz
├── Name: my-awesome-plugin-v1.2.0
├── Store: My Production Store
└── URL: https://my-plugin-abc123.tagadapay.app

🔗 Next steps:
• Test your plugin at the URL above
• Mount to custom domain with: tgdcli imount
• View all deployments with: tgdcli ilist

Manage Deployments Demo

The ”📋 Manage Deployments” option shows a beautiful tree view:

📋 Deployment Manager - My Production Store
─────────────────────────────────────────

📁 My Production Store (store_prod_123)
├── 🚀 my-plugin-v1.2.0 (dep_abc123) [ACTIVE]
│   ├── 🌐 https://my-plugin-abc123.tagadapay.app
│   ├── 🔗 my-plugin.mystore.com
│   └── 📊 Actions: [Mount] [Unmount] [Remove]
├── 🚀 landing-page-v2 (dep_def456) [ACTIVE]  
│   ├── 🌐 https://landing-def456.tagadapay.app
│   └── 📊 Actions: [Mount] [Remove]
└── 🚀 old-checkout (dep_ghi789) [INACTIVE]
    ├── 🌐 https://old-checkout-ghi789.tagadapay.app
    └── 📊 Actions: [Remove]

? Select deployment to manage: (Use arrow keys)
❯ my-plugin-v1.2.0 (dep_abc123)
  landing-page-v2 (def456)  
  old-checkout (dep_ghi789)
  ← Back to main menu

Quick Start

Install globally

npm install -g @tagadapay/plugin-cli@latest

tgdcli login

Start Interactive Mode

tgdcli int

🎉 This is all you need! The interactive mode guides you through everything.

Interactive Mode (Recommended)

The CLI features a powerful interactive mode that makes deployment management intuitive and efficient:

Interactive Deploy
Interactive Mount
Interactive Manager

tgdcli ideploy

Features:

🎯 Auto-detect plugin configuration
📁 Smart config file selection
🏪 Store selection with search
✅ Real-time validation
📊 Deployment progress tracking

Core Commands

Authentication

tgdcli login

Deployment Management

# Interactive mode (recommended)
tgdcli ideploy

# Command line mode
tgdcli deploy --store-id your-store-id

Domain Management

# Interactive mounting
tgdcli imount

# Direct mounting
tgdcli mount deployment-id custom-domain.com --store-id your-store-id

Configuration Management

Plugin Manifest

Every plugin needs a plugin.manifest.json file:

plugin.manifest.json

{
  "name": "my-awesome-plugin",
  "version": "1.0.0",
  "description": "An amazing TagadaPay plugin",
  "routes": {
    "/": "index.html",
    "/checkout": "index.html",
    "/success": "success.html"
  },
  "type": "checkout",
  "author": "Your Name",
  "homepage": "https://yourwebsite.com"
}

Local Development Config

Create .local.json for local development:

.local.json

{
  "storeId": "your-store-id",
  "accountId": "your-account-id",
  "apiUrl": "https://app.tagadapay.dev"
}

Deployment Variants

Create multiple configuration files for different deployments:

config/theme-green.json

{
  "theme": {
    "primaryColor": "#28a745",
    "secondaryColor": "#6c757d"
  },
  "features": {
    "upsells": true,
    "promotions": true
  }
}

config/theme-blue.json

{
  "theme": {
    "primaryColor": "#007bff",
    "secondaryColor": "#6c757d"
  },
  "features": {
    "upsells": false,
    "promotions": true
  }
}

Advanced Features

Multi-Store Management

The CLI automatically manages multiple stores and environments:

# Store selection is interactive
tgdcli ideploy
# > Select store: [Store A] [Store B] [Store C]

# Or specify directly
tgdcli deploy --store-id store-123

Deployment Tree View

Visualize your deployments with the interactive tree view:

tgdcli ilist

📁 my-store (store-123)
├── 🚀 my-plugin-v1 (dep-abc123)
│   ├── 🌐 https://my-plugin.tagadapay.app
│   └── 🔗 custom-domain.com
├── 🚀 landing-page (dep-def456)
│   └── 🌐 https://landing.tagadapay.app
└── 🚀 checkout-flow (dep-ghi789)
    ├── 🌐 https://checkout.tagadapay.app
    └── 🔗 checkout.mystore.com

Clean Remove

Safely remove deployments with dependency checking:

tgdcli iremove

The CLI will:

✅ Check for domain mounts
✅ Verify no active traffic
✅ Show impact analysis
✅ Confirm before deletion

Configuration Injection

The CLI automatically injects the right configuration based on your deployment:

Local Development: Uses .local.json
Staging: Uses selected config file + store settings
Production: Uses store configuration + plugin settings

Workflow Examples

Development to Production

Develop locally

# Your plugin runs with .local.json config
npm run dev

Deploy to staging

tgdcli ideploy
# Select staging store
# Choose config variant

Test deployment

# Test the provided staging URL
# Verify functionality

Deploy to production

tgdcli ideploy
# Select production store
# Use production config

Mount to custom domain

tgdcli imount
# Select deployment
# Enter custom domain

A/B Testing Setup

Create config variants

# Create config/variant-a.json
# Create config/variant-b.json

Deploy variant A

tgdcli deploy --config config/variant-a.json --store-id your-store

Deploy variant B

tgdcli deploy --config config/variant-b.json --store-id your-store

Mount to different domains

tgdcli mount deployment-a-id variant-a.mystore.com
tgdcli mount deployment-b-id variant-b.mystore.com

CLI Reference

Global Options

Option	Description	Example
`--store-id`	Specify store ID	`--store-id store-123`
`--config`	Use specific config file	`--config config/prod.json`
`--dry-run`	Preview changes without executing	`--dry-run`
`--verbose`	Enable detailed logging	`--verbose`
`--help`	Show command help	`--help`

Environment Variables

# Set default store
export TAGADA_STORE_ID=your-store-id

# Set API environment
export TAGADA_API_URL=https://app.tagadapay.com

# Enable debug logging
export TAGADA_DEBUG=true

Troubleshooting

Common Issues

Authentication failed

Solution: Run tgdcli logout then tgdcli login to refresh your authentication tokens.

Deployment not found

Solution: Check that you’re using the correct store ID and that the deployment exists with tgdcli list.

Domain mounting failed

Solution: Verify the domain is properly configured and points to TagadaPay’s servers. Check DNS settings.

Config file not found

Solution: Ensure your config file path is correct and the file exists. Use --config flag to specify the path.

Debug Mode

Enable verbose logging for troubleshooting:

tgdcli --verbose ideploy

This will show:

📝 Detailed API requests
🔍 Configuration resolution
📊 Upload progress
⚠️ Warning messages

Best Practices

1. Use Interactive Mode

Interactive commands provide better UX and error prevention:

# ✅ Recommended
tgdcli ideploy

# ❌ Avoid unless scripting
tgdcli deploy --store-id store-123 --config config.json

2. Organize Configurations

Keep your configs organized:

config/
├── development.json
├── staging.json
├── production.json
└── variants/
    ├── theme-a.json
    └── theme-b.json

3. Version Your Deployments

Use meaningful deployment names:

# ✅ Good
my-plugin-v2.1.0

# ❌ Avoid
my-plugin-123

4. Test Before Production

Always test in staging first:

# Deploy to staging
tgdcli ideploy # Select staging store

# Test thoroughly, then deploy to production
tgdcli ideploy # Select production store

Support

Need help with the CLI? We’re here to help:

Documentation: Complete command reference
Examples: Real-world usage scenarios
Support: developer-support@tagadapay.com
GitHub: Report issues and contribute

Plugin SDK

Plugin CLI

​TagadaPay Plugin CLI

Latest Version

​Interactive Mode - The Best Way to Manage Plugins

​Deploy Plugin Demo

​Manage Deployments Demo

​Quick Start

​Interactive Mode (Recommended)

​Core Commands

​Authentication

​Deployment Management

​Domain Management

​Configuration Management

​Plugin Manifest

​Local Development Config

​Deployment Variants

​Advanced Features

​Multi-Store Management

​Deployment Tree View

​Clean Remove

​Configuration Injection

​Workflow Examples

​Development to Production

​A/B Testing Setup

​CLI Reference

​Global Options

​Environment Variables

​Troubleshooting

​Common Issues

​Debug Mode

​Best Practices

​1. Use Interactive Mode

​2. Organize Configurations

​3. Version Your Deployments

​4. Test Before Production

​Support