README.md

Mosaic Playground

Edit and explore Mosaic visualizations in your browser. Inspired by the Vega Editor.

You can upload your CSV files, write JSON visualization specifications with autocomplete, see your visualization update in real-time, and interact with charts of large datasets.

Features:

• Add or upload local CSV, Parquet, or Arrow files to visualize
• View and edit example specs from the Mosaic website
• Download JSON or YAML specs and SVG or PNG charts
• Autocomplete for Mosaic JSON specs using JSON schema
• Supports JSON or YAML specs and examples, can switch between the formats while editing.
• Re-renders the chart when the spec changes. Keeps the last working version when there is an error
• View underlying DuckDB queries in side panel
• Shows errors (Mosaic parse, Mosaic render) as toasts and in the console
• All visualizations are computed locally in your browser

Limitations:

• Doesn't support formatting or autocomplete for YAML specifications (see issues.md and upstream issue with @monaco-editor/react)
• Does not show certain query errors like Binder Error: Referenced column "b" not found in FROM clause! (probably because they are inside an uncaught promise, may be an issue with Mosaic)

TODOs:

• Support uploading JSON files
• Simplify UploadData component, maybe using react-dropzone.
• Refactor out components like MosaicProvider and logic like the exportChart function so it can be used by third-party apps
• Add docs with typedoc

Uses

• Mosaic
• Observable Plot
• DuckDB WASM
• duckdb-wasm-kit
• @monaco-editor/react
• Chakra UI
• SaaS UI
• Vite
• create-vite
• SWC

License

Apache-2.0