portaljs-deploy

by datopian2.4k

Deploy a PortalJS portal to PortalJS Arc — Datopian-managed static hosting on Cloudflare. Builds a static export, uploads it, and returns a live SLUG.arc.portaljs.com URL. One command, one target. Use

Install

The skill file stays in the publisher's repository.

Paste the copied command in a terminal. It installs this SKILL.md into that agent.

npx skills add datopian/portaljs --skill portaljs-deploy -a cursor -y

Download skill skills/portaljs-deploy/SKILL.md on GitHub

Related skills

View all

Questions

How do I install portaljs-deploy?: Download skills/portaljs-deploy/SKILL.md from the publisher, or copy the path and open the repository. PlugMCP lists the skill and does not host the file.
Where does portaljs-deploy live?: The publisher keeps it at https://github.com/datopian/portaljs.
Which agents can use portaljs-deploy?: Claude, Cursor, and Codex can read a SKILL.md you add from the publisher's repository.

name: portaljs-deploy description: Deploy a PortalJS portal to PortalJS Arc — Datopian-managed static hosting on Cloudflare. Builds a static export, uploads it, and returns a live SLUG.arc.portaljs.com URL. One command, one target. Use when a portal is ready to publish or redeploy to a live URL. allowed-tools: Read, Write, Edit, Bash(npm:), Bash(npx:), Bash(curl:*) version: 1.0.0 author: Datopian [email protected] license: MIT compatibility: Claude Code with PortalJS portals (Next.js 14, React 18, Node 18+). Runs from any project via the plugin, a personal ~/.claude/commands install, or a portaljs clone. tags:

Symptom	Cause	Fix
`NOT_A_PORTAL` error	No `next` dependency found in `PORTAL_DIR/package.json`	Run from a valid portal directory, or pass the correct path.
Slug rejected	Derived slug is reserved (`www`, `api`, …) or not a valid DNS label	Pass an explicit `--slug <name>`.
Build fails (non-zero exit)	App/config error surfaced in `npm run build`	Print the log, fix the error, never deploy a failing build.
`check-export` fails	Git LFS pointer leaked into `out/`, or a data file exceeds the size budget	Reference large data by absolute R2 URL via `portaljs-add-dataset`; don't `git lfs pull` before building.
`401` on upload	Token invalid, expired, or revoked	Re-run the device sign-in flow once, retry the upload; stop if it 401s again.
`409` on upload	Slug already taken by another account	Choose a different `--slug`.
`400` / `413` on upload	Malformed slug or export too large	Read the JSON `error` field and address the specific cause.

portaljs-deploy

Install

Related skills

Questions

PortalJS — Deploy

Overview

Prerequisites

Instructions

Output

Error Handling

Examples

Example 1 — Deploy the current directory with the default slug

Example 2 — Deploy with an explicit slug

Example 3 — Non-interactive deploy from CI with a token env var

Resources