Skip to content

Toolkit for using data in JavaScript.

License

Notifications You must be signed in to change notification settings

dhoulb/shelving

Repository files navigation

Shelving: toolkit for using data in JavaScript

Semantic Release Conventional Commits Prettier GitHub Actions npm

Shelving is a toolkit for using data in JavaScript and TypeScript, including:

Note: The 1.x branch of Shelving is in active development and is not observing semver for breaking changes (from 2.x onward semver will be followed).

  • Schemas (validation)
  • Databases (via providers including in-memory, Firestore, IndexedDB)
  • Querying (sorting, filtering, slicing)
  • Store (events and state)
  • React (hooks and state)
  • Helpers (errors, arrays, objects, strings, dates, equality, merging, diffing, cloning, debug)

Installation

Install via npm or yarn:

npm install shelving
yarn add shelving

Import from Skypack CDN (the ?dts enables TypeScript types in Deno):

import { Database } from "https://cdn.skypack.dev/shelving";
import { Database } from "https://cdn.skypack.dev/shelving?dts";

Usage

Shelving is an ES module supporting import { Query } from "shelving"; syntax and can be used natively in systems/browsers that support that (e.g. Chrome 61+, Deno, Node 12+).

Shelving does not include code for CommonJS require() imports, so using it in older projects will require transpiling.

Modules

Shelving is created from small individual modules which can be imported individually (using e.g. import { addProp } from "shelving/object). Modules marked with are also re-exported from the main "shelving" module.

@todo Write these docs!

Changelog

See Releases