Contract Signing & DocuSeal

1 List

2 Review

3 DocuSeal

4 States

5 Cert (C)

6 Cert (P)

7 Signed

8 Dispute

9 Empty

Contract List — Contractor Live

app/(tabs)/contracts.tsx — Filter tabs, contract cards with signature dots

9:41

Contracts

All

Awaiting Contractor

Awaiting Homeowner

Executed

Voided

Kitchen Remodel

Awaiting Contractor

Amount:$18,500.00

Contractor:Marcus Cole

Homeowner:Jane Doe

Created: Mar 20, 2026

Contractor

Homeowner

Fence Repair

Executed

Amount:$3,200.00

Contractor:Marcus Cole

Homeowner:Tom Kim

Created: Mar 10, 2026Executed: Mar 15, 2026

Contractor

Homeowner

Review & Sign Contract Live

app/contracts/sign.tsx — Contract terms, summary, agree checkbox, sign CTA

9:41

Review & Sign

Review & Sign Contract

Kitchen Remodel

This Agreement is entered into between Marcus Cole d/b/a Cole Construction LLC ("Contractor") and Jane Doe ("Homeowner") for the purpose of kitchen remodeling services at 1420 Elm Street, Charlotte, NC 28203. The scope of work includes demolition, plumbing rough-in, electrical rough-in, cabinetry installation, countertop fabrication and install, tile backsplash, finish plumbing, and final inspection...

ContractorMarcus Cole

Total Amount$18,500

I have read and agree to the terms of this contract

By signing via DocuSeal, you agree that this electronic signature is legally binding.

Cannot Sign Yet Live

Checkbox unchecked, button disabled

9:41

Review & Sign

Review & Sign Contract

Bathroom Renovation

This Agreement is entered into between Marcus Cole d/b/a Cole Construction LLC ("Contractor") and Sarah Lopez ("Homeowner") for the purpose of bathroom renovation services...

ContractorMarcus Cole

Total Amount$12,300

I have read and agree to the terms of this contract

By signing via DocuSeal, you agree that this electronic signature is legally binding.

DocuSeal Signing — Active Live

DocuSealSigning.tsx — WebView with signing widget, security footer

9:41

Contractor Signature

DocuSeal Signing Widget

docuseal-form web component renders here

Sign above the line

This document is legally binding. Your signature is secured with bank-level encryption via DocuSeal.

DocuSeal Signing — Poster Live

Poster countersign, deepBlue accent in title

9:41

Homeowner Signature

Your Signature

Sign above the line

This document is legally binding. Your signature is secured with bank-level encryption via DocuSeal.

DocuSeal — Loading Live

Preparing document for signing

9:41

Sign Document

Preparing your document for signing...

Secured with bank-level encryption via DocuSeal.

DocuSeal — Error Live

Unable to load document

9:41

Sign Document

Unable to Load Document

Failed to prepare signing session. Please try again.

Secured with bank-level encryption via DocuSeal.

DocuSeal — Connection Issue Live

WebView error state with retry

9:41

Sign Document

Connection Issue

Failed to load the signing page. Please check your connection and try again.

Secured with bank-level encryption via DocuSeal.

Completion Cert — Contractor (Can Sign) Live

app/(contractor)/(tabs)/jobs/completion-cert.tsx — Job summary, cert details, photos, signatures, action bar

9:41

Completion Certificate

Job Summary

Kitchen Remodel

1420 Elm St, Charlotte, NC 28203

Contract Amount: $18,500

Certificate Details

COMPLETION CERTIFICATE Date: March 25, 2026 JOB DETAILS Job Title: Kitchen Remodel Location: 1420 Elm St, Charlotte, NC 28203 COMPLETION SUMMARY Total Photos: 8 - Before: 3 - Progress: 2 - After: 3

Project Photos (8)

Before (3)

Progress (2)

After (3)

Signatures

Contractor Signature

Pending your signature

Homeowner Signature

Pending contractor signature first

By signing this certificate, you confirm that all work has been completed as agreed and are requesting final payment release from escrow.

Cert — Awaiting Homeowner Live

Contractor signed, waiting on poster

9:41

Completion Certificate

Job Summary

Kitchen Remodel

Signatures

Contractor Signature

Signed on 3/25/2026

Homeowner Signature

Awaiting homeowner signature

Waiting for homeowner to sign...

Completion Cert — Poster (Signature Required) Live

app/(poster)/jobs/completion-cert.tsx — Photo tabs, dispute option, approve & sign

9:41

Completion Certificate

Job Summary

Kitchen Remodel

1420 Elm St, Charlotte, NC 28203

Contractor: Cole Construction LLC

Contract Amount: $18,500

Project Photos (8)

All (8)

Before (3)

Progress (2)

