Overview

Install extensions and themes using the composer command from your server terminal. This method is recommended for developers and VPS/dedicated server users.

Prerequisites

• SSH access to your server
• Composer installed (getcomposer.org)
• File permissions to modify composer.json and vendor/ directory

Step 1: Add the TI PowerUp Repository

Configure Composer to use the TI PowerUp package repository:

composer config repositories.tipowerup composer https://packages.tipowerup.com

Step 2: Configure Authentication

TI PowerUp uses Bearer token authentication. Choose one of the following methods:

Method 1: CLI Command (Simplest)

Set your API key directly via the command line:

composer config bearer.packages.tipowerup.com "YOUR_API_KEY"

Method 2: auth.json File (Manual)

Create or edit auth.json in your project root with your API key:

{
    "bearer": {
        "packages.tipowerup.com": "YOUR_API_KEY"
    }
}

Add auth.json to your .gitignore to prevent accidental commits:

auth.json

Method 3: Environment Variable (Recommended for CI/CD & Docker)

Set the COMPOSER_AUTH environment variable:

export COMPOSER_AUTH='{"bearer":{"packages.tipowerup.com":"YOUR_API_KEY"}}'

Or add to your .env file:

COMPOSER_AUTH='{"bearer":{"packages.tipowerup.com":"YOUR_API_KEY"}}'

Get your API key from your profile at tipowerup.com.

Step 3: Install a Package

composer require tipowerup/ti-ext-loyaltypoints

Composer automatically downloads the package, resolves dependencies, and rebuilds the autoloader.

Step 4: Run Migrations

After Composer installation, run migrations to create the database tables and register the extension:

php artisan igniter:extension-install tipowerup.loyaltypoints

Updating via Composer

# Update all packages
composer update

# Update a specific package
composer update tipowerup/ti-ext-loyaltypoints

# Update to a specific version
composer require "tipowerup/ti-ext-loyaltypoints:^2.0"

Removing a Package

composer remove tipowerup/ti-ext-loyaltypoints

This automatically rolls back migrations and removes files from vendor/.