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.