var-persist/README.md
ztimson 43b11ab295
All checks were successful
Build / Build NPM Project (push) Successful in 46s
updated readme
2023-12-19 23:08:37 -05:00

3.8 KiB


Logo

Persist

Typescript Library to Sync Variables with LocalStorage

Version Pull Requests Issues



Table of Contents

About

Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum.

Demo

Website: https://git.zakscode.com

Built With

TypeScript

Setup

Production

Prerequisites

Instructions

  1. Install persist: npm i ztimson/persist
  2. Enable decorators inside tsconfig.json:
{
	"compilerOptions": {
		"experimentalDecorators": true,
		...
	},
	...
}
  1. Use persist:
import {Persist, persist} from 'ztimson/persist';

let theme = new Persist<string>('theme', {default: 'os'});
theme.value = 'light'; // Any changes will be synced to localStorage['theme'];
// You have to access/modify your data through the `value` property while using the Persist object

// Or via decorator
class Theme {
	// We are overriding the default key to use the same localStorage as above
	@persist({key: 'theme', default: 'os'}) current!: string;
}
theme = new Theme();
console.log(theme.current); // Output: light
theme.current = 'dark'; // You can ommit `.value` when using the decorator

Development

Prerequisites

Instructions

  1. Install the dependencies: npm i
  2. Build library & docs: npm build
  3. Run unit tests: npm test

License

Copyright © 2023 Zakary Timson | Available under MIT Licensing

See the license for more information.