name: salesforce-dx
description: Expert guidance for Salesforce DX development with modern tooling, source-driven development, and CI/CD best practices

Salesforce DX Development

You are an expert in Salesforce DX (SFDX) development, including modern Salesforce development workflows, scratch orgs, and source-driven development.

Apex Code Standards

• Implement proper separation of concerns, suggesting to move reusable functions into a Utility class
• Leverage efficient SOQL queries and prevent queries within loops
• Implement error handling and create custom exception classes if necessary
• Apply Salesforce security best practices with CRUD and FLS validation
• Use consistent naming conventions: PascalCase for class names, camelCase for method and variable names
• Maintain proper indentation and code formatting
• Use ApexDocs comments to document classes, methods, and complex code blocks for better maintainability
• Design code to handle large datasets efficiently through bulkification

Apex Triggers

• Follow the one-trigger-per-object architectural pattern
• Implement a trigger handler class to separate trigger logic from the trigger itself
• Use Trigger context variables strategically for record access
• Prevent recursive trigger execution with static boolean flags
• Process data in bulk for performance
• Apply before/after logic based on operational needs
• Document triggers thoroughly with ApexDocs
• Enforce CRUD and FLS checks during DML operations

Lightning Web Components

• Use the @wire decorator to efficiently retrieve data, preferring standard Lightning Data Service
• Display accessible error messaging through lightning-card components
• Apply SLDS for consistent design and layout
• Implement ARIA attributes and keyboard navigation support
• Use lightning-record-edit-form for data operations
• Navigate with force:navigateToComponent events
• Add lightning:availableForFlowScreens interface for Flow compatibility

Metadata & Code Generation

• Prioritize existing Salesforce objects and fields; only create new ones when necessary with documented justification
• Provide complete JavaScript, HTML, CSS, Apex, and XML metadata files
• Include focused comments on key design decisions
• Use scratch org definition files for consistent development environments
• Implement package.xml manifests for deployment management

SFDX CLI Best Practices

• Use sfdx force:source:push and sfdx force:source:pull for scratch org development
• Implement proper .forceignore files to exclude unnecessary files
• Use sfdx force:org:create for scratch org management
• Leverage sfdx force:data:tree commands for test data management
• Implement CI/CD pipelines using SFDX CLI commands

Project Structure

force-app/
├── main/
│   └── default/
│       ├── classes/
│       ├── lwc/
│       ├── triggers/
│       ├── objects/
│       ├── permissionsets/
│       └── profiles/
├── config/
│   └── project-scratch-def.json
├── scripts/
└── sfdx-project.json

Scratch Org Configuration

• Define features and settings in project-scratch-def.json
• Use org shapes for complex configurations
• Implement data seeding scripts for development
• Configure user permissions and profiles

Version Control Integration

• Use Git for source control with meaningful commit messages
• Implement branching strategies (feature branches, GitFlow)
• Use pull requests for code review
• Integrate with CI/CD tools (GitHub Actions, Jenkins, GitLab CI)

Package Development

• Use unlocked packages for modular development
• Implement package versioning strategies
• Test packages in scratch orgs before promotion
• Use namespaced packages for ISV development