https://github.com/bholmesdev/simplestack-store
https://github.com/bholmesdev/simplestack-store
Last synced: about 1 month ago
JSON representation
- Host: GitHub
- URL: https://github.com/bholmesdev/simplestack-store
- Owner: bholmesdev
- License: mit
- Created: 2025-09-02T13:58:28.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-12-27T20:51:55.000Z (2 months ago)
- Last Synced: 2025-12-29T19:10:18.464Z (2 months ago)
- Language: TypeScript
- Size: 85.9 KB
- Stars: 235
- Watchers: 2
- Forks: 17
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Simple Store
[](https://www.youtube.com/watch?v=gXz-lLIJbMI)
A simple, `select`-xcellent state management library for React.
The goal: make a storage solution as powerful as Zustand or Redux, without complicated functions to set and select state.
Here's an overview of how stores are created, and how you can operate on parts of a store using `.select()`:
```tsx
import { store } from "@simplestack/store";
import { useStoreValue } from "@simplestack/store/react";
// Define your store with an initial state
const documentStore = store({
title: "Untitled",
authors: ["Ada", "Ben"],
meta: {
pages: 3,
tags: ["draft", "internal"],
},
});
function Document() {
// Update your UI with the store's current state
const {
title,
meta: { tags },
} = useStoreValue(documentStore);
return (
{title} {tags.join(", ")}
);
}
// Or, select parts of a store to listen to individually
const titleStore = documentStore.select("title");
const tagsStore = documentStore.select("meta").select("tags");
function Title() {
// And scope updates with selected stores for fine-grained control
const title = useStoreValue(titleStore);
return (
titleStore.set(e.target.value)} />
);
}
```
📚 For a complete usage guide and API reference, [visit our documentation](https://simple-stack.dev/store).
## Contributing
We are open to contributions! **Before submitting your feature request**, please read the [CONTRIBUTING.md](CONTRIBUTING.md) for our issue and PR process.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.