After (3)

Certificate Details

CERTIFICATE OF COMPLETION Date: March 25, 2026 PROJECT DETAILS Job Title: Kitchen Remodel Contractor: Cole Construction LLC FINANCIAL SUMMARY Contract Amount: $18,500 First Payout (40%): $7,400.00 Final Payout (60%): $11,100.00

Signatures

Contractor Signature

Signed on 3/25/2026

Your Signature

Ready for your signature

Before Signing

Review all photos carefully and ensure you're satisfied with the completed work. Once signed, final payment will be released to the contractor.

Report an issue with this job

Cert — Awaiting Contractor Live

Poster waiting for contractor to submit

9:41

Completion Certificate

Job Summary

Kitchen Remodel

Signatures

Contractor Signature

Pending contractor signature

Your Signature

Waiting for contractor to sign first

Waiting for contractor to submit completion...

Cert — Fully Executed (Contractor) Live

Both signed, payment released

9:41

Completion Certificate

Job Summary

Kitchen Remodel

Contract Amount: $18,500

Signatures

Contractor Signature

Signed on 3/25/2026

Homeowner Signature

Signed on 3/25/2026

Cert — Fully Executed (Poster) Live

Payment released, share + review options

9:41

Completion Certificate

Job Summary

Kitchen Remodel

Contract Amount: $18,500

Signatures

Contractor Signature

Signed on 3/25/2026

Your Signature

Signed on 3/25/2026

Confirmation — Certificate Signed (Contractor) Live

AlertDialog after contractor signs

9:41

Completion Certificate

Confirmation — Payment Released (Poster) Live

AlertDialog with review option

9:41

Completion Certificate

Dispute Dialog Live

Poster dispute option before signing

9:41

Completion Certificate

Contracts — Empty State Live

No contracts found

9:41

Contracts

No Contracts

You don't have any contracts yet. Contracts are created when bids are accepted.

Loading State Live

Loading contract/cert data

9:41

Loading completion certificate...

Contract Not Found Live

Error state for invalid contract ID

9:41

Not Found

Job not found

This job may have been removed or you don't have access.

Contract List + Preview Live

9:41

Contracts

All

Awaiting

Executed

Kitchen Remodel

Jane Doe • $18,500

Sign

Bathroom Reno

Sarah Lopez • $12,300

Pending

Fence Repair

Tom Kim • $3,200

Signed

Review & Sign Contract

Kitchen Remodel

Contractor

Marcus Cole

Total Amount

$18,500

I agree to the terms

DocuSeal Signing + Progress Live

9:41

Sign Contract

Signing Progress

Contract Generated

Mar 22, 9:00 AM

Contractor Signing

In progress

Poster Countersign

Waiting

Secured with bank-level encryption via DocuSeal.

DocuSeal Signing Widget

Full signing experience renders here

Your signature above

Completion Cert — Contractor Live

9:41

Completion Certificate

Job Summary

Kitchen Remodel

1420 Elm St, Charlotte, NC

$18,500

Signatures

Contractor

Pending

Homeowner

Waiting

Certificate Details

COMPLETION CERTIFICATE Date: March 25, 2026 JOB DETAILS Job Title: Kitchen Remodel Location: 1420 Elm St, Charlotte, NC 28203 COMPLETION SUMMARY Total Photos: 8 - Before: 3 - Progress: 2 - After: 3 CONTRACT AMOUNT Original Amount: $18,500 Platform Fee: $925.00 Net Payout: $17,575.00

Project Photos (8)

Completion Cert — Poster Live

9:41

Completion Certificate

Job Summary

Kitchen Remodel

Cole Construction LLC

$18,500

Signatures

Contractor

Signed 3/25/2026

Your Signature

Ready

Project Photos (8)

All (8)

Before (3)

Progress (2)

After (3)

Certificate Details

Before Signing

Review all photos carefully. Once signed, final payment will be released.

Certificate Complete Live

9:41

Completion Certificate

Certificate Complete

Both parties have signed

Signatures

Contractor Signature

Signed 3/25/2026

Homeowner Signature

Signed 3/25/2026

Job Summary

Kitchen Remodel

Contract Amount

$18,500

Location

1420 Elm St, Charlotte, NC

Contract List Live

https://app.3bids.io/contracts

Contracts

All

Awaiting Contractor

Awaiting Homeowner

Executed

Voided

Contract	Homeowner	Amount	Created	Status	Signatures
Kitchen Remodel	JD Jane Doe	$18,500	Mar 20	Awaiting Contractor	C H
Bathroom Reno	SL Sarah Lopez	$12,300	Mar 18	Awaiting Homeowner	C H
Fence Repair	TK Tom Kim	$3,200	Mar 10	Executed	C H

Review & Sign Contract Live

