Getting started
Reference
Preview Apps

Preview Apps

Overview

Preview apps in Tapitalee are temporary copies of your application designed for testing features, pull requests, or experimental changes. They provide isolated environments that mirror your production setup while allowing safe testing without affecting your main application.

Resources copied from parent app on creation:

  • Process configuration (eg. cpu/memory)
  • Variable & secret values
  • Add-ons optionally can be shared or you can create new ones per-preview-app

Use Cases

Development Workflow

  • Pull Request Testing: Create preview apps for each PR to test changes
  • Feature Development: Isolated environments for developing new features
  • Stakeholder Review: Share working versions with non-technical stakeholders

Commands

Create Preview App 

tapit create preview <new_app_name> [domain=www.myapp.com] [delete_in_days=7] [-w|--wait]

Creates a temporary copy of your application for testing features or pull requests.

This happens under the umbrella of an existing app so it can share process and environment variable configuration, and add-ons (if shared).

Parameters

  • new_app_name: Name for the preview application
  • domain: Optional custom domain for the preview app
  • delete_in_days: Automatic deletion after specified days (default: 7)
  • --wait: Wait for preview app creation to complete

Examples 

# Create PR preview app
tapit create preview pr-123-myapp delete_in_days=14

# Feature branch testing
tapit create preview feature-auth-myapp domain=auth-test.myapp.com delete_in_days=30

# Quick testing environment
tapit create preview test-myapp delete_in_days=1 --wait

List Preview Apps 

tapit  list previews

Shows all preview applications and their status.

Delete Preview App 

tapit  delete preview <preview_app_name>

Manually deletes a preview application before its expiration.

Add-on Configuration 

# Create separate database for preview app
tapit -a pr-123-myapp create addon rds name=preview-db

# Share add-ons from main app (cost-effective for testing)
tapit -a pr-123-myapp create shared-addon main-cache
DomainsDeploy Tokens