Introduction
ZLister is an application for managing to-do lists. Users can create lists and populate the lists with any number of entries. An entry may be marked as incomplete or complete and quickly toggled between the two states.
ZLister solely stores data on the user's device. The data may be exported for transfer or backup and then imported on the same device or another.
Privacy and Security
ZLister is a progressive web application that runs within a browser on the user's device, although it may appear to be a native application. After installation, the application runs from stored data and does not require network connectivity.
Data is stored within the device's local storage. Data is not encrypted by the application, although the underlying disk or browser's interface may encrypt the data at rest. If the user exports their list data, the resulting file is an ordinary file formatted in JSON without any encryption applied.
Lists and Entries
Below is the start page for the application. Users can click on a list to manage its entries, create new lists, and by opening the triangle, perform unusual operations like exporting and importing data and managing deleted data (trash).
Within a list (in the below example, "Shopping"), users can create entries, mark them complete or as a 'to do' item. By clicking the ⌘ icon, users can rename entries or delete them.
Importing and Exporting Data
Controls for exporting and importing data are under "Lists Admin" / "Operations" on the start page. Data is exported as a JSON file which the user can save on their device and transfer as they wish. When importing data, lists and entries are matched based on their unique id, rather than their name. An import will override matching data, even if the existing data is more recent.
Installation / Updating the Application
Installing a PWA depends on the user's browser. The short version is:
- Visit https://zlister.ztoz.blog
- Click the Install icon in the URL bar
Mozilla provides more detailed instructions.
Not all devices and browsers support installing progressive web applications. However, this application should work without installing it as long as you have internet connectivity to fetch the application code.
To update the application, go to the About screen and click the 'Clear Application Code Cache' button. After the cache is cleared (this message should appear immediately), navigate back to the start page and the application will install a new version of the application.