@triplewhale/pixel-cli
v0.1.3
Published
AI-powered CLI tool that automates Triple Whale pixel installation for headless/custom e-commerce stores
Readme
@triplewhale/pixel-cli
AI-powered CLI tool that automates the entire Triple Whale pixel installation process for headless/custom e-commerce stores.
Installation
npm install @triplewhale/pixel-cliQuick Start
npx @triplewhale/pixel-cli installSupported Frameworks
| Framework | Status | |-----------|--------| | Shopify Hydrogen (Remix-based) | Full Support | | Next.js | Full Support | | Gatsby | Full Support | | Custom React (Vite/Webpack) | Full Support | | Vue/Nuxt | Full Support |
Commands
triple-whale install
Install Triple Whale pixel in your project.
npx @triplewhale/pixel-cli install [options]
Options:
-d, --dir <path> Project directory (default: current directory)
-y, --yes Skip confirmations and use defaults
--dry-run Preview changes without modifying files
-v, --verbose Show detailed outputtriple-whale verify
Verify an existing pixel installation.
npx @triplewhale/pixel-cli verifytriple-whale login
Login to your Triple Whale account.
npx @triplewhale/pixel-cli logintriple-whale logout
Logout from your Triple Whale account.
npx @triplewhale/pixel-cli logoutVerification
After installation, verify the pixel is working:
- Start your development server
- Open browser DevTools console
- Type
TriplePixel('State')- should return "Ready" - Check for
TriplePixelDataobject - Navigate through pages and observe events
- Add item to cart and check AddToCart fires
Troubleshooting
Pixel not firing?
- Check browser console for errors
- Verify the base snippet is in
<head>of index.html or root layout - Ensure
TripleNamein the snippet matches your store domain
Events not tracking?
- Check that tracking code was injected (look for
TriplePixel(calls) - Verify the
typeof window !== 'undefined'guard is present - Check browser console for JavaScript errors
Installation taking too long?
- Large codebases may take longer - try again in a moment
- Check your network connection
Support
License
MIT - Triple Whale
