Demo Igniters - Salesforce Demo Repository

A comprehensive collection of Salesforce demo components, agents, flows, and integrations for showcasing enterprise capabilities.

---

🚀 Quick Start

# Clone the repository
git clone https://github.com/samargo3/demo-igniters.git
cd demo-igniters

# Install dependencies
npm install

# Authenticate to your Salesforce org
sf org login web --alias my-demo-org

# Deploy metadata
sf project deploy start --target-org my-demo-org

---

📦 What's Included

🎯 Latest Feature: Proforma Resource Forecasting ⭐ NEW

Complete resource planning and profitability analysis tool for opportunities.

• Custom Objects: Resource_Forecast__c with Master-Detail to Opportunity
• LWC Component: Professional inline-editable grid for resource management
• Validation: Stage gate preventing Closed Won without resource forecasting
• Auto-Calculation: Real-time profitability and margin calculations
• Test Coverage: 98.7% (exceeds 75% requirement)

📚 Documentation:

• Complete Guide
• Quick Reference
• Architecture
• Deployment Summary
• UI Improvements

---

🤖 Agentforce Demos

Deal Desk Agent

AI-powered deal desk automation for contract analysis and approvals.

• README
• Quick Reference
• Deployment Plan
• Checklist

Employee FAQ Agent

Conversational AI for employee questions and knowledge base.

• Demo Guide
• Checklist
• Agentforce FAQ

MSA Analysis Agent

Master Service Agreement analysis and insights.

• Architecture
• Quick Start
• Analysis Guide

Account & Contract Agents

• Contract Analysis Guide
• Contract Analysis Tutorial
• Comparison Guide
• Account Files

Framework Documentation:

• Agent Framework Development
• Agent Apex Guide

---

💡 Einstein Features

Einstein Lead Scoring

Predictive lead scoring with high-quality demo data.

• Setup Guide
• Custom Leads Guide

---

🔄 Flow Automation

Declarative automation for common demo scenarios.

• Deployment Guide
• Quick Reference
• Build Checklist
• Comparison

---

📊 Opportunity Management

Opportunity Files & Insights

• README
• Summary
• Deployment
• Quick Reference
• Retriever Guide
• Optimization

---

📈 Reports & Analytics

Custom reports and dashboards for demo scenarios.

• Reports Guide
• Deployment Summary

---

🎨 Lightning Web Components

Recommended Next Product

Account page component for product recommendations.

• Documentation

Proforma Manager

Resource forecasting and profitability calculator.

• See Proforma documentation above

Jira Integration Button

External system integration demo component.

• Guide

---

🔧 Integrations & Tooling

MCP (Model Context Protocol) Servers

Connect AI assistants to Salesforce and GitHub.

• MCP Setup
• MCP Walkthrough
• Salesforce MCP Server (SOQL, Apex, Metadata Deploy)
• GitHub MCP Server (Issues, PRs, Code Search)

GitHub Setup

• GitHub Setup Guide

Prompt Builder

AI prompt templates and data providers.

• Start Here
• README
• Quick Reference
• Index
• Architecture
• Summary
• Data Provider Guide

---

📝 Demo Scripts & Guides

Client-Specific Demos

• New Mont Capital Demo Script (788 lines)
• New Mont Capital Business Case
• New Mont Capital Cheat Sheet
• Starburst Demo Checklist
• Starburst README
• Starburst Setup

General Demo Guides

• Demo Playbook - End-to-end demo setup
• Quick Start Demo Hub
• Sales Demo Hub Guide
• Product Demo Guide
• Demo Admin Panel Guide

Use Case Documentation

• Use Case Checklist
• Cursor Salesforce Use Cases

---

🛠️ Development

Prerequisites

• Node.js 18+
• Salesforce CLI (sf)
• Authenticated Salesforce org
• Git

Project Structure

