Business software and compliance Case study
RoofReveal: roof measurement and reporting platform
A web app that finds a roof from an address, shows detected roofs on a satellite map and sells tiered reports, with a Python service using Google Solar API data and Gemini roof-photo analysis.
- Client
- RoofReveal
- Service
- Web apps, AI, Integrations
- Years
- 2024
- Stack
- Google Cloud Run, Gemini, FastAPI, Python and 14 more
- Platforms
- Web
Overview
RoofReveal targets roofers, insurers, solar and utility companies that need roof measurements without a site visit. A user searches an address, confirms the property on a satellite map, draws an area, and the product highlights the roofs inside it and builds a report. There are three report tiers, Canvassing, Explorer and an Xactimate-style estimate, bought with credits on a subscription. We designed the product, built the web app and its admin panel, and worked on the Python service that turns Google satellite and elevation data and roof photos into measurements, outlines and condition details.
The challenge
Raw satellite elevation data and aerial imagery are not usable as they are. They had to become roof measurements, outlines and condition information, and then be packaged as reports that a customer can buy.
What we built
- The full product design in Figma: marketing site, logged-in home with the three report tiers, the canvassing flow, report previews, subscription and checkout, profile and help screens
- The customer web app front end: address search and map, report pages, profile screens, subscription and purchase lists
- Ridge length calculation and images inside the reports
- Subscriptions with Stripe, including a list of annual plans
- An admin panel with data tables and profile management
- A Supabase database for the product
- Google Maps Platform and Google Solar API integration, and report rendering with Puppeteer and Chromium
- A Python (FastAPI) prototype service: building solar data by coordinates, a pipeline that turns the elevation layer into roof outlines saved as GeoJSON, and roof photo analysis with Gemini that returns shingle type, colour, approximate age and damage
- Docker packaging and Cloud Run deployment notes for the service
How a system like this fits together
Reference architecture: roof measurement and reporting platform
Simplified reference architecture, not a client schematic.
- A user searches for an address in the web app and confirms the property on a Google Maps Platform satellite map.
- The web app asks the roof analysis API (FastAPI on Python, a Docker container for Cloud Run) for roof data.
- The API reads building and elevation data from the Google Solar API and turns the elevation layer into roof outlines; roof photos are analysed by Gemini on Vertex AI for shingle type, colour, age and damage.
- Accounts, plans and purchases are stored in a Supabase database that the web app and the admin panel read and write.
- Report subscriptions are paid through Stripe.
Technology used
| Layer | Choice | Purpose |
|---|---|---|
| Service | FastAPI on Python, Docker, Cloud Run | roof analysis endpoints |
| Payments | Stripe | report subscriptions |
| Maps and solar data | Google Maps Platform, Google Solar API | satellite map, roof segments and elevation |
| Design | Figma | marketing site, app and report screens |
| Web app | Web front end, TanStack Table | customer app and admin panel |
| Geospatial | rasterio, Shapely, GeoPandas, scikit-image | elevation layer to roof outlines |
| AI | Vertex AI Gemini | roof type, colour, age and damage from a photo |
| Data | Supabase | accounts, plans and purchases |
| Reports | Puppeteer, Chromium | report rendering |
What happened next
- Delivered
The work described above was delivered to the client.
- Operational facts
- Our work on this project took place in 2024.
Screens
Could this be your project?
- You need a web application with user accounts, admin tools and reporting. Website and web app development
- You have a defined job in a real process that automation or AI could take on. AI services
- You work in business software and compliance and want a team that has built for it before. Business software and compliance work
Questions about this project
How long did this project take?
Our work on it took place in 2024.
What technology was used?
Google Cloud Run, Gemini, FastAPI, Python, Stripe, Docker, Google Maps Platform, Supabase, Google Solar API, Vertex AI, Puppeteer, Chromium, TanStack Table, Figma, rasterio, Shapely, GeoPandas, scikit-image.
Similar work
Also Python, same industry
AXENCIS: brand protection case management platform
xcore, AXENCIS's Laravel and Vue platform for tracking online marketplace listings through investigation to legal case, with browser extensions, evidence capture and accounting for clients and law firms.
Also Google Cloud, same industry
Mammoth Self Storage: AI storage calculator and chatbot
A chatbot for Mammoth Self Storage that estimates how much storage a customer needs from a photo or video, lists the items and their volume, finds the nearest site, quotes available units and hands off to booking.
Also Google Cloud, same industry
QCare: compliance platform for DEKRA
QCare, DEKRA's quality, compliance and risk evaluation platform on the Collabtic service platform: certification and compliance tracking, organisations, training, shop certification and headquarters dashboards, on an Angular front end and a PHP API.