AJCC 8th breast cancer anatomic/prognostic staging and treatment follow-up decision support, with desktop, desktop web, and mobile web delivery.
简体中文 | English
This repository packages a single-file clinical interface for breast cancer staging and treatment support into three delivery forms:
- Windows portable EXE
- desktop standalone HTML / GitHub Pages web app
- mobile standalone HTML
The latest desktop web update is v1.4.0, focused on AJCC 8th edition staging and comprehensive treatment follow-up decision support.
- AJCC 8th anatomic staging (Table 8): T1-4, N0-3, M0-1 combinations with proper handling of T1mi, N1mi, N3 and M0(i+)
- Clinical & Pathologic prognostic staging (Tables 9-10): automatic lookup based on T/N/M group, grade, HER2, ER, PR
- Post-neoadjuvant support: cTNM/pTNM/ycTNM/ypTNM with proper pCR notation (ypT0/is ypN0 does not assign stage group)
- HER2 equivocal handling: automatically treats as negative per AJCC, with alert for formal reassessment
- Auto-infer Luminal subtype (A/B HER2-, B HER2+, HER2-enriched, TNBC) from ER/PR/HER2/Ki-67/Grade
- Ki-67 intermediate zone (10-19%) explicitly flagged for MDT discussion
- HER2-low/ultralow, PD-L1 CPS, genotypic testing (BRCA, PIK3CA, ESR1) for advanced therapy hints
- Direct recommendations: color-coded decision cards (yes/maybe/no) for surgery, chemotherapy, endocrine, targeted, immunotherapy, PARP
- Regimen tables: HR+/HER2-, HER2+, TNBC-specific chemotherapy, CDK4/6, anti-HER2, immunotherapy, post-neoadjuvant escalation/de-escalation options
- Drug pools: organized by category (chemo, endocrine, anti-HER2/ADC, targeted, immunotherapy, bone support)
- Early vs. metastatic branching: M1 triggers IV-stage pathway with stage-specific systemic therapy guidance
- Genomic intelligence: Oncotype DX RS interpretation, MammaPrint risk stratification, PARP/CDK4/6 eligibility assessment
- Bilingual: Full English/Chinese interface with context-sensitive explanations
- Print/Export settings: checkbox-based module selection for PDF, Word, Excel output
- Collapsible UI: section collapse, help text toggle, settings modal for customization
- Desktop web: https://liqi3333.github.io/breast/
- Mobile web: https://liqi3333.github.io/breast/mobile.html
- Latest release: https://github.com/liqi3333/breast/releases/latest
From the latest release you can download:
- Windows portable EXE (electron-based)
- Desktop standalone HTML (single-file, no build required)
- Mobile standalone HTML (responsive, touch-friendly)
git clone https://github.com/liqi3333/breast.git
cd breast
npm install
npm startOpens at http://localhost:3000.
npm run build:win
# Output: dist/Breast-TNM-Tool-1.4.0.exenpm run build:html
# Output:
# dist-html/Breast-TNM-Tool-1.4.0.html
# dist-html/Breast-TNM-Tool-mobile-1.4.0.html- Push to
main: GitHub Actions validates build and uploads workflow artifacts - Push a tag like
v1.4.0: automatically builds EXE, generates standalone HTML, creates GitHub Release, uploads all assets
Example:
git tag v1.4.0
git push origin v1.4.0.
├── assets/
│ ├── icon.ico
│ ├── icon.png
│ └── screenshots/
├── docs/
│ └── RELEASE_TEMPLATE.md
├── scripts/
│ ├── build-html-release.js
│ └── capture-screenshots.js
├── index.html # Desktop web version
├── mobile.html # Mobile web version
├── main.js # Electron entry point (if using desktop app)
├── package.json
├── README.md
├── README.zh-CN.md
└── .github/workflows/
├── build-windows.yml
└── release.yml
node_modules/,dist/, anddist-html/are not committed- Windows SmartScreen may appear because the EXE is not code signed
- Disclaimer: Medical content is for informational/educational use only and does not replace formal pathology review, MDT discussion, or clinical decision-making by qualified healthcare professionals
- All treatment regimens are schematic; actual dosing, scheduling, and drug selection require professional oncology judgment