demo-igniters/
├── force-app/main/default/       # Salesforce metadata
│   ├── classes/                  # Apex classes
│   ├── triggers/                 # Apex triggers
│   ├── lwc/                      # Lightning Web Components
│   ├── objects/                  # Custom objects & fields
│   ├── flows/                    # Flow definitions
│   └── ...
├── scripts/                      # Node.js scripts
│   ├── import-leads-bulk.js
│   ├── generate-products.js
│   ├── create-demo-flow.js
│   └── ...
├── data/                         # Sample data & CSVs
├── mcp/                          # MCP server implementations
│   └── salesforce-mcp-server.js
├── specs/                        # Agent specifications
└── docs/                         # Additional documentation

Useful NPM Scripts

# Lead generation
npm run leads:quick              # Quick lead generation
npm run leads:tech               # Tech industry leads
npm run leads:healthcare         # Healthcare leads

# Product generation
npm run products:quick           # Quick product generation
npm run products:tech            # Tech products

# Flows
npm run flow:create              # Create demo flows
npm run flow:deploy              # Deploy flows

# SOQL queries
npm run soql:count               # Count leads
npm run soql:qualified           # Get qualified leads

# MCP Server
npm run mcp:start                # Start Salesforce MCP server

# Demo setup
npm run demo:setup               # Complete demo setup
npm run demo:seed                # Seed demo data

---

📚 Documentation Index

By Feature Area

Agents & AI

• Agent Framework Development
• Agent Apex Guide
• Deal Desk Agent
• Employee FAQ Agent
• MSA Analysis Agent

Sales & Revenue

• Proforma Resource Forecasting
• Opportunity Files
• Einstein Lead Scoring
• Recommended Next Product

Automation

• Flow Deployment
• Contract Analysis

Integration & Tools

• MCP Setup
• GitHub Setup
• Jira Integration

Demo Execution

• Demo Playbook
• Quick Start Demo Hub
• New Mont Capital Script

---

🧪 Testing

Run Apex Tests

# Run all tests
sf apex run test --test-level RunLocalTests --target-org my-demo-org

# Run specific test class
sf apex run test --tests ProformaManagerControllerTest --target-org my-demo-org

# With code coverage
sf apex run test --test-level RunLocalTests --code-coverage --target-org my-demo-org

Test Coverage

Component	Coverage	Status
ProformaManagerController	96%	✅
OpportunityResourceValidationHandler	100%	✅
OpportunityFileRetriever	95%+	✅
PromptBuilderDataProvider	95%+	✅

---

🚀 Deployment

Deploy to Scratch Org

# Create scratch org
sf org create scratch --definition-file config/project-scratch-def.json --alias my-scratch

# Deploy metadata
sf project deploy start --target-org my-scratch

# Assign permissions
npm run demo:permissions

# Seed data
npm run demo:seed

Deploy to Sandbox/Production

# Deploy specific metadata
sf project deploy start --metadata CustomObject:Resource_Forecast__c --target-org my-sandbox

# Deploy with tests
sf project deploy start --test-level RunLocalTests --target-org my-sandbox

# Validate deployment (no actual deployment)
sf project deploy start --test-level RunLocalTests --target-org my-prod --dry-run

---

🎓 Learning Resources

Salesforce Documentation

• Salesforce DX Developer Guide
• Lightning Web Components
• Apex Developer Guide
• Agentforce Documentation

Related Resources

• Agentforce Tips & Tricks

---

🤝 Contributing

This is a demo repository. For questions or improvements, create an issue or contact the maintainer.

---

📞 Support

For technical questions or demo setup assistance:

• Review the documentation guides
• Check the troubleshooting sections in specific guides
• Consult the Demo Playbook

---

📅 Recent Updates

January 15, 2026

• ✅ Added Proforma Resource Forecasting feature
• ✅ Fixed GitHub MCP server configuration
• ✅ Updated Salesforce MCP server to SDK v1.x
• ✅ Comprehensive documentation updates
• ✅ UI improvements and bug fixes

---

📄 License

This is a demo repository for Salesforce demonstrations and training purposes.

---

Built with ❤️ for Salesforce Demos