linkapp deploy

Deploy your LinkApp to Linktree

Usage

npx @linktr.ee/linkapp deploy [options]

Ship the contents of your LinkApp’s dist/ folder to Linktree.

Options

Flag	Description	Default
--qa	Deploy to the QA environment instead of production	false
--skip-confirm	Skip the deployment confirmation prompt	false
--force	Force deployment even if the LinkApp is already published	false
-h, --help	Show help	-

Quick start

1. Authenticate once per environment:
   npx @linktr.ee/linkapp login      # production
   npx @linktr.ee/linkapp login --qa # QA
   
2. Optional: build locally if you want to inspect the output:
   npx @linktr.ee/linkapp build
   
3. Deploy:
   npx @linktr.ee/linkapp deploy
   

What happens

1. Initialize: loads linkapp.config.ts, resolves your LinkApp ID, and checks for a valid auth token.
2. Preflight: builds if dist/ is missing and runs validation checks.
3. Prepare artifacts: generates manifest files and packs uploadable assets.
4. Confirm: shows the file list and asks for confirmation (skip with --skip-confirm).
5. Upload: creates or updates the LinkApp on Linktree and prints success or error details.

Requirements

• linkapp.config.ts present in your project (in the root or .config/).
• Logged in for the target environment (linkapp login or linkapp login --qa).
• dist/ folder exists, or let the command build it automatically.

Use --force only when you intend to replace an already published build.