This repository provides a guideline for Salesforce architects how to organise Salesforce metadata. Some components work very well with unlocked packages, others don't. Here, I gather insights about how these components behave in reality, beyond the limited information from the Metadata Coverage Report.

This repository is constantly updated, as the Metadata API and SFDX evolve. However, most recommendations are based on non-technical constraints and are not very likely to change anytime soon.

You can find all recommendations in the metadata-types folder. Each type has a brief readme with more details.

2GP - Second-generation packaging. Deployed with package install.

happy-soup - Your primary unpackaged metadata in a single repository. Deployed with source deploy or mdapi deploy.

isolated - An isolated repository for unpackaged metadata that is not deployed with the rest of happy-soup. Often requires additional deployment steps.