Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.launchmystore.io/llms.txt

Use this file to discover all available pages before exploring further.

CLI Setup

The LaunchMyStore CLI (lms) helps you develop, test, and deploy apps from the command line.
The CLI is coming soon! This documentation previews the planned features.

Installation

npm install -g @launchmystore/cli
Verify installation:
lms --version

Authentication

Log in with your developer account:
lms auth login
This opens your browser to authenticate. Once complete, your credentials are stored securely. Check your current session:
lms auth whoami

Creating an App

Create a new app project:
lms app create
Follow the interactive prompts to:
  1. Choose a name and handle
  2. Select a template (Node.js, React, Remix, Extension-only)
  3. Configure OAuth scopes
  4. Choose extension types
The CLI will:
  • Download the template
  • Register your app with LaunchMyStore
  • Create .lmsrc.json config file
  • Generate .env with credentials

Development Server

Start the development server with a secure tunnel:
lms app dev
This:
  • Starts your local dev server
  • Creates a Cloudflare tunnel for webhook testing
  • Updates your app’s redirect URLs automatically
  • Watches for extension changes

Commands Reference

App Commands

CommandDescription
lms app createCreate a new app
lms app devStart dev server with tunnel
lms app deployDeploy to production
lms app infoShow app details
lms app listList your apps

Auth Commands

CommandDescription
lms auth loginAuthenticate with LaunchMyStore
lms auth logoutClear stored credentials
lms auth whoamiShow current user

Extension Commands

CommandDescription
lms extension createCreate new extension
lms extension pushPush extensions to store
lms extension listList extensions

Function Commands

CommandDescription
lms function createCreate new function
lms function testTest function in sandbox
lms function deployDeploy function
lms function logsView function logs

Webhook Commands

CommandDescription
lms webhook listList registered webhooks
lms webhook triggerTrigger test webhook

Configuration

The CLI uses .lmsrc.json for project configuration:
{
  "appId": "app_abc123",
  "clientId": "cli_xyz789",
  "handle": "my-awesome-app",
  "scopes": ["read_products", "write_products", "read_orders"],
  "extensions": ["theme_block", "checkout_ui"]
}

Environment Variables

VariableDescription
LMS_CLIENT_IDYour app’s Client ID
LMS_CLIENT_SECRETYour app’s Client Secret
LMS_APP_URLApp URL (auto-set in dev mode)
LMS_SCOPESOAuth scopes

Troubleshooting

Make sure npm global bin is in your PATH:
npm config get prefix
# Add {prefix}/bin to your PATH
Run lms auth login to re-authenticate.
Check that port 3000 is available, or use --port to specify another port.