portal-setup

Initialize a Showpane workspace by installing dependencies and applying the SQLite Prisma schema.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Guides users through initializing and configuring a local Showpane workspace by detecting the app path, installing dependencies, applying the local SQLite Prisma schema, and creating a persisted organization record so the project can be previewed and deployed locally.

Core Features & Use Cases

  • App detection and validation: searches common locations and validates package.json plus Prisma schema markers before proceeding.
  • Dependency management: installs npm packages and generates the Prisma client when needed.
  • Database provisioning: sources .env and applies the local SQLite schema using prisma db push.
  • Organization and branding setup: interactively collects org name, contact info, slug, and primary color and writes a secure ~/.showpane/config.json.
  • Robust error handling and telemetry: checks node/npm versions, database connectivity, file permissions, and records setup events for learnings or follow-up actions. Use case: a developer runs the packaged installer or npx showpane to quickly prepare a freshly generated Showpane project for local development and publishing.

Quick Start

Run the interactive setup by launching the portal-setup flow (for example via npx showpane) to detect your app, install dependencies, apply the local schema, and create the organization.

Frequently Asked Questions about portal-setup

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

FAQPage Schema
How do I set up a local SQLite database for a Prisma project?▼

To configure a local Showpane workspace, the wizard detects the app path, installs npm dependencies, applies the SQLite Prisma schema, and interactively collects organization details to write a secure config.json file.

What do I need to install before running the Showpane setup wizard?▼

Before running the Showpane setup, you need Node 18+ and npm installed, shell access to run commands, a Showpane app directory with package.json and a Prisma schema, and a writable home directory.

How does the interactive setup process initialize a new workspace?▼

The interactive setup initializes a workspace by detecting the app path, validating package.json and Prisma schema markers, installing dependencies, applying the schema, and creating a persisted organization record.

Can I use this setup wizard for both local development and packaged installer scenarios?▼

Yes, you can use this setup wizard for both local development and packaged installer scenarios to initialize a Showpane project, validate environment variables, and prepare the app for preview and deployment.

Why is my Prisma database push failing during workspace initialization?▼

Prisma database push may fail during workspace initialization if environment variables in .env are missing, file permissions are incorrect, or database connectivity checks fail; the wizard validates these before applying the schema.