Stop memorizing hundreds of CLI flags and options. Here are the essential commands you actually need for building and deploying checkout customizations.

Essential Commands Only

Focus on the core commands you’ll use daily. Skip the rarely-used options and edge cases.

Workflow-Focused

Commands organized by what you’re actually trying to accomplish, not alphabetical order.

​
Getting Started Commands

Problem: Need to access your Ollie Shop account and stores
Essential Auth Commands
# Login (opens browser)
ollieshop login

# Check current user
ollieshop whoami

# View available stores
ollieshop store list
What this gives you:
  • ✅ Access to your organization’s stores
  • ✅ Permission to deploy components and functions
  • ✅ Ability to manage versions and configurations

​
Development Commands

Problem: Need to build and deploy custom UI components
Component Workflow
# Create new component
ollieshop component create trust-badges
cd trust-badges

# Start development server
ollieshop component dev
# Opens http://localhost:3000 with live preview

# Build for production
ollieshop component build

# Deploy to store
ollieshop component deploy --slot header

# Check deployment status
ollieshop component list
What this workflow provides:
  • ✅ Live development environment with hot reload
  • ✅ Production-ready build optimization
  • ✅ Instant deployment to any checkout slot
  • ✅ Deployment verification and rollback

​
Common Workflows

​
Complete Component Development

End-to-End Component Workflow
# 1. Create and develop
ollieshop component create trust-badges
cd trust-badges
ollieshop component dev  # Test in browser

# 2. Deploy to test version
ollieshop component deploy --version test --slot header

# 3. Verify and promote to production
ollieshop version activate test  # Test with real traffic
ollieshop version set-default test  # Make it permanent

​
A/B Testing Setup

Split Testing Workflow
# Create test version
ollieshop version clone production --name "AB Test"

# Deploy variant to test version
ollieshop component deploy new-design --version test

# Activate both versions (50/50 traffic)
ollieshop version activate test
ollieshop version activate production

​
Quick Status Check

Health Check Commands
# Check authentication and access
ollieshop whoami

# View current deployments
ollieshop component list
ollieshop function list

# Check recent activity
ollieshop function logs --follow

​
Quick Reference

​
Most Used Commands

# Development
ollieshop component dev      # Start component development
ollieshop function test      # Test function locally

# Deployment
ollieshop component deploy   # Deploy component
ollieshop function deploy    # Deploy function

# Management
ollieshop version activate   # Switch live version
ollieshop status            # Check current state

​
Command Help

# Get help for any command
ollieshop --help
ollieshop component --help
ollieshop function deploy --help

​
Next Steps

Setup Guide

Install and configure the CLI

Developer Quickstart

Build and deploy your first component

Component Examples

Copy-paste component patterns

Function Examples

Production-tested business logic
Pro Tip: Most commands have sensible defaults. You rarely need to specify all the flags shown in examples. Start simple and add options as needed.