@parqui/react

High-performance React Parquet file viewer component for Apache Parquet datasets. Includes virtual scrolling data grid, filtering, sorting, grouping, search, and column controls.

Why @parqui/react

• Plug-and-play Parquet viewer for React 18/19
• Virtualized table for large parquet files
• Built-in filtering, multi-sort, grouping, and quick search
• Keyboard navigation and interactive column management
• Fully client-side: inspect parquet data without server uploads

Installation

npm install @parqui/react

Peer dependencies:

• react ^18 || ^19
• react-dom ^18 || ^19

Quick Start

import { Parkui } from "@parqui/react";

export function App() {
  return (
    <div style={{ height: "80vh" }}>
      <Parkui />
    </div>
  );
}

Open behavior:

• If no source is passed, users can open a local .parquet file via the built-in UI.
• You can pass a predefined source from @parqui/core for controlled integrations.

import { Parkui } from "@parqui/react";
import { sourceFromUrl } from "@parqui/core";

const source = sourceFromUrl("https://example.com/data/events.parquet");

export function App() {
  return <Parkui source={source} />;
}

Key Props

• source: predefined parquet source (File, URL source, or custom ParquetSource)
• columns: limit visible columns
• allowOpen: enable/disable built-in file open flow
• showToolbar: show/hide toolbar with search and pipeline chips
• onMetadataLoad: callback when parquet metadata is available
• onRequestOpen: custom open handler for desktop/in-app file pickers

Package Ecosystem

• Core engine: @parqui/core
• Vue wrapper: @parqui/vue
• Angular wrapper: @parqui/angular

Links

• Website: parqui.dev

License

Business Source License 1.1 (BUSL-1.1). See LICENSE.