Integrations Hub Documentation

This directory contains the Integrations hub pages—a key part of DigitalStaff’s marketing strategy targeting businesses needing to connect and automate their software systems.

Overview

The Integrations hub showcases how we connect business software like QuickBooks, Xero, Buildertrend, Power BI, Excel, and Azure with other systems to eliminate manual data entry and enable workflow automation. Each integration page demonstrates:

This is similar to Zapier, but focused on apps that don’t have Zapier integration or require more sophisticated enterprise automation.

File Structure

/src/pages/integrations/
├── index.astro                      # Hub landing page (main integrations directory)
├── integrations-template.astro      # Template for creating new integration pages
├── quickbooks.astro                 # QuickBooks Online integration page
├── xero.astro                       # Xero integration page
├── buildertrend.astro              # Buildertrend integration page
├── powerbi.astro                    # Power BI integration page
├── excel.astro                      # Microsoft Excel integration page
├── azure.astro                      # Microsoft Azure integration page
└── README.md                        # This file

Creating a New Integration Page

Step 1: Copy the Template

cd src/pages/integrations
cp integrations-template.astro your-new-integration.astro

Use kebab-case for filenames (e.g., salesforce.astro, shopify.astro). Keep them short and memorable for SEO.

Step 2: Customize the Content

Open your new file and update the following sections:

1. Integration Information

const integrationTitle = "Salesforce";
const integrationDescription = "Automate Salesforce integration with...";
const integrationCategory = "CRM"; // Options: Financial Software, Construction Management, Business Intelligence, Cloud Platforms, Office & Productivity, CRM, E-commerce

2. Statistics

Update the stats to reflect integration automation benefits:

const stats = [
  {
    value: '95%',
    label: 'Time Saved',
    icon: '⏱️',
    description: 'Reduction in manual data entry and transfer'
  },
  // ... more stats
];

3. Challenges

Define the problems businesses face with manual integration:

const challenges = [
  {
    title: 'Double Data Entry',
    description: 'Why manual data entry between systems is problematic...',
    icon: '⌨️'
  },
  // ... more challenges
];

4. Connected Systems

Show what systems this integration connects to:

const connectedSystems = [
  {
    name: 'Accounting Software',
    description: 'Sync with QuickBooks, Xero, NetSuite...',
    icon: '💰'
  },
  // ... more connected systems
];

5. Capabilities

List specific integration features and automations:

const capabilities = [
  {
    title: 'Automated Data Sync',
    description: 'Real-time synchronization between systems...',
    icon: '🔄',
    benefits: [
      'Bi-directional data flow',
      'Conflict resolution handling',
      'Field mapping and transformation',
      'Real-time or scheduled sync'
    ]
  },
  // ... more capabilities
];

6. FAQs

Add integration-specific FAQs:

const faqs = [
  {
    question: 'How long does it take to set up this integration?',
    answer: 'Most integrations are up and running within 2-4 weeks...'
  },
  // ... more FAQs
];

7. Case Studies (Optional)

const caseStudies = [
  {
    title: 'Company Name: Integration Success Story',
    description: 'Full case study description...',
    image: caseStudyImages.manufacturing,
    metrics: ['15 hrs/week saved', '$30K annual savings'],
    client: 'Company Name',
    industry: 'Industry'
  }
];

Step 3: Update the Hub Index Page

Add your new integration to /src/pages/integrations/index.astro:

const integrations = [
  // ... existing integrations
  {
    name: 'Salesforce',
    slug: 'salesforce',
    category: 'CRM',
    description: 'Brief description of the integration automation...',
    icon: '☁️'
  }
];

Update the categories if needed:

const categories = {
  'Financial Software': ['Financial Software'],
  'Construction Management': ['Construction Management'],
  'Business Intelligence': ['Business Intelligence'],
  'Office & Productivity': ['Office & Productivity'],
  'Cloud Platforms': ['Cloud Platforms'],
  'CRM': ['CRM'], // Add if needed
  'E-commerce': ['E-commerce'] // Add if needed
};

Step 4: Test Your Page

  1. Start the dev server:

    npm run dev
    
  2. Visit your page:

    http://localhost:4321/integrations/your-new-integration
    
  3. Check that all sections render correctly

  4. Test navigation from the hub page

  5. Verify breadcrumbs and CTAs work