https://app.3bids.io/contracts/sign/cntr_abc123

Review & Sign Contract

Kitchen Remodel

DocuSeal Embedded Signing

Full signing widget with document, signature fields, and date

Your signature above

Contract Summary

Job

Kitchen Remodel

Homeowner

Jane Doe

Amount

$18,500

I agree to the terms

Legally binding via DocuSeal with bank-level encryption.

Completion Cert — Contractor Live

https://app.3bids.io/contractor/jobs/completion-cert/job_abc

Completion Certificate

Certificate Details

Project Photos (8)

Before (3)

Progress (2)

After (3)

Job Summary

Kitchen Remodel

Location

1420 Elm St, Charlotte, NC

Amount

$18,500

Signatures

Contractor

Pending

Homeowner

Waiting

By signing, you confirm work completion and request final payment release.

Completion Cert — Poster Live

https://app.3bids.io/poster/jobs/completion-cert/job_abc

Completion Certificate

Project Photos (8)

All (8)

Before (3)

Progress (2)

After (3)

Certificate Details

CERTIFICATE OF COMPLETION Date: March 25, 2026 PROJECT DETAILS Job Title: Kitchen Remodel Contractor: Cole Construction LLC FINANCIAL SUMMARY Contract Amount: $18,500 PAYMENT SCHEDULE First Payout (40%): $7,400.00 Final Payout (60%): $11,100.00 By signing below, the homeowner acknowledges: 1. The contracted work has been completed satisfactorily 2. Final payment may be released to the contractor 3. Disputes must be filed within 48 hours

Job Summary

Kitchen Remodel

Contractor

Cole Construction LLC

Amount

$18,500

Signatures

Contractor

Signed 3/25/2026

Your Signature

Ready for your signature

Before Signing

Review all photos carefully. Once signed, payment releases.

Certificate Complete Live

https://app.3bids.io/contractor/jobs/completion-cert/job_abc

Completion Certificate

Signatures

Contractor Signature

Signed 3/25/2026

Homeowner Signature

Signed 3/25/2026

Project Photos (8)

Job Summary

Kitchen Remodel

Location

1420 Elm St, Charlotte, NC

Amount

$18,500

Data Architecture

Contract signing via DocuSeal, completion certificates, and dual-party signing flow with escrow release.

Source Files

app/contracts/sign.tsx

Review & sign contract screen with agree checkbox, DocuSeal modal trigger

Component

app/(tabs)/contracts.tsx

Contract list with status filters (all, pending_contractor, pending_poster, fully_executed, voided)

Component

app/(contractor)/(tabs)/jobs/completion-cert.tsx

Contractor completion cert: job summary, cert details, photo gallery, signatures, sign action

Component

app/(poster)/jobs/completion-cert.tsx

Poster completion cert: photo tabs, dispute option, approve & sign, payment release confirmation

Component

components/contracts/DocuSealSigning.tsx

Modal with WebView embedding docuseal-form web component, completion detection via navigation + postMessage

Component

Convex Queries

contracts.contracts.get

Get contract with job, contractor profile, canSign flag, userRole

Query

contracts.contracts.listForUser

List contracts with optional status filter, limit 50

Query

contracts.completionCert.getByJob

Get completion certificate for job with canSign flag

Query

jobs.jobs.get

Job details with escrow, contractor profile

Query

jobs.photos.listForJob

Before/progress/after photos with captions and upload metadata

Query

Convex Actions

contracts.docusealSigning.initDocuSealSigning

Initialize DocuSeal signing session for contract, returns signingUrl

Action

contracts.docusealSigning.initDocuSealCompletionCert

Initialize DocuSeal session for completion certificate signing

Action

Contract Signing Flow

Bid Accepted

Contract Generated

Contractor Signs (DocuSeal)

Poster Countersigns

Fully Executed

Completion Certificate Flow

Job In Progress

Contractor Signs Cert

Poster Reviews + Signs

Payment Released

Job Completed

Poster Reviews

Files Dispute

Payment Paused

Key Design Decisions

DocuSeal WebView Embed

Uses docuseal-form web component inside a React Native WebView. Completion detected via URL navigation, postMessage, and DOM events. Security footer with shield icon in all states.

Dual-Party Signing

Contractor signs first (terracotta context), poster countersigns (deepBlue context). Signature status tracked with checkmark-circle vs ellipse-outline icons. Preview strips shown after signing.

Completion Certificates

Monospace cert content with financial summary (40/60 split). Photo gallery with before/progress/after categories. Poster gets photo tab filters and dispute option. Fully executed triggers escrow release.

Dispute Path

Poster can file dispute before signing, which pauses payment release. AlertDialog confirms with destructive action. Routes to /(poster)/disputes/create with jobId param.