microsoft / microsoft/modernize-cli
feat: Embed Interactive Assessment Roadmap UI into index.html Report Output
@qianwens is already working on this.
Since May 20, 2026.
- Dominant language
- Shell
- Stars
- 20
- Forks
- 7
- PR merge metrics
- No merged PRs in 30d
Description
Problem
Current assessment output generates a static index.html report. While useful for documentation, it doesn't facilitate the collaborative business value discussions needed during modernization planning at scale.
Proposal
Embed an interactive assessment visualization directly into the generated index.html file, enabling stakeholders to:
- View applications grouped by effort and cloud readiness
- Track and modify modernization drivers and properties
- Collaborate on prioritization without external tools
- Export updated assessments for governance
Solution
Generate a self-contained index.html that includes:
- Embedded Vue.js UI - Interactive application dashboard (no server required)
- In-memory SQLite (via sql.js) - Parse
aggregate-report.jsoninto queryable data - Local persistence - Save user decisions (drivers, inclusion flags, target platforms) to localStorage
- Zero dependencies - Opens in any browser, works offline
Reference
The nielsams/modernization-assessment project demonstrates this pattern effectively. It parses AppCAT HTML reports and provides the missing UX layer that teams need for real modernization planning conversations. Today, integrating it requires running a separate Docker container and copying generated HTML reports into its data/assessments folder — adding operational overhead that could be eliminated by baking the functionality directly into the existing index.html output.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Assessment
This issue has not been assessed yet.