Welcome to ForgeX
ForgeX is a comprehensive bid management platform for construction companies, purpose-built for Precision Site Services to streamline the entire concrete construction bidding lifecycle — from estimation to project delivery.
Quick Start
Get up and running in 5 minutes
Core Concepts
Understand bids, scopes, and modules
Architecture
Explore the microservices design
API Reference
Integrate with our REST API
What is ForgeX?
ForgeX is a modular, cloud-native platform that transforms construction bidding from spreadsheet chaos into a streamlined digital workflow. Built on modern microservices architecture, ForgeX provides:
- 🎯 Precision Estimation - 6 specialized modules for accurate cost breakdowns
- 📊 Real-Time Cost Rollup - Automatic calculations from items → scopes → bids
- 🔄 Bid Lifecycle Management - Track bids from draft to completion
- 👥 Role-Based Access - Secure, granular permissions for your team
- 📱 Mobile-Ready - Field operations support (Phase 3)
Who is ForgeX For?
🧮Estimators
Your command center for bidding.
- Create detailed estimates using 6 specialized modules
- Manage pricing catalogs and variables
- Duplicate and template common bid types
- Generate professional PDF proposals
Typical workflow: Create bid → Add scopes → Fill modules → Review costs → Submit
📋Project Managers
Track your pipeline from bid to build.
- View all active bids and their status
- Monitor bid-to-project conversion
- Review cost breakdowns
- Approve purchase orders (Phase 2)
Typical workflow: Review bids → Track awards → Manage projects
🚚Operations Team
Bridge estimating and execution.
- Access awarded bid details
- Create purchase orders from bids
- Track material costs vs. estimates
- Monitor field operations
Typical workflow: Review awarded bids → Create POs → Track costs
🛡️Admins
Control the system and data.
- Manage users and permissions
- Configure pricing catalogs
- Set global variables (WC, overhead, profit)
- Review audit logs
Typical workflow: User management → Pricing updates → System configuration
Key Features at a Glance
📋 Bid Management
Create, track, and manage construction bids with a complete lifecycle:
- Draft → Edit freely, add/remove scopes and items
- Submitted → Sent to client for review
- Negotiation → Adjust pricing and terms
- Awarded → Won! Auto-converts to project (Phase 2)
- Lost → Track reasons for pipeline analysis
🧮 6 Estimation Modules
- Concrete
- Labor
- Equipment
- Materials
- Subcontractor
- Misc
Calculate dimensions, rebar, and mix costs
- Supports slabs, footings, walls, cylinders
- Auto-calculates square feet and cubic yards
- Rebar sizing and spacing calculations
- Auto-materializes concrete and rebar to Materials module
Track crew hours, rates, and soft costs
- Role-based hourly rates
- Auto-calculates FICA, FUTA, SUTA
- Dependent role logic (foremen, ops coordinators)
- Vehicle depreciation, fuel, insurance
Manage rentals, owned equipment, and delivery
- Equipment catalog with pre-configured rates
- Daily, weekly, monthly rental periods
- Fuel charges and delivery fees
- Truck haul costs for formwork
Track supplies with waste factors
- Material catalog integration
- Waste percentage calculations
- Tax exemption support
- Links to concrete items (prevents double-counting)
Pump services and third-party work
- 122-entry pump catalog (vendors, rates, reach)
- Joint saw rates (green saw, demo saw)
- Buffer markup for contingency
- Travel fees and minimum hours
Everything else
- Permits and fees
- Testing and inspection
- Temporary facilities
- Safety equipment
💰 Intelligent Cost Rollup
ForgeX automatically calculates costs at every level:
📦 Individual Items
↓ Calculate (material, labor, equipment costs)
📐 Scope Totals
↓ Apply scope multiplier (for repeated areas)
↓ Sum by module type
📊 Bid Totals
↓ Apply module markups (WC, overhead, profit, GL)
↓ Apply bid-level overhead & profit
💵 Final Bid Amount
No manual formulas. No spreadsheet errors. Costs update automatically when you add or edit items.
🔐 Enterprise Authentication
- Google Workspace OAuth - Single sign-on with your @precisionsiteservices.com account
- Role-Based Access Control - ADMIN, ESTIMATOR, PM, OPS, ACCOUNTING, FOREMAN
- Subdomain SSO - Seamless authentication across all services
- Audit Logging - Track who did what, when
The ForgeX Platform
ForgeX is built as a microservices platform with three core services:
- Bids Service (Live)
- Projects Service (Planned)
- Field Service (Planned)
Status: ✅ Fully Operational (Phase 1)
The core estimation and bid management service:
- Client & bid CRUD operations
- 6 estimation modules with auto-calculations
- Cost rollup (items → scopes → bids)
- Pricing catalog management
- PDF generation and file attachments
Status: ⏳ Phase 2
Purchase order workflow and cost tracking:
- Convert awarded bids to projects
- PO creation with type-specific fields
- Receipt upload and management
- PM approval workflow
- Accounting reconciliation
Status: ⏳ Phase 3
Mobile field operations:
- PIN-based worker authentication
- GPS clock-in/out with geofencing
- Timesheet management and approval
- Foreman dashboard
- Daily job logs
All services share authentication via the Portal (https://forge.precisionsiteservices.com) — sign in once, access everything.
Production Environment
| Service | URL | Status |
|---|---|---|
| Portal | https://forge.precisionsiteservices.com | ✅ Live |
| Bids | https://bids.precisionsiteservices.com | ✅ Live |
| Projects | https://projects.precisionsiteservices.com | ⏳ Phase 2 |
| Field | https://field.precisionsiteservices.com | ⏳ Phase 3 |
All production services are hosted on Google Cloud Platform with Firebase Hosting (frontend) and Cloud Run (backend).
Tech Stack
- Frontend
- Backend
- Infrastructure
- React 18 with TypeScript
- Tailwind CSS for styling
- shadcn/ui component library
- React Query for data fetching
- Zustand for state management
- Node.js with Express
- Prisma ORM for database access
- PostgreSQL (one database per service)
- Google OAuth 2.0 for authentication
- SuperTokens for session management
- Google Cloud Run for backend hosting
- Firebase Hosting for frontend CDN
- Cloud SQL for managed PostgreSQL
- Cloud Storage for file uploads
- Pub/Sub for inter-service events (Phase 2+)
Your First 5 Minutes
Ready to dive in?
Go to https://forge.precisionsiteservices.com and sign in with your @precisionsiteservices.com Google account.
Click the Bids tile to open the bid management interface.
Click Add Client, fill in company details, and save.
Click Add Bid, select your client, enter job details, and click Create.
Open your bid, click Add Scope, name it (e.g., "Foundation"), and save.
Navigate to the Concrete tab and add your first concrete item. Watch costs calculate automatically!
That's it! You've created your first bid in ForgeX. Explore the Quickstart Guide for a deeper walkthrough.
Next Steps
Quickstart Guide
Set up your development environment
Core Concepts
Learn the ForgeX data model
Creating a Bid
Step-by-step bid workflow
Estimation Modules
Deep dive into all 6 modules
Architecture
Understand the system design
API Reference
Integrate programmatically
ForgeX is actively developed. This documentation reflects Phase 1 (Bids Service). Features marked Phase 2/3 are planned for future releases.