# Portaljs New Portal

Scaffold a new PortalJS data portal from a brief.

- Repository: https://github.com/datopian/portaljs (2370 stars)
- Category: Marketing
- License: MIT
- Last updated: 2026-10-28
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add datopian/portaljs --skill portaljs-new-portal -g -a claude-code -y`
Codex: `npx skills add datopian/portaljs --skill portaljs-new-portal -g -a codex -y`
Cursor: `npx skills add datopian/portaljs --skill portaljs-new-portal -g -a cursor -y`
Gemini CLI: `npx skills add datopian/portaljs --skill portaljs-new-portal -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add datopian/portaljs`

## Description

Scaffold a new PortalJS data portal from a brief. Copies the canonical template from examples/portaljs-catalog and substitutes project tokens. Use when starting a brand-new data portal project from scratch.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# PortalJS, New Portal

## Overview

Scaffold a production-ready PortalJS data portal from a brief. The skill is
**interactive**: if the brief is thin it interviews the user in three short rounds
(mapped to the template's three surfaces, Home, Catalog, Showcase), echoes a brief
back for confirmation, then copies `examples/portaljs-catalog` (locally or via a
remote `tiged` fetch), substitutes placeholder tokens, sets the namespace mode and the
UI language, seeds any datasets named in the interview, installs dependencies, and verifies the scaffold
with a type check.

## Prerequisites

- Node.js >=22 and npm available on `PATH`.
- Network access, unless a current local checkout of the portaljs repo is available
  (the resolver defaults to a remote fetch of the template).
- A destination directory name that does not already contain files (or user consent
  to overwrite one that does).

## Instructions

The canonical, full step-by-step workflow is
[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md), the single source of truth. Read and follow it when executing. Summary:

The rest: https://github.com/datopian/portaljs/blob/HEAD/skills/portaljs-new-portal/SKILL.md