The SpoilSwap Field Guide

Everything SpoilSwap can do,
in one read.

New here, or just want a refresher? This walkthrough takes you through the map, the request flow, listing your own material, and the emails that tie a deal together — with screenshots of every step.

01Step one

Reading the map

Once you sign in, the first thing you’ll see is the map. Every pin is something nearby that another contractor wants you to know about — there are only two kinds, and the colors give it away.

  • Amber pins are material listings. Click one to see what spoil is available at that location, the per-unit cost, and the contractor who posted it.
  • Blue pins are project sites — locations where a contractor either has surplus to give away or needs material brought in. Click for required and available volumes plus the schedule.

Tip: a legend in the bottom-left of the map mirrors this same key, so you never have to come back here to check.

spoilswap.com/app
Material available
Project site
Screenshot placeholder
Fig. 01The authenticated map view at /app — amber pins are material listings, blue pins are project sites. Your saved address sits at the center on first load.
spoilswap.com/profile/[contractor]
Acme Earthworks LLC
Sussex County, DE
Available material
Topsoil
120 CY avail · $8/CY
40
Crushed concrete
60 CY avail · $5/CY
Clean fill
300 CY avail · Free
Total
$320.00
Send Request
Screenshot placeholder
Fig. 02The contractor profile view shows every available listing. Add the cubic-yard quantity you need to each one, and the running total updates live as you build the request.
02Step two

Requesting material

When you find a pin with material you need, open the contractor’s public profile to see the full inventory at that location. Each row tells you the material type, what’s available, the unit cost, and any minimum or all-or-nothing rules the seller has set.

Type the cubic-yard quantity you want next to each line, hit “Send Request”, and you’re done — the seller gets an email instantly with everything you asked for and a one-click accept link. No phone tag, no quotes, no quarry wait.

We validate the request server-side against live availability, so you can’t accidentally over-request something another buyer just took.

03Step three

Listing material (with costs)

Sitting on excess dirt, rock, or aggregate? List it. The form walks you through three pieces:

  1. Where it is— pick an existing location you’ve already saved, or add a new address with autocomplete (with a “pick on map” fallback if the address doesn’t resolve).
  2. What it is — material type from a curated taxonomy, plus quantity. You can enter the quantity in cubic yards or tons; we convert automatically using per-material density factors.
  3. What it costs — set a price per CY, per ton, or per load. Or list it free. You can also require buyers to take it all at once, or set a minimum load.

Toggle availability on or off later from the materials list — the pin disappears from the map the moment you do.

spoilswap.com/materials/new
Location
Site B — Lewes, DE
Material type
Topsoil
Quantity
80 CY
≈ Tons
≈ 96 tons
Cost
$8.00
Cost unit
per CY
Require full quantity
Set minimum load size
Save listing
Screenshot placeholder
Fig. 03The new-material form: pick (or create) a location, choose a material type, set quantity in CY or tons, and price it per CY, per ton, or per load. Conversion factors are built in.
inbox · seth@example.com
SpoilSwapnow
Your sign-in code: 482-913
Use this code to sign in. It expires in 10 minutes.
SpoilSwapnow
New material request — 40 CY topsoil
Acme Earthworks would like to take 40 CY of topsoil ($320). Tap to accept.
SpoilSwapnow
Request accepted — contact info shared
The seller accepted your request. Phone and email are below so you can finish the deal.
Screenshot placeholder
Fig. 04A representative inbox view: sign-in code on top, a new request notification with an itemized total in the middle, and an acceptance/decline confirmation at the bottom.
04Step four

Emails you’ll receive

SpoilSwap doesn’t use passwords — you sign in with a one-time code mailed to your address. After that, email is how the deal moves forward.

  • Sign-in code— a six-digit code, valid for a few minutes. Check spam if it doesn’t land in your inbox.
  • New request notification — sellers get an itemized email when a buyer sends a request, with line totals and a one-click accept link.
  • Decision confirmations— when the seller accepts or declines, the buyer is notified and the contractor’s phone and email are shared so the two parties can finish the deal directly.

We never include payment links, attachments, or anything you have to forward. Every action lives back inside the app.

Step five

Projects, accepting requests & profiles

The map and the request flow are the spine, but a handful of supporting features are worth knowing about.

spoilswap.com/projects/[id]
Lewes Beach Apartments
Mobilizes Jun 14 · Completes Sep 30
Materials needed
Structural fill820 CY
Surplus available
Topsoil160 CY
Screenshot placeholder

Posting projects

Tell us where you’re building, when you mobilize, and what materials you need or have surplus of. Project pins (blue) help nearby suppliers find you instead of the other way around.

Project detail with materials needed, surplus available, and a schedule.
spoilswap.com/material-requests/[id]/accept
Acme Earthworks · 40 CY topsoil
Topsoil — 40 CY @ $8/CY$320.00
Accept & share contact
Decline
Screenshot placeholder

Accepting & declining

When a request lands, you can accept it from the email link or from inside the app. Accepting reveals contact info to the buyer; declining sends a polite notification with no contact details exchanged.

The accept/decline screen — one click to share contact info, one click to pass.
spoilswap.com/projects/[id] · find suppliers
Nearest suppliers · structural fill
01Tidewater Excavation3.2 mi
02Bay Aggregate Co.7.8 mi
03Coastal Hauling LLC11.4 mi
04Acme Earthworks14.0 mi
Screenshot placeholder

Nearby supplier search

From a project page, run a real driving-distance lookup against every supplier carrying the material you need. Results are sorted closest-first using the Mapbox Directions Matrix — not as-the-crow-flies.

Suppliers ranked by actual driving distance from your project.
spoilswap.com/profile/[userId]
Acme
Lewes, DE
Inventory
Topsoil120 CY
Crushed concrete60 CY
Screenshot placeholder

Public profiles

Every contractor has a shareable profile with company name, contact info, all of their available materials, and a static map of their location. Send the link in a text and someone can see your full inventory in one tap.

A contractor’s public profile page — inventory and contact in one spot.

Ready to find some material?

Sign up free and the map opens immediately at your location. The guide will be here when you need to come back.

Get Started — It’s Free← Back to home