portal-deploy

Publish a Showpane portal app to Showpane Cloud with pre-flight checks and build.

Updated Apr 6, 2026
One-click install
npx skills add https://github.com/twillcocks/showpane --skill portal-deploy
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: portal-deploy
Source: https://github.com/twillcocks/showpane/tree/main/skills/portal-deploy
Command: npx skills add https://github.com/twillcocks/showpane --skill portal-deploy

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Automates the multi-step process of publishing a Showpane portal by running pre-flight checks, building the app, packaging the artifact, uploading to Showpane Cloud, and verifying the hosted release so developers don't manage these steps manually.

Core Features & Use Cases

  • Pre-flight validation: Verifies cloud credentials, cloud health, and TypeScript type checks before proceeding.
  • Build and upload orchestration: Runs the canonical showpane deploy command to build, package, upload, and poll for a hosted live state while preserving logs and progress output.
  • Result summarization & logging: Parses deploy output, prints a concise summary (status, deploy ID, live URL, portal counts), and records deployment insights for operational memory.
  • Error recovery guidance: Provides structured remediation steps for build failures, auth errors, artifact upload issues, file sync problems, and stuck publishes.
  • Use Case: Use this to publish a local Showpane workspace or integrate into a CI pipeline to release client portals to your organization's hosted domain.

Quick Start

Use the portal-deploy skill to build, package, and publish the current Showpane app to Showpane Cloud after you authenticate with showpane login.

Frequently Asked Questions about portal-deploy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I deploy a Showpane portal app to Showpane Cloud?

Deploying a Showpane portal involves running pre-flight checks, building the app, packaging artifacts, and initiating the cloud deploy via the showpane CLI. The process verifies credentials, runs TypeScript type checks, and uploads the package to your organization's hosted domain.

What does the Showpane deployment pre-flight validation check for?

Pre-flight validation for Showpane deployment verifies cloud credentials, checks cloud health, and runs TypeScript type checks. These checks confirm the local project is error-free and authenticated before attempting to build and upload artifacts.

Do I need Node.js and TypeScript to publish a Showpane portal?

Yes, publishing a Showpane portal requires a working Node.js and TypeScript build environment. Additionally, you must have authenticated cloud credentials via the showpane CLI and the CLI installed in your configured SHOWPANE_HOME directory.

Can I integrate Showpane cloud deployment into a CI/CD pipeline?

Yes, Showpane deployment can be integrated into a CI pipeline to release client portals to your hosted domain. The deploy command orchestrates building, packaging, uploading, and polling for a live state while preserving logs for automated CI/CD workflows.

How do I fix a stuck Showpane portal publish or artifact upload failure?

For a stuck Showpane portal publish or artifact upload failure, the skill provides structured error recovery guidance. It outlines remediation steps for build failures, auth errors, artifact upload issues, file sync problems, and stuck publishes.