InstallHub
Package Preview
Before committing to a marketplace install, preview exactly what will happen in your tenant — what artifacts will be created, what conflicts will arise, and any warnings from the security scanner.
Phase 3 — PENDING This feature is planned but not yet implemented.
What Preview Does
The marketplace preview runs the full Phase 2 import dry-run pipeline against your target tenant without committing any changes. You get a complete picture of the installation before clicking "Install".
Preview API
POST /api/marketplace/packages/{packageId}/preview
{
"version": "3.0.0",
"targetTenantId": "tenant-abc123"
}
// Response:
{
"packageId": "mkt-pkg-a1b2c3",
"version": "3.0.0",
"targetTenantId": "tenant-abc123",
"wouldInstall": [
{ "type": "ProcessDefinition", "name": "EmployeeOnboarding", "action": "Create" },
{ "type": "AtlasForm", "name": "EmployeeForm", "action": "Replace (existing v1.0.0 → v2.0.0)" },
{ "type": "RuleSet", "name": "ApprovalRules", "action": "Create" }
],
"conflicts": [
{
"type": "AtlasForm",
"name": "EmployeeForm",
"existingVersion": "1.0.0",
"packageVersion": "2.0.0",
"defaultAction": "Replace"
}
],
"packageDependenciesCheck": {
"satisfied": true,
"missing": []
},
"securityScanResult": "PASS",
"platformCompatibility": {
"compatible": true,
"packagePlatform": "4.2.0",
"targetPlatform": "4.2.0"
},
"estimatedInstallTime": "~5 seconds"
}Conflict Preview Table
The preview clearly shows which artifacts will conflict with existing artifacts in your tenant and what the default resolution will be. You can change the resolution strategy before proceeding:
| Artifact | Type | Existing Version | Package Version | Default Action |
|---|---|---|---|---|
| EmployeeOnboarding | Workflow | — | 3.0.0 | Create |
| EmployeeForm | Form | 1.0.0 | 2.0.0 | Replace |
| ApprovalRules | Rules | — | 1.2.0 | Create |
Preview is Always Free
Running a preview never counts against rate limits and never modifies your tenant. You can run previews as many times as needed before committing to the install.