Skip to content

dotCooCoo/deliriumtool

deliriumtool.com

Bedside reference for ICU delirium — screening, prevention, and management at the point of care.

Reference aid only. This tool supports — it does not replace — clinical judgment, local protocol, and prescriber/pharmacy review. It is not a validated decision-support device, a diagnostic instrument, or an order set. Verify every recommendation against the cited primary sources and your institution's policy. Provided "as is", without warranty.

What it does

  • Risk factors — a predisposing + precipitating checklist. The tally is a non-validated heuristic and points you to the validated PRE-DELIRIC / E-PRE-DELIRIC models.
  • CAM-ICU + RASS — the four-feature CAM-ICU flow with RASS level and motor-subtype.
  • ABCDEF bundle — the ICU Liberation prevention bundle as a working checklist.
  • DELIRIUM(S) — a causative-factor review mnemonic.
  • Treatment — the CAM-positive algorithm: treat causes → intensify non-pharm → pharmacologic safety options.
  • Medications — pharmacologic options with cautions, plus a deliriogenic-medication review.
  • Documents — print-ready PDFs generated entirely in the browser.

Privacy

Everything runs in your browser. The tool captures no patient identifier, sends nothing to a server, makes no third-party network requests, and includes no analytics. Anything you type stays on your device unless you choose to export or share it. Shareable links carry only de-identified content and are never stored server-side. Do not enter PHI into fields you intend to share.

Run it locally

npm install
npm run dev      # builds, then serves with Wrangler at the printed localhost URL

After npm run build, the contents of dist/ are a self-contained static site — you can also open dist/index.html directly; it works offline.

Pre-configuring protocol settings (settings.json)

A self-hosted copy can ship a default protocol configuration. When served over http(s), the app reads a settings.json placed next to the page (e.g. https://your-host/settings.json) and applies it to the Setup tab — screening tool, RASS target, review cadence, and the governance fields. Generate one from Setup → Save settings (it downloads settings.json), then drop it beside index.html.

  • These are unit/protocol settings only — never patient data. Values are validated on load: unknown keys are ignored, lengths are bounded, and dropdowns are constrained to their allowed options.
  • To use a different filename, add a same-origin <meta name="settings-src" content="my-unit.json"> to index.html.

Tests

npm test         # data-accuracy unit tests + Playwright (functional, a11y, visual)
npm run test:unit
npm run test:e2e

Deploy (Cloudflare)

A static site served by Cloudflare Workers (Static Assets), via Wrangler.

npm run deploy   # or connect the repository for push-to-main deploys

Clinical basis

Instruments, thresholds, and citations are documented in docs/CLINICAL_METHODOLOGY.md, with a citation index in references/INDEX.md. Corrections backed by a primary source are very welcome — see CONTRIBUTING.md.

License & attribution

This repository's own code and documentation are released under the MIT License (© 2026 dotCooCoo) — free to use, modify, and distribute, provided the copyright and licence notice are retained. The clinical instruments it references (CAM-ICU, RASS, ICDSC, the ABCDEF/ICU Liberation bundle, PRE-DELIRIC, and others) are the work and copyright of their respective authors and are used as cited; see docs/CLINICAL_METHODOLOGY.md. The MIT "as is, no warranty" terms are separate from — and do not replace — the clinical disclaimer that this is a reference aid only, not a validated decision-support device.

Contributing & security

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors