portaljs-new-portal

1# PortalJS — New Portal
2 
3## Overview
4 
5Scaffold a production-ready PortalJS data portal from a brief. The skill is
6**interactive**: if the brief is thin it interviews the user in three short rounds
7(mapped to the template's three surfaces — Home, Catalog, Showcase), echoes a brief
8back for confirmation, then copies `examples/portaljs-catalog` (locally or via a
9remote `tiged` fetch), substitutes placeholder tokens, sets the namespace mode and the
10UI language, seeds any datasets named in the interview, installs dependencies, and verifies the scaffold
11with a type check.
12 
13## Prerequisites
14 
15- Node.js >=22 and npm available on `PATH`.
16- Network access, unless a current local checkout of the portaljs repo is available
17  (the resolver defaults to a remote fetch of the template).
18- A destination directory name that does not already contain files (or user consent
19  to overwrite one that does).
20 
21## Instructions
22 
23The canonical, full step-by-step workflow is
24[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md) —
25the single source of truth. Read and follow it when executing. Summary:
26 
271. Interview the user in up to three rounds — Home/basics (incl. the UI language,
28   default English), Catalog & discovery
29   (datasets, namespace mode `theme` vs `owner`), Showcase/views — skipping any round
30   already answered by the input brief. Accept "use defaults" at any point.
31…