datopian/portaljs

"owner": {     "name": "Datopian",     "url": "https://www.datopian.com"

"name": "Datopian",     "url": "https://www.datopian.com"   },

"url": "https://www.datopian.com"

"author": {     "name": "Datopian",     "url": "https://www.datopian.com"

"name": "Datopian",     "url": "https://www.datopian.com"   },

"url": "https://www.datopian.com"

},   "homepage": "https://github.com/datopian/portaljs",   "repository": "https://github.com/datopian/portaljs",

"homepage": "https://github.com/datopian/portaljs",

"repository": "https://github.com/datopian/portaljs",

Read, Write, Edit, Bash(ogr2ogr:*), Bash(ogrinfo:*), Bash(tippecanoe:*), Bash(duckdb:*), Bash(git:*), Bash(curl:*), Bash(jq:*), Bash(npx:*), Bash(node:*), Bash(mkdir:*), Bash(cp:*), Bash(wc:*), Bash(zip:*), Bash(command:*), WebFetch

Input is one Hub URL (e.g. `https://hub-lewisville.opendata.arcgis.com` or

`https://streamwaterdata.co.uk`). Output: `datasets.json` entries, data on R2, and

- **Hub URL** (required) — the site root, e.g. `https://hub-lewisville.opendata.arcgis.com`

or a Hub Premium custom domain (`https://streamwaterdata.co.uk`). The skill appends

I need an ArcGIS Hub site URL to migrate. Provide the site root, e.g.   https://hub-lewisville.opendata.arcgis.com

https://hub-lewisville.opendata.arcgis.com

(a Hub Premium custom domain like https://streamwaterdata.co.uk also works.)

# Debian: sudo apt-get install -y gdal-bin duckdb jq nodejs   # tippecanoe: build from source

curl -fsSL "$DATA_JSON" -o /tmp/a2p-datajson.json

Every Hub `dataset[]` item's `identifier` embeds the AGOL item id (`https://www.arcgis.com/home/item.html?id=<ITEM_ID>&sublayer=<n>`). Extract it and GET the

(`https://www.arcgis.com/home/item.html?id=<ITEM_ID>&sublayer=<n>`). Extract it and GET the

ITEM_ID=$(jq -r '.identifier' <<<"$ITEM" | sed -nE 's/.*[?&]id=([0-9a-f]{32}).*/\1/p') # Prefer the Hub's own portal host; www.arcgis.com works for public AGOL items. curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID?f=

# Prefer the Hub's own portal host; www.arcgis.com works for public AGOL items. curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID?f=json" \   -o "/tmp/a2p-item-$ITEM_ID.json"   # → .snippet .description .licenseInfo .ac

curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID?f=json" \

mkdir -p public/thumbnails     EXT="${THUMB##*.}"   # png / gif / jpg — keep the source extension     curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID/info/$THUMB" \

EXT="${THUMB##*.}"   # png / gif / jpg — keep the source extension     curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID/info/$THUMB" \       -o "public/thumbnails/$SLUG.$EXT" && echo "thumbnail: /thumbnails/$SLUG.$EXT"

curl -fsSL "https://www.arcgis.com/sharing/rest/content/items/$ITEM_ID/info/$THUMB" \

# Fetch the layer definition ONCE and reuse it (paging size, count, AND the field # definitions — name/type/alias — which drive the schema + English headers, §6d): curl -fsS "$LAYER?f=json" -o "/tmp/a2p-layerdef-$SLUG.json"

# definitions — name/type/alias — which drive the schema + English headers, §6d): curl -fsS "$LAYER?f=json" -o "/tmp/a2p-layerdef-$SLUG.json" MAX=$(jq -r '.maxRecordCount // 1000' "/tmp/a2p-layerdef-$SLUG.json")

curl -fsS "$LAYER?f=json" -o "/tmp/a2p-layerdef-$SLUG.json"

MAX=$(jq -r '.maxRecordCount // 1000' "/tmp/a2p-layerdef-$SLUG.json") TOTAL=$(curl -fsS "$LAYER/query?where=1%3D1&returnCountOnly=true&f=json" | jq -r '.count') # Page and concatenate features:

TOTAL=$(curl -fsS "$LAYER/query?where=1%3D1&returnCountOnly=true&f=json" | jq -r '.count')

const [,,layer,maxStr,out] = process.argv const max = parseInt(maxStr,10) || 1000 // A bare fetch() will hang forever on a slow/stalled FeatureServer page (common on

const max = parseInt(maxStr,10) || 1000 // A bare fetch() will hang forever on a slow/stalled FeatureServer page (common on // dense geometry like contours/parcels). Cap every request and retry — without this the

// A bare fetch() will hang forever on a slow/stalled FeatureServer page (common on

const t = setTimeout(() => ac.abort(), 45000)     try {       const r = await fetch(url, { signal: ac.signal })

try {       const r = await fetch(url, { signal: ac.signal })       if (!r.ok) throw new Error(`HTTP ${r.status}`)

const r = await fetch(url, { signal: ac.signal })

- **Per-request timeout is mandatory, not a nicety.** ArcGIS FeatureServers routinely stall   mid-page on dense geometry; a bare `fetch()` with no `AbortController` will hang the entire

mid-page on dense geometry; a bare `fetch()` with no `AbortController` will hang the entire

layer's **native CRS with Z coordinates** — e.g. Lewisville contours download as EPSG:3857 +   Z — so always pipe it through `ogr2ogr -t_srs EPSG:4326 -dim XY`; and it can be enormous, 514 MB   for contours, so use a long `curl --max-time`)

Z — so always pipe it through `ogr2ogr -t_srs EPSG:4326 -dim XY`; and it can be enormous, 514 MB   for contours, so use a long `curl --max-time`); or (b) **ask the customer for a File Geodatabase   export** — as the data owner they generate

for contours, so use a long `curl --max-time`); or (b) **ask the customer for a File Geodatabase

required), `git lfs prune`. Then build each absolute R2 URL (`$R2_PUBLIC_BASE/lfs/datopian/$PROJECT_SLUG/<oid>`, `R2_PUBLIC_BASE` default `https://data.portaljs.com`).

`https://data.portaljs.com`).

