Binsr Final — Inspection Report Generator

Generate professional home inspection reports instantly — choose between a TREC-certified report or a Binsr customized report.

Comment

Inspiration

  • We wanted to simplify and modernize how home inspection reports are generated.
  • Most tools were either too rigid (TREC-only) or too plain — we wanted both compliance and style.
  • The goal: make report generation fast, professional, and accessible to anyone.

What it does

  • Lets users upload an inspection.json and generate inspection PDFs in one click.

  • Produces two types of reports:

    • TREC Report (TypeScript, official format)
    • Binsr Custom Report (Python + HTML/CSS design)

  • Runs everything inside an easy Streamlit web app with instant downloads.

How we built it

  • Frontend/UI: Streamlit dashboard for upload, options, and downloads.
  • Backend 1 (Python): Jinja2 + WeasyPrint for HTML → PDF conversion.
  • Backend 2 (TypeScript): pnpm + ts-node to run the TREC generator.
  • Used Python’s subprocess to run both pipelines safely from one interface.

Challenges we ran into

Our biggest challenge was optimizing runtime performance. Early versions took over a minute to generate both reports. Reusing browser sessions in the TREC generator for faster PDF rendering.

Accomplishments that we're proud of

  • Unified two tech stacks (Python + TypeScript) in one seamless system.
  • Reduced TERC report generation to just 7-8 seconds.
  • Created professional, branded PDF outputs with custom HTML/CSS design.
  • Built an open-source project that’s simple to use and extend.

What we learned

  • Deepened our understanding of TypeScript async workflows and static typing.
  • Learned advanced HTML/CSS layout design for print-quality PDFs.
  • Tried LaTeX for formatting but found HTML + WeasyPrint much faster and more flexible.

What's next for Binsr Final — Inspection Report Generator

  • Deploy to Streamlit Cloud for public access.
  • Add AI summaries for plain-language inspection overviews.
  • Allow batch report generation for multiple properties.
  • Add branding options like logos, themes, and inspector signatures.
  • Integrate with cloud storage for saving and sharing reports.

Link to output files: https://www.dropbox.com/scl/fo/agl251lobjpz87d7y2jfz/ADUyqFTfiJB0rckUNVkNtwc?rlkey=mrx7fi09qdo6ceebf8w3evvq5&dl=0

Built With

Share this project:

Updates