Thyroid TNM Tool

Product-style PC and mobile web app for thyroid cancer TNM staging, treatment planning, and follow-up reference.

简体中文 | English

Overview

Thyroid TNM Tool packages a single-file clinical HTML interface into a deliverable product with a public GitHub repository, standalone HTML downloads, GitHub Pages deployment, and automated release workflows.

It now provides two separate web entry points:

• PC web version: preserves the original desktop-style layout
• Mobile web version: a separate mobile.html optimized for phone browsers

Screenshots

PC web version

Mobile web version

Why this project is useful

• Fast AJCC 8th edition thyroid cancer staging lookup
• Treatment planning and follow-up suggestions in the same screen
• No backend, no installation required for web usage
• Can be opened online or downloaded as a standalone HTML file
• Keeps PC and mobile experiences separate instead of forcing one responsive compromise

Access

• GitHub repository: https://github.com/liqi3333/thyroid
• PC web page: https://liqi3333.github.io/thyroid/
• Mobile web page: https://liqi3333.github.io/thyroid/mobile.html
• Latest release: https://github.com/liqi3333/thyroid/releases/latest
• All releases: https://github.com/liqi3333/thyroid/releases

Delivery formats

The repository currently ships these forms:

• index.html, original PC web version
• mobile.html, mobile web entry kept in sync with the latest bilingual follow-up build
• Release asset: Thyroid-TNM-Tool-2.1.0.html
• Release asset: Thyroid-TNM-Tool-mobile-2.1.0.html

Quick Start

Use online

• Open the PC page: https://liqi3333.github.io/thyroid/
• Open the mobile page: https://liqi3333.github.io/thyroid/mobile.html

Download standalone HTML

Download the latest files from:

• https://github.com/liqi3333/thyroid/releases/latest

Then open either HTML file directly in a browser.

Build locally

npm run build:html

Build outputs:

dist-html/Thyroid-TNM-Tool-2.1.0.html
dist-html/Thyroid-TNM-Tool-mobile-2.1.0.html

Product highlights

• Thyroid cancer TNM staging interface
• Treatment plan and follow-up recommendation panel
• Standalone offline-friendly HTML distribution
• Separate PC and mobile web entry points
• Public GitHub Pages deployment
• Automated GitHub Actions build and release workflow
• Bilingual project documentation

Release automation

This repository includes GitHub Actions workflows for delivery automation.

• Push to main: build validation and upload HTML artifacts
• Push a tag such as v2.1.0: generate desktop and mobile standalone HTML files, then publish them to GitHub Releases
• GitHub Pages serves both index.html and mobile.html

Example:

git tag v2.1.0
git push origin v2.1.0

Project structure

.
├── docs/
│   └── RELEASE_TEMPLATE.md
├── scripts/
│   └── build-html-release.js
├── index.html
├── mobile.html
├── package.json
├── README.md
├── README.zh-CN.md
└── .github/workflows/
    ├── build-html.yml
    └── release.yml

Notes

• This repository currently focuses on web delivery only, not EXE packaging
• Medical content is for informational use only and does not replace formal clinical decision-making