portaljs-add-dataset

Featured

Add a dataset (CSV, TSV, JSON, or GeoJSON) to an existing PortalJS portal. Appends an entry to datasets.json so the catalog and showcase render it automatically; routes the data by source (local file vs remote URL) — R2 via Git LFS by default, remote URLs by passthrough. Use when registering a new dataset in a scaffolded portal.

Data & Documents 2,343 stars 334 forks Updated today MIT

Install

View on GitHub

Quality Score: 99/100

Stars 20%
100
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# PortalJS — Add Dataset ## Overview Register a dataset in a PortalJS (`portaljs-catalog`) portal. The skill appends one entry to `datasets.json` — the single source of truth for the catalog — and routes the underlying bytes by **source first, then size**: a local file defaults to R2 via Git LFS, a remote URL defaults to passthrough (no copy). No per-dataset page is created; the catalog at `/search` lists the new entry and the dynamic showcase route `pages/[owner]/[slug].tsx` renders it automatically at `/@<namespace>/<slug>`. Supported formats for the showcase preview: CSV, TSV, JSON (array), and GeoJSON. ## Prerequisites - A scaffolded PortalJS portal (see `portaljs-new-portal`) with `datasets.json`, `package.json`, and `pages/[owner]/[slug].tsx` present. - The source data: a local file path or a publicly reachable URL. - For the R2/Git LFS default route: `git` and `git-lfs` installed, and an Arc account token (or an OSS Giftless key) to mint a push-scoped LFS credential. - Node 18+ and npm available in the portal directory. ## Instructions 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 single source of truth. Read and follow it when executing. Summary: 1. Gather input from `$ARGUMENTS` — source (file path or URL), portal directory (default `.`), dataset name/slug, description, namespace. If the source is missing, interview ...

Details

Author
datopian
Repository
datopian/portaljs
Created
14 years ago
Last Updated
today
Language
TypeScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category