Overview
This comprehensive guide shows you how to use the Contracting.App web platform through the user-friendly interface. No technical knowledge required - everything is done through simple point-and-click web forms and dashboards.
Table of Contents
- Getting Started
- Dashboard Overview
- Connecting Your Wallet
- Organizations & Team Management
- Creating Construction Projects
- Managing Construction Projects
- Project Dashboard & Details
- Milestones & Payments
- Managing Contracts
- Payment & Check Management
- Lien Waivers
- Document Upload & Management
- Project Collaboration
- Account Settings
- Mobile Experience
- Troubleshooting
Department-Specific Guides
For detailed instructions on each department, see the dedicated user guides:
- Estimating User Guide — Jobs Pipeline, Cost Estimating, Blueprint Takeoff, Quotes
- Procurement User Guide — Vendor Directory, Purchase Orders, Inventory
- PM Dashboard & Tasks Guide — Task Management, Cost Analysis
- Scheduling User Guide — Gantt Chart, Calendar, Kanban Board
- Change Orders User Guide — Field Entry Portal, Approval Workflows
- Enhanced Workflow User Guide — Permits, Inspections, Closeout
- Time Tracking User Guide — Clock In/Out, Timesheets, Reports
- Field Operations User Guide — Safety, Equipment & GPS, Daily Logs
- Accounting & Payroll User Guide — Invoices, Payments, Payroll
- Blockchain Advanced User Guide — Security, Compliance, Governance
- Executive & Analytics User Guide — Reports, KPIs, Insights
- Messaging User Guide — Messages, Contacts, Notifications
- Admin & Settings User Guide — API Keys, Support, Disputes
Getting Started
Sign Up & Login
1. Visit the Platform
2. Create Your Account
- Enter your email address
- Choose a strong password
- Provide company information (optional but recommended for business use)
- Click "Create Account"
3. Email Verification
- Check your email for verification link
- Click the link to activate your account
- Return to contracting.app to log in
4. Enhanced Security (Recommended)
- Enable Multi-Factor Authentication (MFA) from Account Settings
- Add hardware security keys for maximum security
- Generate backup codes and store them safely
Dashboard Overview
Main Dashboard Features
📊 Statistics Cards
- Total Projects: Number of active projects
- Contract Value: Total value across all contracts
- Pending Payments: Checks awaiting processing
- Document Count: Uploaded and verified documents
📋 Quick Actions Panel
- "+ New Project" - Start a new construction project
- "Create Check" - Issue a payment check
- "Upload Document" - Add project documents
- "Connect Wallet" - Link your cryptocurrency wallet
📈 Recent Activity Feed
- Live updates on project milestones
- Payment notifications
- Document approvals
- Team member activities
🔗 Navigation Menu (8 Departments)
The top navigation bar is organized into 8 departments:
| Department |
Key Features |
| Estimating |
Jobs Pipeline, Cost Estimating, Blueprint Takeoff, Vendor/Sub Quotes |
| Procurement |
Vendor Directory, Procurement Dashboard, Purchase Orders, Inventory & Tools |
| Project Management |
PM Dashboard, Projects, Milestones, Tasks, Scheduling, Change Orders, Inspections, Closeout |
| Field Ops |
Clock In/Out, Timesheets, Time Reports, Resource Dashboard, Equipment & GPS, Safety Dashboard |
| Accounting |
Vendor Invoices, Lien Waivers, Payment Manager, Check Management, eChecks, Joint Checks, Payroll, Financial Overview |
| Blockchain |
Contract Dashboard, Contracts, Document Vault, Security Manager, Compliance Manager, Governance |
| Executive |
Reports & Analytics, Dashboards, KPIs, Insights, Admin Panel |
| Admin |
Messages, Contacts, Notifications, Disputes, Organizations, Learning Center, Support, Settings, API Keys |
Additionally, the header bar provides:
- Wallet Status — Shows wallet connection status and address
- Notification Bell — Unread notification count
- Message Badge — Unread message count
- User Menu — Account settings, preferences, logout
Connecting Your Wallet
Step-by-Step Wallet Connection
1. From Dashboard
- Click "Connect Wallet" button in Quick Actions
- Or go to Settings → Wallet Connection
2. Choose Your Wallet Type
MetaMask (Most Popular)
- Click "Connect with MetaMask"
- MetaMask popup will appear
- Click "Connect" in the MetaMask window
- Select the account you want to use
- Click "Connect" to confirm
Hardware Wallets (Most Secure)
- Click "Connect Hardware Wallet"
- Choose Ledger or Trezor
- Follow the on-screen connection guide
- Confirm the connection on your hardware device
Mobile Wallets
- Click "Mobile Wallet"
- Choose from Trust Wallet, Compass, or others
- Scan the QR code with your mobile wallet app
- Approve the connection in your mobile app
3. Network Setup
- The platform will automatically prompt to add SEI Network
- Click "Add Network" when prompted
- Confirm network addition in your wallet
4. Verification
- Your wallet address will appear in the top navigation
- Green checkmark indicates successful connection
- You can now create projects and manage payments
Troubleshooting Wallet Connection
Common Issues:
- Popup Blocked: Allow popups for contracting.app
- Wrong Network: Switch to SEI Mainnet in your wallet
- Connection Failed: Refresh page and try again
Organizations & Team Management
Registering an Organization
1. Create New Organization
- Navigate to Construction → Register Organization
- Or click "Register Organization" from Quick Actions on the Projects page
2. Organization Details Form
Organization Registration:
┌─────────────────────────────────────┐
│ Organization Name: [ABC Construction] │
│ Type: [General Contractor▼]│
│ Ethereum Address: [0x1234...5678 ] │
│ Email: [info@abc.com ] │
│ Business License: [CA-12345 ] │
│ Address: [123 Main St... ] │
│ Phone: [+1-555-123-4567 ] │
└─────────────────────────────────────┘
3. Organization Types
- Developer - Property developers
- General Contractor - Main contractors
- Subcontractor - Specialized contractors
- Materials Supplier - Material providers
4. Automatic Admin Access
- When you create an organization, you're automatically added as an admin
- You receive all permissions (milestone approval, payment authorization, contract signing)
- Your role is set based on organization type
Joining an Organization
1. Get Invite Code
- Request an invite code from the organization owner
- Or use a shared invite link
2. Join Process
- Go to Construction → Projects page
- Click "Join Organization" button in Quick Actions
- Enter the invite code
- Select your role (Project Manager, Accountant, Signer, etc.)
- Enter your job title
- Click "Join Organization"
3. Role Permissions
Different roles have different permissions:
- Project Managers: Can approve milestones and sign contracts
- Accountants: Can authorize payments
- Signers: Can sign contracts
- Main Roles (Developer, General Contractor): Have all permissions
Creating Construction Projects
New Construction Project Creation
1. Start New Project
- Navigate to Construction → Projects
- Click "Create New Project" button (top right)
- Or use Quick Actions → Create Project
2. Project Information Form
Project Creation Form:
┌─────────────────────────────────────┐
│ Project Name: [Office Building Renovation] │
│ Description: [Complete renovation of...] │
│ Total Contract Amount: [$1,500,000.00] │
│ Start Date: [01/15/2025 ] │
│ End Date: [12/31/2025 ] │
└─────────────────────────────────────┘
Important: All amounts are in USD, not cryptocurrency.
3. Add Project Phases
- Click "+ Add Phase"
- Enter phase name (e.g., "Foundation", "Framing", "Finishing")
- Set phase order/number
- Define phase budget (portion of total contract amount)
4. Add Milestones to Phases
- For each phase, click "+ Add Milestone"
- Enter milestone name (e.g., "Foundation Complete", "Inspection Passed")
- Set milestone payment amount (in USD)
- Add description and deadline
- Milestones must be approved before phase payment
5. Add Project Participants
- Click "+ Add Participant"
- Select organization from your contacts or enter new one
- Choose contract role:
- Developer Role
- General Contractor Role
- Subcontractor Role
- Materials Supplier Role
- Or specific roles like Project Manager, Accountant, etc.
- Enter Ethereum address (required for blockchain interactions)
- Set approval status
6. Blockchain Deployment (Optional)
- Choose to deploy project to blockchain (SEI Mainnet)
- Requires connected wallet and small amount of SEI for gas fees
- Creates immutable smart contract
- Enables automated milestone approvals and payments
7. Review & Create
- Review all project details
- Verify participant list and roles
- Check milestone amounts total correctly
- Click "Create Project"
- If deploying to blockchain, confirm transaction in wallet
Managing Construction Projects
Projects List Page
1. View Your Projects
- Navigate to Construction → Projects
- See all projects where:
- Your organization is the creator, OR
- You are a participant (via your Ethereum address)
2. View Toggle
- List View (Default): Table format showing:
- Project name and description
- Status (Active, Completed, On Hold)
- Total contract amount (in USD)
- Created date
- Action buttons (View, Blockchain Info)
- Grid View: Card format with visual project cards
- Toggle between views using buttons in top right
- Your preference is saved automatically
3. Quick Actions Section
The Quick Actions panel provides shortcuts to:
- Create Project - Start a new construction project
- Register Organization - Create a new organization
- Payment Status - View payment dashboard
- Construction Dashboard - Main construction overview
- Organize Team - Manage team members
- Lien Waivers - Manage lien waiver requests
- Join Organization - Join an existing organization
4. Project Actions
From the projects list, you can:
- View Details - Open project dashboard
- Blockchain Info - View smart contract details (if deployed)
- Filter & Search - Find specific projects quickly
Project Dashboard & Details
Project Dashboard Overview
1. Access Project Dashboard
- Click "View" button on any project from the list
- Or click project name in grid view
2. Dashboard Sections
Project Information
- Project name, description, status
- Total contract amount (displayed in USD)
- Start and end dates
- Creator organization
Blockchain Information (if deployed)
- Contract address (clickable link to blockchain explorer)
- Network (SEI Mainnet)
- Deployment transaction hash
- Blockchain status
Phases & Milestones
- All project phases listed
- Milestones within each phase
- Approval status for each milestone
- Payment status indicators
Project Participants
- Table showing all participants
- Organization name, role, Ethereum address
- Approval status
- Click any participant row to view detailed information in a modal
3. Participant Details Modal
When you click a participant row:
- Organization Name: Full organization details
- Contract Role: Badge showing role type
- Ethereum Address: Full address with copy button
- Explorer Link: View address on blockchain explorer (if applicable)
- Approval Status: Whether participant has approved the project
- Approved At: Timestamp of approval (if approved)
4. Project Actions
From the dashboard, you can:
- Approve Milestones - If you have approval permissions
- Approve Phases - After all milestones are approved
- View Blockchain - Open contract on explorer
- Edit Project - Modify project details (if permitted)
- Add Participants - Invite more organizations
Milestones & Payments
Milestone Approval Process
1. Prerequisites
To approve milestones, you need:
- Membership in the organization that created the project
- Organization role with milestone approval permissions:
- Project Managers
- Developers
- General Contractors
- Organization admins
- Connected cryptocurrency wallet (for blockchain transactions)
2. Approving a Milestone
- Navigate to project dashboard
- Find the milestone in the Phases & Milestones section
- Click "Approve" button on pending milestones
- Confirm transaction in your wallet (if project is on blockchain)
- Milestone status updates to "Approved"
3. Phase Approval
After all milestones in a phase are approved:
- Click "Approve Phase" button
- This makes the phase eligible for payment
- Lien waivers are automatically requested from all payees
- Phase status updates to "Approved"
4. Payment Authorization
To release payment:
- User with payment authorization permission must approve
- Navigate to Construction → Payment Status dashboard
- Review pending payments
- Authorize payment release
- Payment is processed via smart contract or traditional methods
5. Troubleshooting Approval Issues
If you get "user does not have milestone approval rights":
- Verify you're a member of the creator organization
- Check your organization role has approval permissions
- Ensure you have a connected wallet
- If you created the organization, you should have permissions automatically
- Contact support if issues persist
Payment Status Dashboard
1. Access Payment Dashboard
- Navigate to Construction → Payment Status
- Or use Quick Actions → Payment Status
2. Dashboard Features
- Pending Approvals: Milestones awaiting approval
- Approved Phases: Phases ready for payment
- Payment History: All completed payments
- Transaction Details: Blockchain transaction hashes and links
3. Payment Methods
Payments can be processed via:
- Electronic Checks (E-Checks): ACH bank transfers
- Blockchain Payments: Cryptocurrency via smart contracts
- Hybrid: Combination of both methods
All amounts are in USD.
Lien Waivers
Automatic Lien Waiver Generation
1. When Waivers Are Generated
- Lien waivers are automatically requested when you approve a phase for payment
- System generates state-compliant waiver documents
- Waivers are sent to all payees in the phase
2. Managing Lien Waivers
- Navigate to Construction → Lien Waivers
- Or use Quick Actions → Lien Waivers
- View all waiver requests and their status
- Track which participants have signed
- Download completed waivers
3. State Compliance
- Waivers are automatically formatted for your project's state
- Different states have different requirements
- See State Legal Requirements guide for details
Managing Contracts
Contract Dashboard
1. View All Contracts
- Go to Contracts section
- See list of all your projects with:
- Project Name and Description
- Total Value and Status
- Participants Count
- Completion Percentage
2. Contract Details View
- Click any contract to see full details
- Overview Tab: Basic information and status
- Participants Tab: Team member roles and permissions
- Milestones Tab: Payment schedules and progress
- Documents Tab: All project files and approvals
- Activity Tab: Full project history
3. Contract Actions
Available Actions:
┌─────────────────────────────────────┐
│ [Add Participant] [Edit Milestone] │
│ [Upload Document] [Process Payment]│
│ [Invite Inspector] [Export Data] │
│ [Archive Project] [Duplicate] │
└─────────────────────────────────────┘
Modifying Contracts
1. Add New Participants
- Click "Add Participant" in contract details
- Enter email or wallet address
- Select appropriate role and permissions
- All existing participants must approve addition
2. Modify Milestones
- Click "Edit" next to any milestone
- Adjust payment amounts (requires approval)
- Update deadlines and requirements
- Changes require majority approval
3. Update Project Information
- Click "Edit Project" button
- Modify description, timelines
- Add or remove project categories
- Changes take effect immediately
Payment & Check Management
Creating Payment Checks
1. Start New Check
- Click "Create Check" from dashboard
- Or go to Checks → New Check
2. Check Details Form
Payment Check Form:
┌─────────────────────────────────────┐
│ Recipient: [Select Contact ▼] │
│ Amount: [$5,000.00 ] │
│ Project Link: [Office Building ▼] │
│ Payment For: [Foundation Work ] │
│ Due Date: [01/30/2025 ] │
│ Notes: [Progress payment.] │
└─────────────────────────────────────┘
3. Link to Project (Optional)
- Select project from dropdown
- Check automatically links to blockchain contract
- Provides audit trail and transparency
- Enables automatic milestone tracking
4. Review & Issue
- Verify all details are correct
- Click "Issue Check"
- Check receives unique number (e.g., CHK-20250102-001)
- Recipient receives email notification
Managing Payment History
1. Check Dashboard
- View all issued and received checks
- Filter by status (Pending, Completed, Cancelled)
- Sort by date, amount, or recipient
- Search by check number or project
2. Check Status Tracking
Check Status Indicators:
┌─────────────────────────────────────┐
│ 🟡 Pending - Awaiting processing │
│ 🟢 Completed - Successfully paid │
│ 🔴 Cancelled - Check voided │
│ 🔵 Processing - Payment in progress │
└─────────────────────────────────────┘
3. Check Actions
- View Details: Full check information
- Download PDF: Printable check format
- Cancel Check: Void unprocessed checks
- Duplicate: Create similar check quickly
Document Upload & Management
Uploading Project Documents
1. Document Upload Interface
- Go to Documents section
- Click "+ Upload Document"
- Or drag and drop files directly
2. Document Information
Document Upload Form:
┌─────────────────────────────────────┐
│ File: [Choose File... ] │
│ Name: [Blueprint v2.1 ] │
│ Category: [Architectural ▼] │
│ Project: [Office Building ▼] │
│ Description: [Updated floor plans] │
│ Verification: [✓] Require approval │
└─────────────────────────────────────┘
3. File Categories
- Architectural: Plans, blueprints, drawings
- Legal: Contracts, permits, licenses
- Financial: Invoices, receipts, budgets
- Photos: Progress photos, inspections
- Reports: Safety, quality, inspection reports
- Certificates: Insurance, compliance docs
4. Security Features
- Files stored on IPFS (decentralized storage)
- Cryptographic verification prevents tampering
- Access controls based on project roles
- Audit trail tracks all document access
Document Verification Process
1. Automatic Processing
- Document uploaded to secure storage
- Unique hash generated for verification
- Blockchain record created automatically
- Team members notified of new document
2. Approval Workflow
- Designated approvers receive notifications
- Click "Review Document" to examine
- Add comments or request changes
- Click "Approve" or "Request Revision"
3. Document Status
Status Indicators:
┌─────────────────────────────────────┐
│ ⏳ Pending Review - Awaiting approval│
│ ✅ Verified - Approved & signed│
│ ❌ Rejected - Needs revision │
│ 🔄 Updated - New version added│
└─────────────────────────────────────┘
Project Collaboration
Team Communication
1. Project Chat
- Each project has built-in messaging
- @mention team members for notifications
- Share files directly in conversation
- Message history preserved permanently
2. Activity Notifications
- Real-time alerts for important events
- Email notifications for major milestones
- Mobile push notifications (if app installed)
- Customizable notification preferences
3. Role-Based Permissions
Permission Matrix:
┌─────────────────────────────────────┐
│ │Owner│Contractor│Worker │
│ View │ ✅ │ ✅ │ ✅ │
│ Edit │ ✅ │ ✅ │ ❌ │
│ Payments │ ✅ │ ✅ │ ❌ │
│ Approve │ ✅ │ ✅ │ ❌ │
│ Admin │ ✅ │ ❌ │ ❌ │
└─────────────────────────────────────┘
Progress Tracking
1. Milestone Dashboard
- Visual progress bars for each milestone
- Completion percentages and deadlines
- Photo documentation of work stages
- Automatic payment release triggers
2. Timeline View
- Gantt-style project timeline
- Dependency tracking between milestones
- Critical path identification
- Delay impact analysis
3. Reporting
- Weekly Progress Reports - Automated summaries
- Financial Reports - Payment and budget tracking
- Compliance Reports - Regulatory requirements
- Custom Reports - Tailored to your needs
Account Settings
Profile Management
1. Basic Information
Profile Settings:
┌─────────────────────────────────────┐
│ Name: [John Doe ] │
│ Email: [john@company.com ] │
│ Company: [ABC Construction ] │
│ Phone: [+1-555-123-4567 ] │
│ Time Zone: [EST (UTC-5) ▼] │
└─────────────────────────────────────┘
2. Security Settings
- Change Password: Update account password
- Multi-Factor Auth: Enable TOTP or hardware keys
- Login History: Review account access
- Active Sessions: Manage logged-in devices
3. Notification Preferences
- Email Notifications: Project updates, payments
- SMS Alerts: Critical milestones and approvals
- Browser Notifications: Real-time activity
- Mobile Push: App-based notifications
Wallet & Payment Settings
1. Connected Wallets
- View all linked cryptocurrency wallets
- Set primary wallet for transactions
- Add additional wallets for backup
- Remove unused or compromised wallets
2. Payment Preferences
- Default payment methods
- Currency preferences (USD, SEI, etc.)
- Transaction limits and approvals
- Fee preferences (speed vs cost)
3. Backup & Recovery
- Download account data backup
- Export project information
- Recovery phrase management
- Emergency contacts setup
Mobile Experience
Mobile-Optimized Features
1. Responsive Design
- Full platform functionality on mobile devices
- Touch-optimized interface elements
- Swipe gestures for navigation
- Mobile-specific shortcuts
2. Key Mobile Features
- Quick Actions: Fast access to common tasks
- Photo Upload: Direct camera integration
- QR Codes: Easy wallet connections
- Offline Mode: Limited functionality without internet
3. Mobile-Specific Workflows
Mobile Quick Actions:
┌─────────────────────────────────────┐
│ 📷 Photo Upload 📋 Quick Check │
│ 📍 Location Tag 📞 Contact Team │
│ 🔔 Notifications 📊 Status Update │
└─────────────────────────────────────┘
Mobile Wallet Integration
1. Mobile Wallet Connection
- Scan QR code with mobile wallet app
- One-tap approval for transactions
- Biometric authentication support
- Cross-device synchronization
2. Push Notifications
- Instant alerts for important events
- Payment confirmation requests
- Milestone completion notifications
- Security and approval alerts
Troubleshooting
Common Issues & Solutions
1. Wallet Connection Problems
Issue: "Wallet won't connect"
- Check if MetaMask is installed and unlocked
- Ensure you're on the correct network (SEI Mainnet)
- Disable ad blockers that might block popups
- Try refreshing the page and connecting again
Issue: "Wrong network detected"
- Platform will automatically prompt to switch networks
- Click "Switch Network" when prompted
- Or manually switch to SEI Mainnet in your wallet
2. Transaction Failures
Issue: "Transaction failed"
- Check wallet balance for network fees
- Increase gas limit if transaction is complex
- Wait for network congestion to clear
- Contact support if problem persists
Issue: "Payment not processing"
- Verify recipient address is correct
- Check project approval requirements
- Ensure sufficient approvals received
- Review transaction history for errors
3. Document Upload Issues
Issue: "File won't upload"
- Check file size (max 10MB)
- Verify file format is supported
- Ensure stable internet connection
- Try uploading smaller files first
Issue: "Document verification failed"
- Contact designated approvers directly
- Check if additional documentation needed
- Verify file integrity wasn't compromised
- Re-upload document if necessary
4. Project Management Issues
Issue: "Can't add team member"
- Verify you have admin permissions
- Check that member's email is correct
- Ensure member accepts invitation
- Contact existing team members for approval
Issue: "Milestone payments not releasing"
- Verify milestone completion requirements
- Check approval count meets threshold
- Ensure all required documents uploaded
- Review smart contract status
Getting Help
1. In-Platform Support
- Click "Help" icon in top navigation
- Use live chat for immediate assistance
- Browse FAQ for common questions
- Access video tutorials for visual guides
2. Contact Support
- Email: support@contracting.app
- Live Chat: Available 24/7
- Phone: 1-800-CHECKING (business hours)
- Community Forum: community.contracting.app
3. Emergency Support
Best Practices
Security Recommendations
1. Account Security
- Use unique, strong passwords
- Enable multi-factor authentication
- Regularly review login history
- Keep contact information updated
2. Wallet Security
- Use hardware wallets for large amounts
- Verify transaction details before signing
- Keep private keys secure and backed up
- Use different wallets for different purposes
3. Project Management
- Clearly define roles and permissions
- Document all project changes
- Maintain regular communication with team
- Keep project documentation updated
Efficiency Tips
1. Workflow Optimization
- Set up project templates for repeated use
- Use bulk actions for multiple items
- Configure notification preferences appropriately
- Organize documents with clear naming conventions
2. Team Collaboration
- Establish clear approval processes
- Use @mentions for urgent communications
- Schedule regular project review meetings
- Maintain shared project calendars
3. Financial Management
- Set up automated milestone payments
- Use project budgeting tools effectively
- Track expenses against original estimates
- Generate regular financial reports
This user interface guide is regularly updated based on platform improvements and user feedback. Last updated: February 2026