gjendje

gjendje is a storage-agnostic state management library for TypeScript and JavaScript. It gives you a single, unified API for reactive state — regardless of where that state lives.

Learn more

Install

npm install gjendje

Quick start

import { state } from 'gjendje'

const store = state({ count: 0 })

// set
store.set({ count: 1 })

store.set((prev) => ({ ...prev, count: prev.count + 1 }))

// get
store.get()

const { count } = store.get()

// reset
store.reset()

Examples

Framework Bindings

React

import { state } from 'gjendje'
import { useGjendje } from 'gjendje/react'

const counter = state({ counter: 0 })

function Counter() {
  const [count, setCount, resetCount] = useGjendje(counter)

  return <button onClick={() => setCount(prev => prev + 1)}>{count}</button>
}

React guide

Vue

<script setup>
  import { state } from 'gjendje'
  import { useGjendje } from 'gjendje/vue'

  const counter = state({ counter: 0 })

  const count = useGjendje(counter)
</script>

<template>
  <button @click="count++">{{ count }}</button>
</template>

Vue guide

Svelte

<script>
  import { state } from 'gjendje'
  import { useGjendje } from 'gjendje/svelte'

  const counter = state({ counter: 0 })

  const count = useGjendje(counter)
</script>

<button on:click={() => $count++}>
  {$count}
</button>

Svelte guide

API

get, peek, set, patch, mutate, reset, destroy, subscribe, watch, intercept, onChange

API reference

Primitives

computed, select, previous, readonly, collection, effect, when, resource, channel, toSignal, fromSignal

Primitives reference

Scopes

memory, local, session, url, bucket, server

Scope guide

Utilities

batch, snapshot, destroyAll, withHistory, withWatch, withServerSession

Utilities reference

DevTools

DevTools guide

Configure

scope, maxKeys, prefix, requireValidation, registry, ssr, sync, warnOnDuplicate, onChange, onDestroy, onError, onExpire, onHydrate, onIntercept, onMigrate, onQuotaExceeded, onRegister, onReset, onSync, onValidationFail

Configure guide

License

MIT

Icon

Created by Gulraiz