Portaljs deploy

Skill jeremylongshore/claude-code-plugins-plus-skills/plugins/community/portaljs/skills/portaljs-deploy

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.From its SKILL.md

Install

npx -y skills add jeremylongshore/claude-code-plugins-plus-skills --skill portaljs-deploy

Assembled from the repository path, not quoted from the project. Check it against their README if it does not work.

3 things to look at

reads credentialsReads from 2 credential sources: `PORTALJS_TOKEN` and 1 more.
runs commandsInstructs the agent to run 3 commands, including `npm run build` and 2 more.
fetches URLsInstructs the agent to fetch 1 URL, including $PORTALJS_ARC_API/v1/deploy?slug=<slug>.

What its file declares

Copied from the file, not written here

The file declares its own license as MIT. That is the author’s claim about this one file, and it is not the same thing as the license GitHub reports for the repository, which is listed with the other numbers below.

SKILL.md

5.3 KB, ~1.2k tokens by cl100k_base, as published. Nobody here has run it

PortalJS — Deploy

Overview

Publish an existing PortalJS portal to PortalJS Arc — Datopian's managed static hosting on Cloudflare. Build a static export, upload it to the Arc API, and print a live https://SLUG.arc.portaljs.com URL. Re-running redeploys the same portal (idempotent on the slug). This is a single-target skill — it deploys to Arc only. For self-hosting, run npm run build and upload out/ to any static host; no skill required for that path. Arc serves static exports only — SSR is not hosted on Arc yet.

Prerequisites

A PortalJS portal directory with a package.json that lists next as a dependency.
Node 18+ and npm on PATH (the Arc device-login flow uses Node's global fetch).
curl and tar available for packaging and upload.
A PortalJS Arc token — read from PORTALJS_TOKEN, or ~/.portaljs/credentials ({"token":"…"}). If neither exists, the skill signs in on demand via a device-code flow; no manual token copying required.
If the portal stores large data in Git LFS/R2, do not run git lfs pull before deploying — large datasets are served from Cloudflare R2 via absolute URLs in datasets.json, not copied into the export.

Instructions

The canonical, full step-by-step workflow is .claude/commands/portaljs-deploy.md — the single source of truth. Read and follow it when executing. Summary:

Gather input — portal directory (default .) and slug (default from package.json name or directory name, slugified). Confirm the directory is a Next.js project; reject reserved slugs (www, api, admin, staging, arc).
Resolve the Arc token: read PORTALJS_TOKEN, else ~/.portaljs/credentials; if missing, run the device-authorization sign-in flow and save the returned token.
Ensure next.config.js sets output: 'export' and images: { unoptimized: true }, then run npm run build; stop if the build fails.
Verify the export carries no dataset bytes — run npm run check-export (or scripts/check-export.mjs) to catch Git LFS pointer leaks and oversized data files.
Tar the out/ directory and POST it to $PORTALJS_ARC_API/v1/deploy?slug=<slug> with the bearer token; handle 200/401/409/400/413 responses distinctly.
Report the live URL, file count, upload size, and R2-vs-inline dataset counts.

Output

Modified (if needed): next.config.js — adds output: 'export' and images: { unoptimized: true } when absent, preserving the rest of the config.
Created (on first sign-in): ~/.portaljs/credentials (mode 0600).
Verified: npm run build exits 0, out/index.html exists, the export-hygiene check passes.
Result: the portal is live at https://SLUG.arc.portaljs.com; re-running updates the same slug in place.

Error Handling

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.

Examples

Example 1 — Deploy the current directory with the default slug

/portaljs-deploy

Example 2 — Deploy with an explicit slug

/portaljs-deploy --slug my-open-data

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

export PORTALJS_TOKEN=arc_live_xxxxxxxx
/portaljs-deploy ./portals/city-budget --slug city-budget

Resources

Full workflow: .claude/commands/portaljs-deploy.md
Deploy internals reference: references/reference.md
Related skills: portaljs-new-portal, portaljs-add-dataset, portaljs-connect-ckan
PortalJS Arc dashboard (sign in, manage tokens): https://arc.portaljs.com

What ships with it: 1 file

3.2 KB alongside SKILL.md

references/

reference.md3.2 KB

Gives 0 of the 12 instructions most ship operate skills give in ~1.2k tokens

Counted across 1,077 of the 1,713 authors here whose files we hold, read 2026-09-06

Create GitHub releasein 44 of 1077, across 43 files
Run the test suitein 30 of 1077, across 25 files
Create and push git tagin 27 of 1077, across 26 files
Push commits and tagsin 27 of 1077
Create annotated tagin 25 of 1077, across 22 files
Ensure working tree is cleanin 24 of 1077
Check for product marketing context firstin 23 of 1077, across 6 files
Commit version bump changesin 22 of 1077, across 21 files
Update CHANGELOG.mdin 21 of 1077, across 20 files
Structure launch marketing across three channel typesin 20 of 1077, across 5 files
Commit and tag the releasein 20 of 1077, across 18 files
Update the CHANGELOG for new releasesin 19 of 1077

Said here and by no other author read

Confirm the directory is a Next.js project
Reject reserved slugs
Ensure static export is set in config
Stop if the build fails
Verify the export carries no dataset bytes
Tar the output directory

Grouped from the skills themselves: near-identical wordings counted once, and counted by distinct author, so one author publishing three of these counts once. Length counted with cl100k_base; the agent that loads this file may tokenize it differently.