Skip to content

About

D'fflib is an extension to FFLib. It's backward compatible, provided as unlocked package, and improves developer-experience by accelerators, shortcuts, standardisations and adopting latest Salesforce features. All to truly enable developers (and AI agents) to deliver scalable, maintainable and testable Apex.

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Repository files navigation

D'fflib

Licence: BSD 3-Clause

The framework that truly enables Apex developers and AI agents to deliver scalable, maintainable and testable Salesforce functionality. It extends the fflib (apex-common) framework with redesigns, shortcuts, accelerators and the latest Salesforce features, to simplify usage and adoption for a better developer experience, while improving performance.

fflib is the open-source Apex Enterprise Patterns library (apex-common and apex-mocks): it splits a Salesforce application into Domain, Selector, Service and Unit of Work layers. Separating concerns in Apex keeps the code scalable and maintainable.

D'fflib is an extension to fflib, focused on a strong developer experience. It equips developers with shortcuts, standardisation and more native Salesforce functionality, and is provided as an unlocked package for easy installation.

In addition to the coding enhancements, D'fflib comes with a full documentation website, including snippets for core fflib and D'fflib extensions (code examples), and AI enablement via our skill, LLMs.txt and LLMs-full.txt.

Interested in the benefits? See our business and technical benefits pages.

D'fflib and fflib

fflib D'fflib
Layers Domain, Selector, Service, Unit of Work The same layers, extended
Where the code lives Source you deploy from your own project An unlocked package, so the framework code stays out of your repository
Class names fflib_ dfflib_ classes next to the fflib_ classes
Setup In code, in your Application class Metadata-driven, through custom metadata types

After alignment with the fflib AEP core team, D'fflib is provided as an extension to fflib. This also enables a gradual or partial upgrade of your code, depending on your capacity. Existing classes can extend or call fflib_ classes, while others update references to the dfflib_ classes.

Features

Each feature links to its page on the documentation website, with the reasoning, the full method list and code examples.

Feature What you get
Accelerators & Utilities One-line mocks for every layer with defineMock(). Ready-to-use input validation methods, exception types and collection utilities to filter, group and collect values from SObject lists.
Metadata-driven application No Application class to write or merge. Layer mappings live in custom metadata, so each developer adds a record instead of editing one shared class. Works with SFDX packaging and avoids org-wide compile or merge errors.
Database Context Enabling a calling class to control both sharing and FLS/CRUD with one enum. Standardised signature for Unit of Work and Selector: SEL_Leads.newInstance( dfflib_Database.Context.FULL ). No more without sharing inner classes or withSharing flags. Built on user mode (API 57+).
Selectors 2.0 Unit test a selector without running a query, with built-in assertion shortcuts. Supports Database.Cursor, aggregates (SUM, COUNT, HAVING) and SOQL features such as TYPEOF, DISTANCE and FOR UPDATE.
Unit of Work 2.0 14x faster commit cycles. Supports most Database operations like SaveResults, DMLOptions, Immediate, complex relationships, approvals and emails. Test coverage raised from 68% to 98%.
Trigger Handler Framework Robust and bulkified trigger handlers. Each handler runs initialize(), process() and finalize(), which keeps SOQL and DML out of loops. All handlers share one Unit of Work commit and are easy to unit test.
Test Data Builder Framework Fluent, typed test data such as TestFactory.anAccount(), with parent and child records linked for you. Formula and read-only fields can be set without DML. Choose .mock(), .mockWithIds() or .save(). A new required field means one fix, not hundreds.
Unlocked package Easy install and update, with the ability to remove framework classes from your repository, shaving ~5 minutes off every full test run.

Install

D'fflib comes in two packages.

Full package BYO package (bring your own fflib)
Includes fflib and dfflib_ classes dfflib_ only
Apply when The org has no fflib yet, or you prefer less maintenance overhead You want to control the fflib version
  • For a full guide, check the Getting Started page, or the migration steps in each layer's How article.
  • See the Releases page for updates, release notes and install links. Follow the Sandbox or Production link of the package you picked, or run:
    sf package install --package <04t id of the package version> --target-org <alias> --wait 20

Support

  • Raise questions, bugs and requests in this repository's Issues.
  • Contributions are highly appreciated; see CONTRIBUTING.md for guidelines.
  • Check our How articles for detailed examples for core and edge cases, and an overview of how the layers are set up to interact.
  • Unsure whether you've applied (D')fflib effectively, or want your team trained? See our Support page.

Licence

D'fflib is released under the BSD 3-Clause Licence. It was originally initiated by Deloitte; usage is free and has no dependency on Deloitte.

About

D'fflib is an extension to FFLib. It's backward compatible, provided as unlocked package, and improves developer-experience by accelerators, shortcuts, standardisations and adopting latest Salesforce features. All to truly enable developers (and AI agents) to deliver scalable, maintainable and testable Apex.

Topics

Resources

Contributing

Stars

8 stars

Watchers

1 watching

Forks

Releases

Contributors

Languages