Custom Layout: IntegrationsLayout.astro

All integration pages use the custom IntegrationsLayout.astro located at /src/layouts/IntegrationsLayout.astro.

Key Features:

Props Reference:

interface Props {
  title: string;                         // Integration name (e.g., "QuickBooks Online")
  description: string;                   // SEO description and hero subtitle
  integrationLogo?: ImageMetadata;       // Logo placeholder for the integration
  integrationCategory?: string;          // Category badge (Financial Software, CRM, etc.)
  stats?: StatItem[];                    // Impact statistics
  challenges?: ChallengeItem[];          // Manual integration challenges
  capabilities?: CapabilityItem[];       // Integration features
  connectedSystems?: SystemItem[];       // What it connects to
  caseStudies?: CaseStudyItem[];         // Success stories
  testimonials?: TestimonialItem[];      // Client testimonials
  faqs?: FAQItem[];                      // Frequently asked questions
  ctaTitle?: string;                     // CTA section title
  ctaDescription?: string;               // CTA section description
  ctaButtonText?: string;                // CTA button text
  ctaButtonLink?: string;                // CTA button link
}

SEO Best Practices

Each integration page should:

  1. Target specific keywords: “[software] automation”, “[software] integration”, “[software] + [industry]”
  2. Include clear value propositions: Time savings, accuracy, real-time sync
  3. Use descriptive URLs: /integrations/quickbooks not /integrations/qbo
  4. Optimize meta descriptions: Include software name, integration benefit, and CTA
  5. Focus on long-tail keywords: “automate quickbooks and buildertrend”, “connect xero to shopify”

Integration pages are integrated into:

  1. Main Navigation (Desktop & Mobile):

  2. Footer:

  3. Breadcrumbs:

Excluding the Template from Search and Build

The integrations-template.astro file is excluded from:

  1. Pagefind Search: Uses excludeFromSearch={true} prop (if implemented in Layout)
  2. Public Access: Redirects to 404 via netlify.toml:
    [[redirects]]
      from = "/integrations/integrations-template"
      to = "/404"
      status = 404
      force = true
    

Integration Categories

Current categories:

Content Strategy

When creating integration pages, focus on:

  1. Pain Points: What makes manual integration time-consuming/error-prone?
  2. Integration Capabilities: Specific data that syncs and workflows automated
  3. Connected Systems: What other software this integrates with
  4. Real-time Sync: Emphasize automatic, real-time data synchronization
  5. Social Proof: Case studies showing time saved and errors eliminated
  6. No Zapier: Position as solution for apps that don’t have Zapier integration
  7. Clear CTAs: Every section should guide toward integration assessment

SEO Keywords to Target

For each integration page, target these keyword patterns:

  1. [Software] automation: “quickbooks automation”, “xero automation”
  2. [Software] integration: “buildertrend integration”, “power bi integration”
  3. [Software] + [Industry]: “quickbooks construction”, “xero ecommerce”
  4. [Software] + [Other Software]: “quickbooks buildertrend”, “xero shopify”
  5. Automate [Software]: “automate excel reporting”, “automate azure workflows”
  6. Connect [Software]: “connect quickbooks to buildertrend”

Images

Integration pages use images from /src/lib/images.ts:

import { caseStudyImages, testimonialHeadshots } from '../../lib/images';

// Use in your page:
image: caseStudyImages.manufacturing
image: testimonialHeadshots.kevin

Integration Logos (Future Enhancement)

Plan to add integration logos:

  1. Create /src/assets/integrations/ directory
  2. Add logo PNG files (e.g., quickbooks-logo.png)
  3. Export from /src/lib/images.ts
  4. Reference as integrationLogo prop

Future Enhancements

Potential improvements:

Maintenance

Regular tasks:

Track and potentially create dedicated pages for popular combinations:

  1. QuickBooks + Buildertrend (Construction accounting)
  2. Xero + Shopify (E-commerce financial automation)
  3. Salesforce + QuickBooks (CRM to accounting)
  4. Excel + Power BI (Reporting and analytics)
  5. Azure + On-Premise Systems (Hybrid cloud integration)

Questions?

For questions about the Integrations hub:


Last Updated: November 2025 Maintainer: DigitalStaff Development Team