Support — Fleuron

Install help or bug reports

Please use the guided issue templates on GitHub to report problems:

Installation assistance

Help with operating system warnings, Gatekeeper prompts, SmartScreen alerts, or permissions issues.

Open install-help issue →

Bug report

Report unexpected behavior, crashes, data discrepancies, or user interface regressions.

Open bug-report issue →

Generating diagnostic reports safely

To help diagnose issues without exposing research participants or sensitive transcripts, use these two safe paths:

1. When Fleuron opens (In-App)

Go to About → Generate diagnostic report. This generates an allowlist-redacted summary of your installation, storage, and sync state. You can review the plain text in the app before copying or saving it.

2. When Fleuron will not start (External Probe)

Run the standalone read-only diagnostic probe from the support/ directory in the repository:

# macOS:
bash support/fleuron-probe.sh --output fleuron-diag.txt

# Windows:
powershell -NoProfile -File support\Get-FleuronProbe.ps1 -OutputFilePath fleuron-diag.txt

Both probe scripts are strictly read-only and never alter system or study files.

Security & institutional IT

Security vulnerabilities

Report security vulnerabilities privately through GitHub's security advisories tab at github.com/wilson-taiwan/fleuron/security. Do not open public issues for security vulnerabilities.

Institutional IT & managed devices

For campus IT deployment, AppLocker policies, and group management, refer to the IT Deployment Guide (docs/IT-DEPLOYMENT.md).