PortalJS: AI-native open-source framework for building data portals

PortalJS addresses a long-standing pain point in data infrastructure: most teams building data portals face a false choice between expensive, over-engineered data warehouses and fragile, unmaintainable script collections. The framework sidesteps this by recommending and automating a modern "open lakehouse" architecture (git for version control, Cloudflare R2 for object storage, Parquet files for columnar data, and DuckDB for serverless querying) that is simpler and cheaper than traditional warehouses while remaining scalable and maintainable.

The key innovation is pairing an agentic advisor (/portaljs-architect) with automated scaffolding skills. Rather than generating UI code alone, the framework first helps teams think through their infrastructure needs—data volume, update frequency, governance requirements, and standards compliance—and recommends an appropriate stack before writing any code. This advisory layer addresses a critical gap: many teams build portals without clear thinking about data architecture, leading to misaligned choices downstream.

By emitting plain Next.js code with no lock-in, PortalJS avoids the trap of proprietary portal platforms that become hard to customize or exit. The open-source MIT license and the decoupled DataProvider contract (allowing swaps from static files to CKAN to custom backends without touching UI code) reinforce this philosophy. The 15+ Claude Code skills—handling everything from architecture to dataset ingestion, geospatial data, schema inference, DCAT publishing for standards compliance, and migrations from ArcGIS or Socrata—indicate that the project is designed to be extended rather than rigid.