Medical Protocol Tracker (Android, iOS, Codename One)

A small Codename One app to track a customizable medical/wellness protocol defined in a JSON file hosted at a public URL.

The app downloads the JSON when it starts, stores it locally, and shows each protocol item with a configurable number of checkboxes (times) to mark repetitions during the day.

Example of use for a diet program

Why this project exists

This was originally built for personal use and then minimally cleaned up so it can be shared publicly and reused as a template.

Key features

• Remote JSON configuration (HTTP/HTTPS URL)
• Local caching in Codename One Storage
• Daily checkbox state saved in Preferences
• Automatic daily reset of checkboxes
• Simple UI (Codename One form + CSS theme)

JSON format (example)

{
  "title": "Example protocol",
  "description": "Daily schedule for a customizable protocol.",
  "items": [
    { "id": 1, "item": "Medication A (morning)", "times": 1 },
    { "id": 2, "item": "Hydration (250 ml)", "times": 8 },
    { "id": 3, "item": "Light walk", "times": 1 }
  ],
  "footer": "Demo data only. Customize with your clinician."
}

Configuration

In common/src/main/java/net/informaticalibera/protocollo/Protocollo.java:

• JSON_URL points to the public JSON URL to download
• JSON_FILE is the local cached filename in app storage

By default, JSON_URL is set to a generic placeholder:

• https://example.com/path/to/alimentazione.json

Replace it with your own public URL.

Included demo file

This repository includes a generic demo alimentazione.json file to show the expected structure.

Build notes

This is a standard multi-module Codename One Maven project. You can build/run it with the generated scripts or Maven/Codename One tooling (Eclipse, IntelliJ, NetBeans).

The original README.adoc generated by Codename One was renamed to CodenameOne-README.adoc.

Important privacy/security note

Before publishing your own fork, make sure any signing certificates, keystores, passwords, API keys, and personal data are removed or replaced with placeholders.