Convert markdown research reports into interactive React presentation websites for GitHub Pages.
- Reusable generator — works with any structured markdown research report
- Tailwind CSS v4 + shadcn/ui — modern utility-first styling with swappable component registries
- Theme presets — 8 built-in dark color themes + community registry support
- Interactive elements — calculators, scenario sliders, comparison tables, timelines
- Knowledge vault — searchable full-text report content
- Dark professional theme — refined typography (DM Serif Display + IBM Plex Sans), amber accent system
- GitHub Pages ready — Vite build with included deploy workflow
- Vercel agent skills — integrates react-best-practices, web-design-guidelines, and composition-patterns
/report-to-web:generate path/to/your-report.mdThe command will:
- Ask where to create the output project
- Ask your preferred interactivity level (presentation, full-interactive, or both)
- Ask your preferred visual style (Dark Professional, shadcn color presets, or community registry)
- Parse the report structure and generate a complete React site
/report-to-web:generate— Main entry point
- site-generation — Markdown parsing strategy, component mapping, project scaffolding
- design-system — Dark professional theme tokens, typography, animation patterns
- site-builder — Autonomous agent that parses reports and generates React projects
TabbedLayout— Tab navigation shell with animated transitionsCalculator— Interactive formula calculator with live resultsComparisonTable— Filterable side-by-side comparisonTimelineView— Vertical timeline with expandable eventsCitationCard— Expandable reference cards with external linksKnowledgeVault— Searchable full-text content browserScenarioSlider— What-if scenario explorer with slidersSectionRenderer— Markdown renderer with scroll-triggered animations
The site-builder agent auto-detects interactive opportunities:
| Report Pattern | Component |
|---|---|
Formulas (Tax = CVA x Rate) |
Calculator |
| Comparison tables (3+ columns) | ComparisonTable |
| Chronological dates / timelines | TimelineView |
| What-if language / ranges | ScenarioSlider |
| Footnotes / endnotes | CitationCard |
You can also add explicit markers in your report:
<!-- interactive: calculator -->
<!-- interactive: timeline -->
<!-- interactive: scenario -->
<!-- interactive: comparison -->output-dir/
├── package.json
├── vite.config.js
├── postcss.config.js
├── jsconfig.json
├── components.json
├── index.html
├── .github/workflows/deploy.yml
├── src/
│ ├── main.jsx
│ ├── app.css
│ ├── App.jsx
│ ├── data/
│ │ ├── reportData.js
│ │ └── interactiveConfig.js
│ ├── themes/ (selected theme preset)
│ ├── theme/
│ │ └── motion.js (framer-motion tokens)
│ ├── lib/
│ │ └── utils.js (cn() utility)
│ ├── components/
│ │ ├── ui/ (installed by npx shadcn add)
│ │ └── *.jsx (bundled custom components)
│ └── pages/ (generated per report)
- Node.js 18+
- npm
MIT