# Quote requests

An open-source quote request form and inbox for roofers, plumbers, electricians and other trades, built with Next.js, TypeScript and PostgreSQL. Customers describe the job, give a postcode and days that suit for a visit on your quote page or a form embedded on your own site, and your team works each request through statuses with notes, quote amounts, a win rate and optional photos and email alerts.

- Framework: Next.js (JavaScript)
- Category: Apps / Forms and surveys, CRM
- Creates: a server app and a PostgreSQL database on the Shared tier (1 GB)
- Plan: Lite or above
- Price: Free
- Author: Light Cloud
- Page: https://templates.light-cloud.com/apps/forms/quote-request-form-template
- Updated: 2026-11-21

## Features

- A quote page with your headline, phone, opening hours, areas covered and reply promise above the form, then what happens next, where you work and an FAQ, all from your settings
- A form for the kind of job, a description, postcode or ZIP code, optional street, up to three visit dates with morning or afternoon, name, phone and optional email; it works without JavaScript and keeps every answer after an error
- An embeddable form through a one-line script that adds a frame which grows to fit, or a plain iframe or direct link
- Optional photo uploads, up to four per request, to a private S3-compatible bucket, checked by their contents and shown only to your signed-in team
- An inbox with status filters and counts, search by name, phone, postcode or Q-number, and the last 30 days of requests, quotes sent, jobs won and win rate
- New, contacted, quoted, won and lost statuses with one click, notes, the quoted amount and a timeline of who changed what and when
- A service area check by postcode area, district or ZIP prefix that flags requests from outside it, and new-request email alerts once a Resend key is set
- A Leeds roofing firm demo with 31 requests in every status, trade JSON-LD such as RoofingContractor or Plumber, and WCAG 2.2 AA in light and dark

## What you need

- A paid plan: deploying creates a PostgreSQL database, which the Free plan does not include
- To run it locally: Node.js 22.12 or newer, npm, and Docker for a local PostgreSQL
- Optional: RESEND_API_KEY and EMAIL_FROM to email each new request; without them requests wait in the inbox
- Optional: S3_BUCKET, S3_ACCESS_KEY_ID and S3_SECRET_ACCESS_KEY (with S3_REGION on AWS, or S3_ENDPOINT for other stores) for photo uploads; without them the photos field is hidden
- Optional: APP_URL once you add a custom domain, so the embed snippet and email links use it

## About

Business details, opening hours, the kinds of job, the postcode areas or ZIP prefixes you cover, the reply promise and the price guide are all edited in the app under Settings, and drive the form, the FAQ, the JSON-LD and llms.txt; photos are in public/images and the demo roofing firm is scripts/seed.mjs. A request is saved before its photos are stored and the alert email is sent after the response, so a storage or email outage never loses a customer. Photo uploads were tested end to end only against SeaweedFS, an S3-compatible store, not real AWS S3 or Cloudflare R2 (on AWS, S3_REGION must be set), and new-request emails through Resend are unit-tested but were not sent through a live account. The app raises its upload limit to 26 MB for four 6 MB photos, and it is not yet known whether Light Cloud's front proxy accepts request bodies that large. The submission rate limit of 5 requests per 10 minutes from one address is kept per instance, the inbox lists the latest 200 requests per filter (search finds older ones), and photos have to be chosen again after a form error. There are no customer-facing quote documents or confirmation emails yet, and the main photo shows two identifiable roofers under the Unsplash licence, which the credits suggest replacing with your own team.

## Variables

- `AUTH_SECRET`: generated

## Questions

### How do I add a quote request form to my website?

Deploy this template, open Embed form in the inbox and paste the one-line script into your website's contact or quote page. The form appears in a frame that grows to fit and requests land in your inbox; for site builders that block scripts, use the plain iframe or link to your quote page.

### Can customers upload photos with a quote request?

Yes, once you set an S3-compatible bucket such as AWS S3, Cloudflare R2, Backblaze B2 or MinIO with S3_BUCKET and two keys. Customers can then add up to four photos, each checked by its contents and stored privately, and only your signed-in team can see them.

### Will I get an email when a new quote request comes in?

Yes, when RESEND_API_KEY is set: each new request is emailed to the addresses in Settings, or every owner, with the job, postcode, dates and phone number. Without a key, requests wait in the inbox, where new ones are counted in the sidebar.

### Can I send the customer a quote document from it?

Not yet. There are no customer-facing quote documents or online acceptance, so you send the quote yourself, by email or as a PDF from your accounts software, and record the amount on the request to track your win rate.

### Is this quote form only for roofers?

No. The demo is a roofing firm, but the kinds of job, the trade shown to search engines (plumber, electrician, builder, painter and more), the service area and the currency are all settings, so it suits any trade or service business that quotes before it works.