layer `?f=json` `editingInfo`), `extent`, and `migratedAt`. Phase 3 sync (§10) reads it to detect per-layer drift cheaply on a schedule; producing it here is what makes the shadow re-syncable at no extra cost. See [`sync-and-cutover.md`](ht

extra cost. See [`sync-and-cutover.md`](https://github.com/datopian/portaljs/blob/main/skills/arcgis-to-portaljs/references/sync-and-cutover.md).

Phase 0 migrates **once**. Phase 3 keeps the PortalJS shadow tracking the live Hub and preserves old URLs at cutover. Full design + copy-paste templates: [`sync-and-cutover.md`](https://github.com/datopian/portaljs/blob/main/skills/arcgis-t

URLs at cutover. Full design + copy-paste templates: [`sync-and-cutover.md`](https://github.com/datopian/portaljs/blob/main/skills/arcgis-to-portaljs/references/sync-and-cutover.md). Mental model is unchanged — **AGOL edits, PortalJS shadow

[`sync-and-cutover.md`](https://github.com/datopian/portaljs/blob/main/skills/arcgis-to-portaljs/references/sync-and-cutover.md).

LIVE_EDIT=$(curl -sS -m30 "$SVC?f=json" | jq -r '.editingInfo.dataLastEditDate // .editingInfo.lastEditDate // empty')

LIVE_COUNT=$(curl -sS -m30 "$SVC/query?where=1=1&returnCountOnly=true&f=json" | jq -r '.count')

domain can rot independently of the Hub: Stream's apex `streamwaterdata.co.uk` serves a   certificate for an unrelated site (only `www.` — the CNAME to `hub.arcgis.com` — works).   `curl -sv` the apex AND `www.` first, pick the working host

certificate for an unrelated site (only `www.` — the CNAME to `hub.arcgis.com` — works).   `curl -sv` the apex AND `www.` first, pick the working host for every fetch, and record   the broken variant in the report (it's also a cutover selli

`curl -sv` the apex AND `www.` first, pick the working host for every fetch, and record

Read, Write, Edit, Bash

setIsLoading(true)     setError(null)     fetch(url)

setError(null)     fetch(url)       .then((r) => {

fetch(url)

Next: run `npm run dev` and visit http://localhost:3000/@NAMESPACE/SLUG to verify the chart renders.

Read, Write, Edit, Bash, WebFetch

- **Source** — a local file path (`./data/file.csv`) or a public URL (`https://…/data.csv`)

curl -fL "$SOURCE" -o "/tmp/$DATASET_SLUG.$EXT"

API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

# Pushing data needs write: request ?actions=read,write,verify (default is read-only, # pull). ?ttl=<secs> to tune. LFS_URL=$(curl -fsS -X POST "$API/v1/repos/<project-slug>/lfs-token?actions=read,write,verify" \

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

>   --ttl 3600 --algorithm RS256 --key-file ../../giftless/jwt_private_key) > git config lfs.url "https://_jwt:$TOKEN@lfs.portaljs.com/datopian/<project-slug>" > ```

> git config lfs.url "https://_jwt:$TOKEN@lfs.portaljs.com/datopian/<project-slug>"

`R2_PUBLIC_BASE` defaults to **`https://data.portaljs.com`** — the public read domain on the

`portaljs-giftless` R2 bucket (GET/HEAD + range + CORS, edge-cached). So the browser fetches `https://data.portaljs.com/lfs/datopian/<project-slug>/<oid>` directly. Override it only for an OSS self-host with its own bucket/domain (`export R

`https://data.portaljs.com/lfs/datopian/<project-slug>/<oid>` directly. Override it only for

Next: run `npm run dev` and visit http://localhost:3000/@NAMESPACE/DATASET_SLUG to verify,

Read, Write, Edit, Bash, WebFetch

organization (name + homepage) and a contact (name + email). Without them the feed is   emitted but **fails conformance** — the generator will say what's missing. - **Site URL** — the portal's public origin (e.g. `https://data.example.org`)

emitted but **fails conformance** — the generator will say what's missing. - **Site URL** — the portal's public origin (e.g. `https://data.example.org`), so feed   links are absolute. Without it links are root-relative (fine only for same-o

- **Site URL** — the portal's public origin (e.g. `https://data.example.org`), so feed

"contactPoint": { "fn": "<name>", "email": "<email>" },   "license": "<default license URI>",   "themes": ["http://publications.europa.eu/resource/authority/data-theme/GOVE"],

"license": "<default license URI>",   "themes": ["http://publications.europa.eu/resource/authority/data-theme/GOVE"],   "languages": ["http://publications.europa.eu/resource/authority/language/ENG"],

"themes": ["http://publications.europa.eu/resource/authority/data-theme/GOVE"],

"languages": ["http://publications.europa.eu/resource/authority/language/ENG"],

curl -s https://www.itb.ec.europa.eu/shacl/dcat-ap/api/validate      -H 'Content-Type: application/json' -H 'Accept: application/ld+json'      -d "$(python3 -c 'import json,sys;print(json.dumps({"contentToValidate":open("public/catalog.dcat

curl -s https://www.itb.ec.europa.eu/shacl/dcat-ap/api/validate \

(validation types from `.../shacl/dcat-ap/api/info`; also usable offline via   `pip install pyshacl` + the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases)).

`pip install pyshacl` + the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases)).

- **DCAT-US** — `pip install pyshacl` + the official   [DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl):   `pyshacl -s dcat-us_3.0_shacl_shapes.ttl -a public/catalog.dcat-u

[DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl):

`dcatap.3_0_1_base` on the ITB endpoint above, over `public/catalog.geodcat-ap.ttl`).   For the full spatial profile use the official   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHA

For the full spatial profile use the official   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl):   `pyshacl -s geodcat-ap-SHACL.ttl -df turtle -a public/catalog.geodcat-ap.ttl`

[GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl):

vocabularies; run with `-i rdfs` to clear the subclass ones. - **DCAT-AP_IT** — run the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/v

- **DCAT-AP_IT** — run the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))   over `public/catalog.dcat-ap-it.ttl` wit

([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))

over `public/catalog.dcat-ap-it.ttl` with any SPARQL engine, or `dcat-ap-it validate   public/catalog.dcat-ap-it.ttl` ([ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator)).   Errors are mandatory properties, warnin

public/catalog.dcat-ap-it.ttl` ([ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator)).

Errors are mandatory properties, warnings recommended ones. Before registering with   dati.gov.it, upload the Turtle to the official validator, https://validatore.dati.gov.it   (browser only).

dati.gov.it, upload the Turtle to the official validator, https://validatore.dati.gov.it

Read, Write, Edit, Bash, WebFetch

macOS:         brew install gdal tippecanoe duckdb   Debian/Ubuntu: sudo apt-get install -y gdal-bin duckdb    # tippecanoe: apt where available,                  else build from source — https://github.com/felt/tippecanoe

Debian/Ubuntu: sudo apt-get install -y gdal-bin duckdb    # tippecanoe: apt where available,

Debian/Ubuntu: sudo apt-get install -y gdal-bin duckdb    # tippecanoe: apt where available,                  else build from source — https://github.com/felt/tippecanoe   Windows:       not supported natively — use WSL (Ubuntu) and follow 

else build from source — https://github.com/felt/tippecanoe

### 4. Fetch (if URL) and detect the input format

curl -fL "$SOURCE" -o "/tmp/$DATASET_SLUG.$EXT"

API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

> then `git config lfs.url "https://_jwt:$TOKEN@lfs.portaljs.com/datopian/<project-slug>"`.

**Build the absolute R2 URL for each artifact** (`R2_PUBLIC_BASE` defaults to `https://data.portaljs.com`; object key = `lfs/datopian/<project-slug>/<oid>`):

`https://data.portaljs.com`; object key = `lfs/datopian/<project-slug>/<oid>`):

curl -sI -H "Range: bytes=0-0" "$GEOPARQUET_URL" | head -1   # expect: HTTP/… 206

Next: run `npm run dev` and open http://localhost:3000/@NAMESPACE/DATASET_SLUG — the map

Read, Write, Edit, Bash, WebFetch

mkdir -p PORTAL_DIR/public/data   cp SOURCE PORTAL_DIR/public/data/MAP_SLUG.geojson   # or for URLs: curl -L SOURCE -o PORTAL_DIR/public/data/MAP_SLUG.geojson

# or for URLs: curl -L SOURCE -o PORTAL_DIR/public/data/MAP_SLUG.geojson

useEffect(() => {     if (!url) return     fetch(url)

if (!url) return     fetch(url)       .then((r) => {

fetch(url)

>       <TileLayer         attribution='&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'

<TileLayer         attribution='&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'         url="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"

attribution='&copy; <a href="https://www.openstreetmap.org/copyright">OpenStreetMap</a> contributors'

url="https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png"

Next: run `npm run dev` and visit http://localhost:3000/@NAMESPACE/SLUG to verify the map renders.

Read, Write, Edit, Bash, WebFetch

mkdir -p PORTAL_DIR/public/data cp SOURCE PORTAL_DIR/public/data/RESOURCE_NAME.EXT # or for URLs: curl -L SOURCE -o PORTAL_DIR/public/data/RESOURCE_NAME.EXT

# or for URLs: curl -L SOURCE -o PORTAL_DIR/public/data/RESOURCE_NAME.EXT

Read, Write, Bash

Bash

bash scripts/portaljs-check-data-quality.sh "./data/trash.csv" bash scripts/portaljs-check-data-quality.sh "https://example.com/trash.csv"

bash scripts/portaljs-check-data-quality.sh "https://example.com/trash.csv"

Read, Write, Edit, Bash, WebFetch

- **CKAN base URL** (required) — e.g. `https://demo.dev.datopian.com`. The root of the

To connect a CKAN backend I need: 1. CKAN base URL (e.g. https://demo.dev.datopian.com)  — required

1. CKAN base URL (e.g. https://demo.dev.datopian.com)  — required

curl -s -m 20 "CKAN_URL/api/3/action/package_search?rows=1"

curl -s -m 20 "CKAN_URL/api/3/action/organization_show?id=ORG"

async function ckanAction(action: string, params: Record<string, string>): Promise<any> {   const qs = new URLSearchParams(params).toString()   const res = await fetch(`${DMS}/api/3/action/${action}?${qs}`)

const qs = new URLSearchParams(params).toString()   const res = await fetch(`${DMS}/api/3/action/${action}?${qs}`)   if (!res.ok) throw new Error(`CKAN ${action} failed: ${res.status} ${res.statusText}`)

const res = await fetch(`${DMS}/api/3/action/${action}?${qs}`)

Next: run `npm run dev` and visit http://localhost:3000, or run /portaljs-deploy to publish.

Read, Write, Edit, Bash

See [`lib/metadata/README.md`](https://github.com/datopian/portaljs/blob/main/examples/portaljs-catalog/lib/metadata/README.md)

Read, Write, Edit, Bash

[Credential-related source omitted]

AUTH="${PORTALJS_ARC_AUTH:-https://arc.portaljs.com}"

API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

const AUTH = process.env.PORTALJS_ARC_AUTH || 'https://arc.portaljs.com'

const API = process.env.PORTALJS_ARC_API || 'https://api.arc.portaljs.com'

async function main() {   const start = await fetch(`${AUTH}/device/code`, {

const start = await fetch(`${AUTH}/device/code`, {

if (Date.now() > deadline) throw new Error('Timed out waiting for authorization. Re-run /portaljs-deploy.')     await sleep(wait)     const poll = await fetch(`${AUTH}/device/token`, {

await sleep(wait)     const poll = await fetch(`${AUTH}/device/token`, {       method: 'POST',

const poll = await fetch(`${AUTH}/device/token`, {

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

rm -f /tmp/arc-login.mjs

After the flow completes, re-read `TOKEN` from `~/.portaljs/credentials` (snippet above) and continue to step 3. Non-interactive/CI: skip the browser flow by setting `PORTALJS_TOKEN` (mint a token in the dashboard at https://arc.portaljs.co

continue to step 3. Non-interactive/CI: skip the browser flow by setting `PORTALJS_TOKEN` (mint a token in the dashboard at https://arc.portaljs.com) — it takes precedence over the file. If the device flow can't run at all (no Node, fully o

(mint a token in the dashboard at https://arc.portaljs.com) — it takes precedence over the

To deploy to PortalJS Arc you need a token. Sign in at https://arc.portaljs.com and either:

[Credential-related source omitted]

(The API base URL defaults to `https://api.arc.portaljs.com`; override with `PORTALJS_ARC_API`

for staging. The auth worker defaults to `https://arc.portaljs.com`; override with

PORTAL_DIR="."          # ← portal directory (step 1) SLUG="my-portal"        # ← validated slug (step 1) API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

[Credential-related source omitted]

# Pass the bearer token via a 0600 curl config file, not argv — so it doesn't leak

[Credential-related source omitted]

[Credential-related source omitted]

HTTP=$(curl -s -o /tmp/arc-resp.json -w "%{http_code}" -m 120 -K "$HDR" \

rm -f "$HDR"

PORTAL_DIR="."                 # ← portal directory (step 1) DEPLOYMENT_ID="<from step 5's response>" API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

DEPLOYMENT_ID="<from step 5's response>" API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}" # TOKEN already resolved in step 5.

API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

rm -f "$FILELIST"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

HTTP=$(curl -s -o /tmp/arc-source-resp.json -w "%{http_code}" -m 300 -K "$HDR" \

rm -f "$HDR" /tmp/arc-source.tgz

✓ Deployed to PortalJS Arc   - URL:   https://SLUG.arc.portaljs.com

- URL:   https://SLUG.arc.portaljs.com

orphans at their old URLs. Pick the slug once; it's your portal's permanent address. - **Auth lives outside the repo.** The token is read from `PORTALJS_TOKEN` or   `~/.portaljs/credentials` — never commit it. `https://arc.portaljs.com` is 

- **Auth lives outside the repo.** The token is read from `PORTALJS_TOKEN` or   `~/.portaljs/credentials` — never commit it. `https://arc.portaljs.com` is where you sign in   and manage tokens.

`~/.portaljs/credentials` — never commit it. `https://arc.portaljs.com` is where you sign in

Read, Write, Edit, Bash, WebFetch

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

- URL ends in `.json` or contains `/data.json` → **dcat** (DCAT-US Project Open Data JSON). - URL contains `/api/explore/` → **ods**; `/api/catalog/` → **socrata**. - Otherwise probe CKAN: `curl -s -m 20 "SOURCE_URL/api/3/action/package_sea

- URL contains `/api/explore/` → **ods**; `/api/catalog/` → **socrata**. - Otherwise probe CKAN: `curl -s -m 20 "SOURCE_URL/api/3/action/package_search?rows=1"` →   if JSON with `"success": true`, it's **ckan**.

- Otherwise probe CKAN: `curl -s -m 20 "SOURCE_URL/api/3/action/package_search?rows=1"` →

- Else probe in turn: `SOURCE_URL/api/explore/v2.1/catalog/datasets?limit=1` (ods),   `SOURCE_URL/data.json` (dcat), then content-negotiate RDF:   `curl -fsSL -H "Accept: application/ld+json,text/turtle,application/rdf+xml" SOURCE_URL` — if

`SOURCE_URL/data.json` (dcat), then content-negotiate RDF:   `curl -fsSL -H "Accept: application/ld+json,text/turtle,application/rdf+xml" SOURCE_URL` — if   the body is JSON-LD/Turtle/RDF-XML (starts with `{`/`[`, `@prefix`/`PREFIX`, or `<?

`curl -fsSL -H "Accept: application/ld+json,text/turtle,application/rdf+xml" SOURCE_URL` — if

ask them to confirm the URL / pick the `--source` type — don't dead-end. (Socrata is read   through the central Discovery API, so for a Socrata site pass `--source socrata` with the   site root, e.g. `https://data.cityofnewyork.us`.)

site root, e.g. `https://data.cityofnewyork.us`.)

cd PORTAL_DIR curl -fsSL -H "Accept: application/ld+json,text/turtle,application/rdf+xml" \

curl -fsSL -H "Accept: application/ld+json,text/turtle,application/rdf+xml" \

Page the catalog: `https://api.us.socrata.com/api/catalog/v1?domains=<host>&limit=100&offset=…`

```bash      SLUG=<portal-slug>   # the portal's deploy slug (same one /portaljs-deploy uses)      API="${PORTALJS_ARC_API:-https://api.arc.portaljs.com}"

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

LFS_URL=$(curl -fsS -X POST "$API/v1/repos/$SLUG/lfs-token?actions=read,write,verify" \

[Credential-related source omitted]

# path = $R2_PUBLIC_BASE/lfs/datopian/<portal-slug>/<OID>      ```      `R2_PUBLIC_BASE` defaults to **`https://data.portaljs.com`** — the public read domain on

```      `R2_PUBLIC_BASE` defaults to **`https://data.portaljs.com`** — the public read domain on      the `portaljs-giftless` R2 bucket (GET/HEAD + range + CORS, edge-cached), so the browser

`R2_PUBLIC_BASE` defaults to **`https://data.portaljs.com`** — the public read domain on

[Credential-related source omitted]

Read, Write, Edit, Bash

rm -rf "./$PROJECT_SLUG/node_modules" "./$PROJECT_SLUG/.next"

✓ Branding: PortalJS placeholder mark (favicon + navbar logo) — swap the files in   public/ (icon.svg, favicon.ico, apple-touch-icon.png, icon-512.png) for your own. ✓ Run: cd PROJECT_SLUG && npm run dev  →  http://localhost:3000

✓ Run: cd PROJECT_SLUG && npm run dev  →  http://localhost:3000

Executable file

#!/usr/bin/env bash

rm -f "$TEMP_FILE"

url, out_path = sys.argv[1:3] with urllib.request.urlopen(url) as response, open(out_path, "wb") as out_file:

with urllib.request.urlopen(url) as response, open(out_path, "wb") as out_file:

#!/usr/bin/env bash

Install it (it's a single static binary, no runtime):   macOS:    brew install duckdb   Linux:    curl -L https://github.com/duckdb/duckdb/releases/latest/download/duckdb_cli-linux-amd64.zip -o duckdb.zip && unzip duckdb.zip

macOS:    brew install duckdb   Linux:    curl -L https://github.com/duckdb/duckdb/releases/latest/download/duckdb_cli-linux-amd64.zip -o duckdb.zip && unzip duckdb.zip   Other:    https://duckdb.org/docs/installation

Linux:    curl -L https://github.com/duckdb/duckdb/releases/latest/download/duckdb_cli-linux-amd64.zip -o duckdb.zip && unzip duckdb.zip

Other:    https://duckdb.org/docs/installation

Read, Write, Edit, Bash(ogr2ogr:*), Bash(ogrinfo:*), Bash(tippecanoe:*), Bash(duckdb:*), Bash(git:*), Bash(curl:*), Bash(jq:*), Bash(npx:*), Bash(node:*), Bash(mkdir:*), Bash(cp:*), Bash(wc:*), Bash(command:*), WebFetch

The canonical, full step-by-step workflow is [`.claude/commands/arcgis-to-portaljs.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/arcgis-to-portaljs.md)

[`.claude/commands/arcgis-to-portaljs.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/arcgis-to-portaljs.md)

| Symptom | Cause | Fix | | --- | --- | --- | | `MISSING_INPUT` | No Hub URL provided | Pass the site root (e.g. `https://hub-lewisville.opendata.arcgis.com`) and retry. |

| --- | --- | --- | | `MISSING_INPUT` | No Hub URL provided | Pass the site root (e.g. `https://hub-lewisville.opendata.arcgis.com`) and retry. | | `MISSING_TOOLS` | `ogr2ogr`/`tippecanoe`/`duckdb`/`jq` (or duckdb `spatial`) absent | Print 

| `MISSING_INPUT` | No Hub URL provided | Pass the site root (e.g. `https://hub-lewisville.opendata.arcgis.com`) and retry. |

/arcgis-to-portaljs https://hub-lewisville.opendata.arcgis.com slug=lewisville

/arcgis-to-portaljs https://streamwaterdata.co.uk --dry-run

/arcgis-to-portaljs https://streamwaterdata.co.uk --only sewer-catchments,water-boundaries --namespace-mode owner

- Full workflow: [`.claude/commands/arcgis-to-portaljs.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/arcgis-to-portaljs.md)

- Ongoing sync, parity dashboard, and cutover (Phase 3): [`references/sync-and-cutover.md`](references/sync-and-cutover.md) - Related skills: `portaljs-migrate`, `portaljs-add-geo`, `portaljs-add-dataset`, `portaljs-deploy` - ArcGIS REST qu

- ArcGIS REST query API: <https://developers.arcgis.com/rest/services-reference/enterprise/query-feature-service-layer/> · tippecanoe: <https://github.com/felt/tippecanoe> · DuckDB spatial: <https://duckdb.org/docs/extensions/spatial>

Detailed reference for the `arcgis-to-portaljs` skill. The executable workflow lives in [`.claude/commands/arcgis-to-portaljs.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/arcgis-to-portaljs.md).

[`.claude/commands/arcgis-to-portaljs.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/arcgis-to-portaljs.md).

`git lfs track "data/**"` → one commit → claim slug + mint Arc JWT → `git config lfs.url` → one push (bytes → Giftless/R2, no GitHub remote required) → `git lfs prune`. R2 URL = `${R2_PUBLIC_BASE:-https://data.portaljs.com}/lfs/datopian/<sl

one push (bytes → Giftless/R2, no GitHub remote required) → `git lfs prune`. R2 URL = `${R2_PUBLIC_BASE:-https://data.portaljs.com}/lfs/datopian/<slug>/<oid>`. OSS self-host signs locally with `giftless/mint-token.py`. Dual-tier `datasets.j

`${R2_PUBLIC_BASE:-https://data.portaljs.com}/lfs/datopian/<slug>/<oid>`. OSS self-host signs

{   "generatedAt": "2026-07-14T16:00:00Z",   "site": "https://hub-lewisville.opendata.arcgis.com",

"generatedAt": "2026-07-14T16:00:00Z",   "site": "https://hub-lewisville.opendata.arcgis.com",   "layers": {

"site": "https://hub-lewisville.opendata.arcgis.com",

"layers": {     "geo/parcels-hosted": {       "serviceUrl": "https://services2.arcgis.com/kXGqZY4GIOcEYxoF/arcgis/rest/services/Parcels_Hosted/FeatureServer/0",

"geo/parcels-hosted": {       "serviceUrl": "https://services2.arcgis.com/kXGqZY4GIOcEYxoF/arcgis/rest/services/Parcels_Hosted/FeatureServer/0",       "recordCount": 30694,

"serviceUrl": "https://services2.arcgis.com/kXGqZY4GIOcEYxoF/arcgis/rest/services/Parcels_Hosted/FeatureServer/0",

SVC="$serviceUrl"     # from the ledger # 1) Edit timestamp (authoritative when present). epoch ms. LIVE_EDIT=$(curl -sS -m30 "$SVC?f=json" | jq -r '.editingInfo.dataLastEditDate // .editingInfo.lastEditDate // empty')

# 1) Edit timestamp (authoritative when present). epoch ms. LIVE_EDIT=$(curl -sS -m30 "$SVC?f=json" | jq -r '.editingInfo.dataLastEditDate // .editingInfo.lastEditDate // empty') # 2) Live count (always available; the fallback + a second gu

LIVE_EDIT=$(curl -sS -m30 "$SVC?f=json" | jq -r '.editingInfo.dataLastEditDate // .editingInfo.lastEditDate // empty')

LIVE_COUNT=$(curl -sS -m30 "$SVC/query?where=1=1&returnCountOnly=true&f=json" | jq -r '.count')

sudo apt-get update

sudo apt-get install -y gdal-bin duckdb jq

# tippecanoe: prebuilt release or build from source (cache this step in practice)           sudo apt-get install -y build-essential libsqlite3-dev zlib1g-dev           git clone --depth 1 https://github.com/felt/tippecanoe /tmp/tippecanoe

sudo apt-get install -y build-essential libsqlite3-dev zlib1g-dev

sudo apt-get install -y build-essential libsqlite3-dev zlib1g-dev           git clone --depth 1 https://github.com/felt/tippecanoe /tmp/tippecanoe           make -C /tmp/tippecanoe -j2 && sudo make -C /tmp/tippecanoe install

git clone --depth 1 https://github.com/felt/tippecanoe /tmp/tippecanoe

make -C /tmp/tippecanoe -j2 && sudo make -C /tmp/tippecanoe install

Then wire them where the new portal is served: - **Cloudflare** (Arc is on Cloudflare): a [Bulk Redirect list](https://developers.cloudflare.com/rules/url-forwarding/bulk-redirects/), or `_redirects` for Pages-style hosting.

- **Cloudflare** (Arc is on Cloudflare): a [Bulk Redirect list](https://developers.cloudflare.com/rules/url-forwarding/bulk-redirects/), or `_redirects` for Pages-style hosting.

Read, Write, Edit, Bash(npm:*), Bash(npx:*)

Read, Write, Edit, Bash(npm:*), Bash(npx:*)

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md) —

[`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md) —

[`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md) —

- Full workflow: [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md)

- Full workflow: [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md)

- Chart-type and prop reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-map`, `portaljs-define-schema` - recharts documentation: <https://recharts.org/>

- Chart-type and prop reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-map`, `portaljs-define-schema` - recharts documentation: <https://recharts.org/>

- recharts documentation: <https://recharts.org/>

- recharts documentation: <https://recharts.org/>

Detailed reference for the `portaljs-add-chart` skill. The executable workflow lives in [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md).

Detailed reference for the `portaljs-add-chart` skill. The executable workflow lives in [`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md).

[`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md).

[`.claude/commands/portaljs-add-chart.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-chart.md).

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*), Bash(curl:*), Bash(mkdir:*), Bash(cp:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(git:*), Bash(curl:*), Bash(mkdir:*), Bash(cp:*), WebFetch

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md) —

[`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md) —

[`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md) —

Moves the file into `data/`, tracks it with Git LFS, pushes it to R2, and appends a manifest entry whose `file` is the resulting `https://data.portaljs.com/...` URL.

Moves the file into `data/`, tracks it with Git LFS, pushes it to R2, and appends a manifest entry whose `file` is the resulting `https://data.portaljs.com/...` URL.

entry whose `file` is the resulting `https://data.portaljs.com/...` URL.

entry whose `file` is the resulting `https://data.portaljs.com/...` URL.

/portaljs-add-dataset https://example.org/open-data/trade.csv namespace=trade

/portaljs-add-dataset https://example.org/open-data/trade.csv namespace=trade

/portaljs-add-dataset https://example.org/boundaries.geojson namespace=reference adopt=true

/portaljs-add-dataset https://example.org/boundaries.geojson namespace=reference adopt=true

- Full workflow: [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md)

- Full workflow: [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md)

- Manifest fields and routing details: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-chart`, `portaljs-add-map`, `portaljs-define-schema` - Git LFS documentation: <https://git-lf

- Manifest fields and routing details: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-chart`, `portaljs-add-map`, `portaljs-define-schema` - Git LFS documentation: <https://git-lf

- Git LFS documentation: <https://git-lfs.com/>

- Git LFS documentation: <https://git-lfs.com/>

Detailed reference for the `portaljs-add-dataset` skill. The executable workflow lives in [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md).

Detailed reference for the `portaljs-add-dataset` skill. The executable workflow lives in [`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md).

[`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md).

[`.claude/commands/portaljs-add-dataset.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dataset.md).

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(node:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(node:*), WebFetch

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md) —

[`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md) —

[`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md) —

/portaljs-add-dcat profiles=dcat-ap site=https://data.example.org

/portaljs-add-dcat profiles=dcat-ap site=https://data.example.org

/portaljs-add-dcat profiles=dcat-us site=https://data.example.gov

/portaljs-add-dcat profiles=dcat-us site=https://data.example.gov

/portaljs-add-dcat profiles=dcat-ap,dcat-ap-de site=https://daten.example.de

/portaljs-add-dcat profiles=dcat-ap,dcat-ap-de site=https://daten.example.de

- Full workflow: [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md)

- Full workflow: [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md)

- Profile registry, serialization formats, and validator details: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-define-schema`, `portaljs-new-portal`, `portaljs-deploy`, `portaljs-migrate` - DCAT specifica

- Profile registry, serialization formats, and validator details: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-define-schema`, `portaljs-new-portal`, `portaljs-deploy`, `portaljs-migrate` - DCAT specifica

- DCAT specification: <https://www.w3.org/TR/vocab-dcat-3/>

- DCAT specification: <https://www.w3.org/TR/vocab-dcat-3/>

Detailed reference for the `portaljs-add-dcat` skill. The executable workflow lives in [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md).

Detailed reference for the `portaljs-add-dcat` skill. The executable workflow lives in [`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md).

[`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md).

[`.claude/commands/portaljs-add-dcat.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-dcat.md).

- **DCAT-AP** — EU ITB SHACL validator REST API (`https://www.itb.ec.europa.eu/shacl/dcat-ap/api/validate`),

- **DCAT-AP** — EU ITB SHACL validator REST API (`https://www.itb.ec.europa.eu/shacl/dcat-ap/api/validate`),

`validationType: dcatap.3_0_1_base` for the harvest gate; or offline with `pip install pyshacl`   and the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases). - **DCAT-US** — `pip install pyshacl` + the

`validationType: dcatap.3_0_1_base` for the harvest gate; or offline with `pip install pyshacl`   and the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases). - **DCAT-US** — `pip install pyshacl` + the

and the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases).

and the [DCAT-AP SHACL shapes](https://github.com/SEMICeu/DCAT-AP/tree/master/releases).

- **DCAT-US** — `pip install pyshacl` + the   [DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl).   Requires an IRI-identified `dct:publisher` — a blank-node publisher is rej

- **DCAT-US** — `pip install pyshacl` + the   [DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl).   Requires an IRI-identified `dct:publisher` — a blank-node publisher is rej

[DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl).

[DCAT-US 3.0 SHACL shapes](https://raw.githubusercontent.com/DOI-DO/dcat-us/main/shacl/dcat-us_3.0_shacl_shapes.ttl).

Requires an IRI-identified `dct:publisher` — a blank-node publisher is rejected. - **GeoDCAT-AP** — validates as DCAT-AP for the harvest gate; full spatial profile via the   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-

Requires an IRI-identified `dct:publisher` — a blank-node publisher is rejected. - **GeoDCAT-AP** — validates as DCAT-AP for the harvest gate; full spatial profile via the   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-

- **GeoDCAT-AP** — validates as DCAT-AP for the harvest gate; full spatial profile via the   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl)   (run with `-i rdfs` to clear subc

- **GeoDCAT-AP** — validates as DCAT-AP for the harvest gate; full spatial profile via the   [GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl)   (run with `-i rdfs` to clear subc

[GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl)

[GeoDCAT-AP 3.0.0 SHACL shapes](https://semiceu.github.io/GeoDCAT-AP/releases/3.0.0/shacl/geodcat-ap-SHACL.ttl)

(run with `-i rdfs` to clear subclass-range warnings). - **DCAT-AP_IT** — the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/

(run with `-i rdfs` to clear subclass-range warnings). - **DCAT-AP_IT** — the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/

- **DCAT-AP_IT** — the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))   run with any SPARQL engine, or `dcat-ap-it v

- **DCAT-AP_IT** — the AgID SPARQL rules   ([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))   run with any SPARQL engine, or `dcat-ap-it v

([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))

([italia/daf-semantic-validator](https://github.com/italia/daf-semantic-validator/tree/master/dist/data/ontologies/agid/DCAT-AP_IT/validators/sparql))

run with any SPARQL engine, or `dcat-ap-it validate` from   [ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator); the   official check is https://validatore.dati.gov.it (browser upload).

run with any SPARQL engine, or `dcat-ap-it validate` from   [ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator); the   official check is https://validatore.dati.gov.it (browser upload).

[ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator); the

[ondata/dcat-ap-it-generator](https://github.com/ondata/dcat-ap-it-generator); the

official check is https://validatore.dati.gov.it (browser upload).

official check is https://validatore.dati.gov.it (browser upload).

Read, Write, Edit, Bash(ogr2ogr:*), Bash(ogrinfo:*), Bash(tippecanoe:*), Bash(duckdb:*), Bash(git:*), Bash(curl:*), Bash(npx:*), Bash(node:*), Bash(mkdir:*), Bash(cp:*), Bash(wc:*), Bash(command:*), WebFetch

Read, Write, Edit, Bash(ogr2ogr:*), Bash(ogrinfo:*), Bash(tippecanoe:*), Bash(duckdb:*), Bash(git:*), Bash(curl:*), Bash(npx:*), Bash(node:*), Bash(mkdir:*), Bash(cp:*), Bash(wc:*), Bash(command:*), WebFetch

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

[`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

[`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

print the per-OS install and stop. 3. Validate the portal directory and confirm the geo showcase components exist. 4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`.

print the per-OS install and stop. 3. Validate the portal directory and confirm the geo showcase components exist. 4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`.

3. Validate the portal directory and confirm the geo showcase components exist. 4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`. 5. Preserve the original, then normalize to EPSG:4326 GeoJSON with `ogr2ogr -t_srs

3. Validate the portal directory and confirm the geo showcase components exist. 4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`. 5. Preserve the original, then normalize to EPSG:4326 GeoJSON with `ogr2ogr -t_srs

4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`.

4. Fetch (if URL) and detect the input format; reject raster and bare `.shp`.

/portaljs-add-geo source=https://example.com/admin-boundaries.zip slug=admin-boundaries

/portaljs-add-geo source=https://example.com/admin-boundaries.zip slug=admin-boundaries

- Full workflow: [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

- Full workflow: [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md)

- Flags, thresholds, and the dual-tier manifest shape: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-map`, `portaljs-add-resource`, `portaljs-deploy` - tippecanoe: <https://gith

- Flags, thresholds, and the dual-tier manifest shape: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-map`, `portaljs-add-resource`, `portaljs-deploy` - tippecanoe: <https://gith

- tippecanoe: <https://github.com/felt/tippecanoe> · DuckDB spatial: <https://duckdb.org/docs/extensions/spatial>

- tippecanoe: <https://github.com/felt/tippecanoe> · DuckDB spatial: <https://duckdb.org/docs/extensions/spatial>

Detailed reference for the `portaljs-add-geo` skill. The executable workflow lives in [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md).

Detailed reference for the `portaljs-add-geo` skill. The executable workflow lives in [`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md).

[`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md).

[`.claude/commands/portaljs-add-geo.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-geo.md).

Install: macOS `brew install gdal tippecanoe duckdb`; Debian/Ubuntu `apt-get install gdal-bin duckdb` plus tippecanoe (apt where available, else build from [felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first

Install: macOS `brew install gdal tippecanoe duckdb`; Debian/Ubuntu `apt-get install gdal-bin duckdb` plus tippecanoe (apt where available, else build from [felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first

`apt-get install gdal-bin duckdb` plus tippecanoe (apt where available, else build from [felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first-cut — use WSL (Ubuntu) and follow the Debian path.

`apt-get install gdal-bin duckdb` plus tippecanoe (apt where available, else build from [felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first-cut — use WSL (Ubuntu) and follow the Debian path.

[felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first-cut —

[felt/tippecanoe](https://github.com/felt/tippecanoe)); Windows is unsupported first-cut —

Read, Write, Edit, Bash(npm:*), Bash(npx:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(npx:*), WebFetch

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md) — the

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md) — the

[`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md) — the

[`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md) — the

/portaljs-add-map source=https://example.com/districts.geojson slug=districts namespace=reference

/portaljs-add-map source=https://example.com/districts.geojson slug=districts namespace=reference

- Full workflow: [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md)

- Full workflow: [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md)

- Map props and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-chart`, `portaljs-define-schema` - react-leaflet documentation: <https://react-leaflet.j

- Map props and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-chart`, `portaljs-define-schema` - react-leaflet documentation: <https://react-leaflet.j

- react-leaflet documentation: <https://react-leaflet.js.org/>

- react-leaflet documentation: <https://react-leaflet.js.org/>

Detailed reference for the `portaljs-add-map` skill. The executable workflow lives in [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md).

Detailed reference for the `portaljs-add-map` skill. The executable workflow lives in [`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md).

[`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md).

[`.claude/commands/portaljs-add-map.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-map.md).

Read, Write, Edit, Bash(npm:*), Bash(curl:*), Bash(mkdir:*), Bash(cp:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(curl:*), Bash(mkdir:*), Bash(cp:*), WebFetch

The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md)

The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md)

[`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md)

[`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md)

2. Validate the portal and locate the dataset entry by slug (and namespace, if    given). If the dataset does not exist, offer `/portaljs-add-dataset` instead. 3. Detect the format from extension/Content-Type, fetch (check HTTP status) or

2. Validate the portal and locate the dataset entry by slug (and namespace, if    given). If the dataset does not exist, offer `/portaljs-add-dataset` instead. 3. Detect the format from extension/Content-Type, fetch (check HTTP status) or

given). If the dataset does not exist, offer `/portaljs-add-dataset` instead. 3. Detect the format from extension/Content-Type, fetch (check HTTP status) or    confirm the local path exists, then copy into `PORTAL_DIR/public/data/` under a

given). If the dataset does not exist, offer `/portaljs-add-dataset` instead. 3. Detect the format from extension/Content-Type, fetch (check HTTP status) or    confirm the local path exists, then copy into `PORTAL_DIR/public/data/` under a

3. Detect the format from extension/Content-Type, fetch (check HTTP status) or

3. Detect the format from extension/Content-Type, fetch (check HTTP status) or

| "Dataset not found" | `DATASET` slug/namespace doesn't match any entry in `datasets.json` | List datasets from `datasets.json` and ask the user to pick, or run `/portaljs-add-dataset` to create it | | `npx next build` fails with a JSON pa

| "Dataset not found" | `DATASET` slug/namespace doesn't match any entry in `datasets.json` | List datasets from `datasets.json` and ask the user to pick, or run `/portaljs-add-dataset` to create it | | `npx next build` fails with a JSON pa

| `npx next build` fails with a JSON parse error | Manually edited `datasets.json` has a trailing comma or unescaped character | Re-open the file, fix the JSON, and rebuild before reporting success | | Resource file fails to fetch (non-2xx)

| `npx next build` fails with a JSON parse error | Manually edited `datasets.json` has a trailing comma or unescaped character | Re-open the file, fix the JSON, and rebuild before reporting success | | Resource file fails to fetch (non-2xx)

| Resource file fails to fetch (non-2xx) | `SOURCE` URL is wrong, private, or the host is down | Confirm the URL in a browser or with `curl -I SOURCE`; ask for a corrected URL or a local path |

| Resource file fails to fetch (non-2xx) | `SOURCE` URL is wrong, private, or the host is down | Confirm the URL in a browser or with `curl -I SOURCE`; ask for a corrected URL or a local path |

/portaljs-add-resource climate-observations https://example.org/data/methodology.json --name methodology --title "Methodology notes"

/portaljs-add-resource climate-observations https://example.org/data/methodology.json --name methodology --title "Methodology notes"

- [`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) — canonical workflow this skill follows

- [`.claude/commands/portaljs-add-resource.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) — canonical workflow this skill follows

- [`references/reference.md`](references/reference.md) — resource entry fields, single-to-multi-resource layout, troubleshooting - Related skills: `/portaljs-add-dataset` (create a new dataset), `/portaljs-define-schema` (describe a resourc

- [`references/reference.md`](references/reference.md) — resource entry fields, single-to-multi-resource layout, troubleshooting - Related skills: `/portaljs-add-dataset` (create a new dataset), `/portaljs-define-schema` (describe a resourc

- [Frictionless Data — Data Package resources](https://datapackage.org/standard/data-resource/) — the data model this feature mirrors

- [Frictionless Data — Data Package resources](https://datapackage.org/standard/data-resource/) — the data model this feature mirrors

Companion reference for the [`/portaljs-add-resource`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) command —

Companion reference for the [`/portaljs-add-resource`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) command —

[`/portaljs-add-resource`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) command —

[`/portaljs-add-resource`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-add-resource.md) command —

## Instructions The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) —

## Instructions The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) —

The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) — that file is the single source of truth. Follow it when e

The canonical, full step-by-step workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) — that file is the single source of truth. Follow it when e

[`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) —

[`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md) —

## Resources - Full workflow: [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md)

## Resources - Full workflow: [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md)

- Full workflow: [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md)

- Full workflow: [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md)

- Reference: [`references/reference.md`](references/reference.md) - Decision framework: [`site/content/docs/architecture/decision-framework.md`](https://github.com/datopian/portaljs/blob/main/site/content/docs/architecture/decision-framewor

- Reference: [`references/reference.md`](references/reference.md) - Decision framework: [`site/content/docs/architecture/decision-framework.md`](https://github.com/datopian/portaljs/blob/main/site/content/docs/architecture/decision-framewor

- Decision framework: [`site/content/docs/architecture/decision-framework.md`](https://github.com/datopian/portaljs/blob/main/site/content/docs/architecture/decision-framework.md)

- Decision framework: [`site/content/docs/architecture/decision-framework.md`](https://github.com/datopian/portaljs/blob/main/site/content/docs/architecture/decision-framework.md)

Detailed reference for the `portaljs-architect` skill. The executable workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md).

Detailed reference for the `portaljs-architect` skill. The executable workflow lives in [`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md).

[`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md).

[`.claude/commands/portaljs-architect.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-architect.md).

Bash(curl:*), Bash(awk:*), Bash(sort:*), Bash(head:*), Bash(wc:*)

Bash(curl:*), Bash(awk:*), Bash(sort:*), Bash(head:*), Bash(wc:*)

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md) —

[`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md) —

[`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md) —

/portaljs-check-data-quality https://example.com/trash.csv

/portaljs-check-data-quality https://example.com/trash.csv

- Full workflow: [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md)

- Full workflow: [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md)

- Detailed check catalog and troubleshooting: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-define-schema` - Python `csv` module (parsing behavior this audit relies on): <https://do

- Detailed check catalog and troubleshooting: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-define-schema` - Python `csv` module (parsing behavior this audit relies on): <https://do

- Python `csv` module (parsing behavior this audit relies on): <https://docs.python.org/3/library/csv.html>

- Python `csv` module (parsing behavior this audit relies on): <https://docs.python.org/3/library/csv.html>

Detailed reference for the `portaljs-check-data-quality` skill. The executable workflow lives in [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality

Detailed reference for the `portaljs-check-data-quality` skill. The executable workflow lives in [`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality

[`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md).

[`.claude/commands/portaljs-check-data-quality.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-check-data-quality.md).

Read, Write, Edit, Bash(npm:*), Bash(npx:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(npx:*), WebFetch

- A scaffolded PortalJS portal (see `portaljs-new-portal`) with `package.json`, `pages/`,   `datasets.json`, `pages/search.tsx`, and `pages/[owner]/[slug].tsx` present. - A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.da

- A scaffolded PortalJS portal (see `portaljs-new-portal`) with `package.json`, `pages/`,   `datasets.json`, `pages/search.tsx`, and `pages/[owner]/[slug].tsx` present. - A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.da

`datasets.json`, `pages/search.tsx`, and `pages/[owner]/[slug].tsx` present. - A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.datopian.com`. - Node 18+ and npm available in the portal directory (no new packages are insta

`datasets.json`, `pages/search.tsx`, and `pages/[owner]/[slug].tsx` present. - A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.datopian.com`. - Node 18+ and npm available in the portal directory (no new packages are insta

- A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.datopian.com`.

- A CKAN base URL that is publicly reachable, e.g. `https://demo.dev.datopian.com`.

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md) —

[`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md) —

[`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md) —

/portaljs-connect-ckan url=https://demo.dev.datopian.com

/portaljs-connect-ckan url=https://demo.dev.datopian.com

/portaljs-connect-ckan url=https://demo.dev.datopian.com org=my-org

/portaljs-connect-ckan url=https://demo.dev.datopian.com org=my-org

/portaljs-connect-ckan url=https://data.example.gov group=education dir=./my-portal

/portaljs-connect-ckan url=https://data.example.gov group=education dir=./my-portal

- Full workflow: [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md)

- Full workflow: [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md)

- Client, filters, and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-dataset`, `portaljs-deploy` - CKAN Action API documentation: <https://docs.ckan.or

- Client, filters, and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-dataset`, `portaljs-deploy` - CKAN Action API documentation: <https://docs.ckan.or

- CKAN Action API documentation: <https://docs.ckan.org/en/latest/api/>

- CKAN Action API documentation: <https://docs.ckan.org/en/latest/api/>

Detailed reference for the `portaljs-connect-ckan` skill. The executable workflow lives in [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md).

Detailed reference for the `portaljs-connect-ckan` skill. The executable workflow lives in [`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md).

[`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md).

[`.claude/commands/portaljs-connect-ckan.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-connect-ckan.md).

Read, Write, Edit, Bash(npx:*), Bash(node:*), Bash(head:*)

Read, Write, Edit, Bash(npx:*), Bash(node:*), Bash(head:*)

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md) —

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md) —

[`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md) —

[`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md) —

- Full workflow: [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md)

- Full workflow: [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md)

- Field-type and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-dcat`, `portaljs-check-data-quality` - Frictionless Table Schema specification: <https:

- Field-type and troubleshooting reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-dcat`, `portaljs-check-data-quality` - Frictionless Table Schema specification: <https:

- Frictionless Table Schema specification: <https://datapackage.org/standard/table-schema/>

- Frictionless Table Schema specification: <https://datapackage.org/standard/table-schema/>

Detailed reference for the `portaljs-define-schema` skill. The executable workflow lives in [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md).

Detailed reference for the `portaljs-define-schema` skill. The executable workflow lives in [`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md).

[`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md).

[`.claude/commands/portaljs-define-schema.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-define-schema.md).

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(curl:*)

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(curl:*)

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 

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 

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 o

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 o

`https://SLUG.arc.portaljs.com` URL. Re-running redeploys the same portal (idempotent on

`https://SLUG.arc.portaljs.com` URL. Re-running redeploys the same portal (idempotent on

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md) — the

The canonical, full step-by-step workflow is [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md) — the

[`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md) — the

[`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md) — the

- **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

- **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

check passes. - **Result:** the portal is live at `https://SLUG.arc.portaljs.com`; re-running updates   the same slug in place.

check passes. - **Result:** the portal is live at `https://SLUG.arc.portaljs.com`; re-running updates   the same slug in place.

- **Result:** the portal is live at `https://SLUG.arc.portaljs.com`; re-running updates

- **Result:** the portal is live at `https://SLUG.arc.portaljs.com`; re-running updates

[Credential-related source omitted]

[Credential-related source omitted]

- Full workflow: [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md)

- Full workflow: [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md)

- Deploy internals reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-dataset`, `portaljs-connect-ckan` - PortalJS Arc dashboard (sign in, manage tokens): <https://arc.port

- Deploy internals reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-new-portal`, `portaljs-add-dataset`, `portaljs-connect-ckan` - PortalJS Arc dashboard (sign in, manage tokens): <https://arc.port

- PortalJS Arc dashboard (sign in, manage tokens): <https://arc.portaljs.com>

- PortalJS Arc dashboard (sign in, manage tokens): <https://arc.portaljs.com>

Detailed reference for the `portaljs-deploy` skill. The executable workflow lives in [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md).

Detailed reference for the `portaljs-deploy` skill. The executable workflow lives in [`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md).

[`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md).

[`.claude/commands/portaljs-deploy.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-deploy.md).

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

[Credential-related source omitted]

| `PORTALJS_ARC_API` | `https://api.arc.portaljs.com` | Deploy/whoami API base; override for staging. |

| `PORTALJS_ARC_API` | `https://api.arc.portaljs.com` | Deploy/whoami API base; override for staging. |

| `PORTALJS_ARC_AUTH` | `https://arc.portaljs.com` | Device-authorization worker; override for staging. |

| `PORTALJS_ARC_AUTH` | `https://arc.portaljs.com` | Device-authorization worker; override for staging. |

skill skips the gate automatically rather than failing. - **Repeated 401 after re-login** — the token was revoked server-side; sign in again at   <https://arc.portaljs.com> and confirm the account owns the slug.

skill skips the gate automatically rather than failing. - **Repeated 401 after re-login** — the token was revoked server-side; sign in again at   <https://arc.portaljs.com> and confirm the account owns the slug.

- **Repeated 401 after re-login** — the token was revoked server-side; sign in again at   <https://arc.portaljs.com> and confirm the account owns the slug. - **Upload times out** — the tarball is large; check `check-export` output for files

- **Repeated 401 after re-login** — the token was revoked server-side; sign in again at   <https://arc.portaljs.com> and confirm the account owns the slug. - **Upload times out** — the tarball is large; check `check-export` output for files

<https://arc.portaljs.com> and confirm the account owns the slug.

<https://arc.portaljs.com> and confirm the account owns the slug.

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(node:*), Bash(curl:*), Bash(git:*), WebFetch

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(node:*), Bash(curl:*), Bash(git:*), WebFetch

[Credential-related source omitted]

[Credential-related source omitted]

Full step-by-step workflow: [`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md).

Full step-by-step workflow: [`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md).

[`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md).

[`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md).

[Credential-related source omitted]

[Credential-related source omitted]

/portaljs-migrate --source ckan --source-url https://demo.dev.datopian.com \

/portaljs-migrate --source ckan --source-url https://demo.dev.datopian.com \

/portaljs-migrate --source dcat --source-url https://catalog.data.gov/data.json \   --target static --copy-mode download --org-filter epa-gov

/portaljs-migrate --source dcat --source-url https://catalog.data.gov/data.json \   --target static --copy-mode download --org-filter epa-gov

/portaljs-migrate --source dcat-rdf \   --source-url https://data.europa.eu/api/hub/search/catalog.jsonld \

/portaljs-migrate --source dcat-rdf \   --source-url https://data.europa.eu/api/hub/search/catalog.jsonld \

--source-url https://data.europa.eu/api/hub/search/catalog.jsonld \

--source-url https://data.europa.eu/api/hub/search/catalog.jsonld \

/portaljs-migrate --source ckan --source-url https://old-portal.example.org \

/portaljs-migrate --source ckan --source-url https://old-portal.example.org \

--target ckan --target-url https://new-portal.example.org --owner-org research

--target ckan --target-url https://new-portal.example.org --owner-org research

- Command source: [`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md)

- Command source: [`.claude/commands/portaljs-migrate.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md)

- Related skills: `/portaljs-connect-ckan`, `/portaljs-add-dcat`,   `/portaljs-check-data-quality`, `/portaljs-define-schema` - CKAN Action API reference: https://docs.ckan.org/en/latest/api/

- Related skills: `/portaljs-connect-ckan`, `/portaljs-add-dcat`,   `/portaljs-check-data-quality`, `/portaljs-define-schema` - CKAN Action API reference: https://docs.ckan.org/en/latest/api/

- CKAN Action API reference: https://docs.ckan.org/en/latest/api/

- CKAN Action API reference: https://docs.ckan.org/en/latest/api/

Field mappings, sink options, and troubleshooting detail for the [`/portaljs-migrate`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md) command. Read the

Field mappings, sink options, and troubleshooting detail for the [`/portaljs-migrate`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md) command. Read the

[`/portaljs-migrate`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md) command. Read the

[`/portaljs-migrate`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-migrate.md) command. Read the

[Credential-related source omitted]

[Credential-related source omitted]

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(cp:*), Bash(mkdir:*), Bash(git:*)

Read, Write, Edit, Bash(npm:*), Bash(npx:*), Bash(cp:*), Bash(mkdir:*), Bash(git:*)

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 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) —

[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md) —

[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md) —

- Full workflow: [`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md)

- Full workflow: [`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md)

- Template and token reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-chart`, `portaljs-add-map`, `portaljs-connect-ckan` - PortalJS documentation: <https://portaljs.org

- Template and token reference: [`references/reference.md`](references/reference.md) - Related skills: `portaljs-add-dataset`, `portaljs-add-chart`, `portaljs-add-map`, `portaljs-connect-ckan` - PortalJS documentation: <https://portaljs.org

- PortalJS documentation: <https://portaljs.org>

- PortalJS documentation: <https://portaljs.org>

Detailed reference for the `portaljs-new-portal` skill. The executable workflow lives in [`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md).

Detailed reference for the `portaljs-new-portal` skill. The executable workflow lives in [`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md).

[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md).

[`.claude/commands/portaljs-new-portal.md`](https://github.com/datopian/portaljs/blob/main/.claude/commands/portaljs-new-portal.md).

The skill defaults to a **remote** fetch (`npx tiged "datopian/portaljs/examples/portaljs-catalog#main"`)

The skill defaults to a **remote** fetch (`npx tiged "datopian/portaljs/examples/portaljs-catalog#main"`)