SStoneCraft Builders Documentation

StoneCraft Builders

Customize your home-builder template with confidence.

1. Overview

StoneCraft Builders is a premium Bootstrap 5 landing page for custom-home builders. It includes six services, four illustrative home concepts, two starting-point panels, building principles, eight Sacramento-area sample service cities, three sample testimonials, a four-step build process, an estimate inquiry, thirteen FAQs, and policy dialogs.

The eight local WebP photographs are AI-generated illustrations. The contact details and testimonials are fictional demonstration content. Replace them with authentic business content before launch.

The form prepares an email draft for the visitor to send. It does not automatically deliver or store inquiries, calculate estimates, or book appointments.

2. Files and quick start

stonecraft-builders/
  index.html
  README.html
  LICENSES.txt
  assets/
    favicon.svg
    css/style.css
    js/main.js
    images/ (8 WebP photographs)
    icons/sprite.svg
    vendor/bootstrap/
      bootstrap.min.css
      bootstrap.bundle.min.js

Open index.html to preview. Keep all files and folders together. No build process, database, CDN, remote fonts, or package installation is required.

3. Edit your business content

In index.html, replace StoneCraft Builders, the sample phone (916) 555-0147, email hello@stonecraft.example, hours, service cities, about copy, FAQs, and sample testimonials. Update phone text and every tel: link together. Update email text, mailto: links, and the recipient constant in assets/js/main.js together.

Search for each old value to catch header, contact section, footer, and no-JavaScript fallback. Adapt the sample privacy and terms dialogs to actual practices. No license credentials, awards, or completed-project claims are supplied.

4. Colors, typography, and spacing

Edit the variables at the beginning of assets/css/style.css. The StoneCraft theme rules at the end of that file refine the layout; edit those rules when they override an earlier selector.

VariableValueUse
--charcoal#203b32Deep forest
--deep#152b24Footer and dark surfaces
--amber#dfc49aWarm limestone accent and primary buttons
--ivory#f7f5efLight background

Headings use Georgia with serif fallbacks. Body text uses Arial/Helvetica. No font downloads are required. Check default, hover, focus, and active button states when changing colors. Replace assets/favicon.svg to update the browser icon.

5. Photos and project showcase

All photographs are in assets/images as 1536 × 1024 WebPs. The hero uses hero.webp; home concepts use courtyard.webp, hillside.webp, farmhouse.webp, and interior.webp. Supporting images are detail.webp, planning.webp, and team.webp.

Replace images with authorized photographs, preserve filenames or update the corresponding src paths, and write accurate alt text. The hero fills the viewport width using object-fit: cover, so its edges crop on narrow screens. Adjust .hero-image object-position in the desktop and mobile rules if the subject moves.

Project cards are illustrative concepts, not a record of built homes. Replace captions and labels together when adding genuine projects. The device showcase and marketplace hero capture are separate deliverables rather than template dependencies.

6. Services and inquiry preselection

Service buttons use data-service to select the matching form option. Current values are home, plan, renovation, addition, outdoor, tools, multiple, and other. If you rename a value, update every associated button and option.

Starting-point panels use data-audience values Lot Owned and Exploring Land. The form also supports Existing Home and Other / Not Sure. City buttons use data-city and fill the city field. These actions preserve unrelated visitor inputs.

7. Estimate form and email draft

Required fields are name, email, service, project situation, city, and project details. Phone, approximate size, site condition, materials, discussion date, and timing are optional. Dates earlier than the visitor’s local current date are rejected. A selected date is a request only.

  1. The visitor completes the form and selects Prepare Estimate Inquiry.
  2. The script validates fields and displays a reviewable draft.
  3. Open Email App opens a mailto draft addressed to the configured recipient.
  4. The visitor reviews and sends the message through their own email service.

Copy Draft uses the clipboard when available, with a text-selection fallback. Editing the form invalidates the previous draft. Reset clears the form and draft. No attachments are uploaded; visitors may attach files in their email app.

Change the recipient and subject in assets/js/main.js. Without JavaScript, use the provided phone or email links.

8. Automatic delivery and integrations

To receive submissions automatically, connect a backend or a form provider separately. Preserve field validation, provide a clear success or error message, and show success only after the service confirms receipt. Add server-side validation and suitable spam protection. Update the privacy wording to describe actual processing and storage. No CRM, scheduler, payment service, cost calculator, or file-upload service is included.

10. Responsive layout

Services adapt from one to three columns, home concepts from one to two columns, and the process from one to four columns as space permits. The menu collapses below the extra-large breakpoint. Check small phones, tablets, and desktops after edits, especially long business names, email addresses, and button labels.

11. Dependencies and notices

Bootstrap 5.3.8 and its bundled Popper are included locally. See LICENSES.txt and vendor headers for notices. Icons are local SVG artwork. Template usage and redistribution rights follow your applicable purchase terms; this documentation does not grant additional rights.

12. Launch checklist

  1. Replace fictional business details and sample testimonials.
  2. Confirm all services and scope statements describe your business.
  3. Replace illustrative imagery before claiming genuine project or team evidence.
  4. Set the real email recipient, phone links, hours, and coverage.
  5. Review privacy and terms wording.
  6. Test service, situation, and city buttons.
  7. Test required fields, dates, draft editing, copy, reset, and actual email delivery.
  8. Check mobile navigation, FAQs, keyboard focus, and dialogs.
  9. Update page title, description, brand, and favicon.

13. Troubleshooting

ProblemWhat to check
Missing image or stylingFile names are case-sensitive. Preserve the assets folder and relative paths.
Old styling appearsRefresh the browser cache and update the stylesheet version query.
Wrong service selectedMatch data-service exactly to the option value.
Email app does not openConfigure a mail client or copy the draft into webmail.
Copy is blockedUse the selected text and your device’s Copy command.
Menu or FAQ does not respondCheck the local Bootstrap bundle and matching target IDs.