tsoft-cli

Command-line tool for tsoft360 theme development and management.

Installation

npm install -g tsoft-cli

Requirements

• Node.js >= 20.19.0

Quick Start

# Sign in
tsoft login

# List available themes
tsoft theme list

# Pull an existing theme
tsoft theme pull

# Start dev mode (hot-reload)
tsoft theme dev

Commands

Authentication

| Command | Description | |----------------|-----------------------------------------| | tsoft login | Sign in via OAuth2 | | tsoft logout | Sign out and clear stored tokens | | tsoft whoami | Show the signed-in user and active shop |

Theme Management

| Command | Description | | -------------------------- | --------------------------------------- | | tsoft theme list | List all themes | | tsoft theme create [name] | Create a new theme | | tsoft theme pull | Pull an existing theme | | tsoft theme use [name] | Set the active theme | | tsoft theme dev [name] | Start dev mode (hot-reload) | | tsoft theme push [name] | Push theme files to your store | | tsoft theme section list | List blocks and sections | | tsoft theme section add | Add a section (interactive) |

tsoft theme publish and tsoft theme submit are deprecated aliases kept for backwards compatibility. publish forwards to push; submission is now done from the partner panel.

Pushing a Theme

# Using the active theme
tsoft theme push

# Using a specific theme
tsoft theme push my-theme

# With verbose error output
tsoft theme push --verbose

On the first push you enter the initial version number. Subsequent updates prompt for a semantic-versioning bump type (patch / minor / major).

Security

• OAuth2 PKCE: Secure authorization as a public client
• State parameter: CSRF protection
• Secure storage: Tokens are readable only by the owner (chmod 600)
• Auto-refresh: Access tokens are refreshed automatically when they expire

Troubleshooting

# Check the current session
tsoft whoami

# Re-authenticate from scratch
tsoft logout
tsoft login

License

MIT