Skip to content

Work-in-progress successor to Dataview with a focus on UX and speed.

License

Notifications You must be signed in to change notification settings

blacksmithgu/datacore

Repository files navigation

Datacore

Datacore is a work-in-progress re-imagining of Dataview with a focus on 2-10x better query and rendering performance, as well as fully interactable views.

Documentation

You can find the current documentation at https://blacksmithgu.github.io/datacore/.

Roadmap

Datacore is a work in progress. For more details, check out the roadmap.

Differences from Dataview

Datacore is fundamentally the same thing as dataview - an index over Markdown files that supports live-updating views and metadata. However, Datacore focuses on substantial index changes for performance, as well as a new sleek UI which completely replaces traditional Dataview queries. Datacore supports all query operations that Dataview does, with some extra functionality.

  • New Javascript API: Javascript-based views are now React-based and support internal state, flickerless updates on index changes, and a new query API which is much more performant than dv.pages().where(...).
  • WYSIWYG Views: Datacore queries now use a responsive table view and can be manipulated with a table editor much more akin to what you would see in places like Notion and Airtable.
  • Functioning Embeds: Markdown page, image, and video embeds now work in all views, and a new special view type which is just a list of embeds has been added.
  • Live Editing: Values inside of table views can now be edited; task views include more nuanced rendering of metadata like due date and more operations for manipulating tasks directly.
  • Section / Block Queries: Datacore indexes all files (including attachments, PDFs, and images), and supports queries at section and block level granularity.

Compiling & Building

You can do a first-time setup of the repository by making sure you have yarn installed and then just running

yarn install
yarn run build

This will invoke esbuild under the hood and dump the final plugin into the /build directory. There is a short script which can then copy the compiled plugin into your vault -

./scripts/install-built /path/to/your/vault/root

You can combine the build and install into a single command:

yarn run build && ./scripts/install-built /path/to/your/vault/root

Formatting & Running Tests

You can format your code via

yarn run format

And you can run jest tests via

yarn run test

Contributing

Discord: https://discord.gg/KwZUX4BYba.

Contributions are welcome; for large contributions, we recommend reaching out via email or discord to make sure what you are trying to implement is reasonable / feasible!