// 2gp package BETA

Salesforce Data Dictionary

A repository-based data dictionary with seven purpose-built LWC viewers

A Lightning-native app that turns your Salesforce repository into living, searchable documentation inside Salesforce. It reads the metadata in your Git repo and builds a browsable picture of your entire configuration: objects, fields and relationships; automation including flows, triggers and Apex classes; and security layers including profiles, permission sets, record types, list views and more. ERDs, dependency maps and docs on demand. No spreadsheets, no external tools, no context switching.

2GP native packaged app Git reads your repo metadata ERD diagrams on demand 07 lightning viewers v1.0 package version
what_it_is [01]

Documentation that lives where you work

Most Salesforce teams document their org in spreadsheets and wiki pages. Those go stale the moment they are written, and nobody owns keeping them current.

Data Dictionary takes a different source of truth: the metadata already committed to your Git repository. It connects to the repo, reads the force-app source, and caches a structured picture of all org configuration into Salesforce. Not just objects, fields, relationships and dependencies, but flows, triggers, Apex classes, profiles, permission sets, record types, list views, custom labels, queues, connected apps and installed packages.

Everything is then surfaced through native Lightning components on a dedicated Data Dictionary app: searchable explorers, ERDs, dependency maps and generated documentation. Rebuild the cache and the picture matches the repo again.

Repo as source of truth

Reads metadata straight from your Git repository, so the documentation reflects what is actually under version control, not someone's recollection of it.

Native Lightning

Delivered as a 2GP managed package. LWC viewers run inside Salesforce. No browser extensions, no external apps, no separate login.

Rebuild, don't rewrite

Refreshing the picture is a cache rebuild, not a documentation project. The more complex the org, the more that automation is worth.

architecture [02]

How It Works

The GitHub repository is the source. Named and External Credentials handle authentication. Apex fetches and parses the metadata, with large runs chunked through a Platform Event so they never hit governor limits. The parsed result is cached in custom objects and rendered by Lightning Web Components.

GitHub Repository force-app metadata External + Named Credential authenticates to GitHub APEXrepository / sync / metadata layers ──▶ fetch & parse source ASYNC PIPELINE Async jobs Repository_Cache_ Continuation__e chunk large runs DATA CACHE Repository_ Metadata_Cache__c objects, fields, flows, security & more RUN HISTORY Repository_ Metadata_Run__c run history & status CONFIG Custom Metadata Types what to read & how to display it LWC VIEWERSrender the cache on the Data Dictionary app Metadata Explorer Dependency ERD Docs Repository
Source & Sync
GitHub + Apex

External and Named Credentials authenticate to GitHub. The repository and sync Apex layers pull the metadata source and parse it. A Platform Event continuation pattern breaks large repos into chunks so a full build stays within limits.

Data Layer
Cached in Custom Objects

Parsed metadata is stored in Repository_Metadata_Cache__c, with each build tracked in Repository_Metadata_Run__c. Custom Metadata Types control which metadata is read and how columns are displayed.

Presentation Layer
Lightning Web Components

Seven viewers render the cache: Metadata Explorer, Dependency Viewer, ERD Viewer, Documentation Viewer, Repository Explorer, Integration Setup wizard, and Application Configuration. Integration Setup provides guided GitHub credential configuration; Application Configuration manages presentation settings. They live on the Data Dictionary app and can be dropped onto any Lightning page in App Builder.

capabilities [03]

The Viewers

Metadata Explorer
Browse the Entire Configuration

A searchable view of the full metadata surface straight from the repo. Not only objects and fields, but Apex classes and triggers, flows, profiles and permission sets, record types, list views, custom labels, queues, connected apps and installed packages. Filter by type, then read each item's API name, label and key attributes without opening Setup or VS Code.

ERD Viewer
Relationship Diagrams On Demand

Entity-relationship diagrams generated from the cached metadata, showing lookup and master-detail links across standard and custom objects. Rendered with Cytoscape.js with selectable layouts (hierarchical, breadth-first, circle, grid) and a resizable inspector panel. Useful for design reviews without hand-drawing diagrams that are out of date by the next sprint.

Dependency Viewer
See What Touches What

Trace relationships and references between components with a minimap, zoom/drag, right-click context menu, and collapsible inspector panel. The kind of exploration interface usually found in dedicated diagramming tools, built natively in Lightning Web Components.

Documentation Viewer
Generated, Readable Docs

Read generated, structured documentation with a Markdown renderer, syntax highlighting, and a synced outline. Readable technical reference for the whole team, regenerated from the repo rather than maintained by hand.

Repository Explorer
Browse the Source Tree

Navigate the connected repository's metadata directly inside Salesforce, with each build's run history and status visible so you know exactly what the cache reflects.

App Configuration & Integration Setup
Point It At Your Repo

Guided setup screens connect the GitHub integration and tune what gets read and displayed, driven by Custom Metadata Types rather than hardcoded values. Errors are captured in Error_Log__c for troubleshooting.

audience [04]

Useful to Everyone on the Team

The same cached picture serves different people in different ways, from the first scoping conversation through to support years later.

DEV
Developers

Look up an API name, check what depends on a field, and understand existing patterns before writing code, without leaving Salesforce.

ARCH
Solution Architects

Generate ERDs for design reviews, validate relationships, and spot reuse opportunities before adding new objects.

BA
Business Analysts

See what already exists when mapping requirements, and avoid asking for fields the org already has.

QA
QA & Testers

Use the relationship and field reference to design test scenarios that cover the objects a change actually touches.

ADM
Administrators

A current inventory of configuration to refer to, instead of clicking through Setup to remember how something was built.

SUP
Support Teams

Look up field context and relationships when triaging an issue, with fewer escalations to the dev team for "what does this field do?".

MGR
Project Managers

A clearer read on complexity for estimates, and faster onboarding for anyone joining the project.

SLT
Stakeholders & Clients

Visual ERDs make the design legible to non-developers, and the knowledge stays in the platform when people move on.

technology_stack [05]
Apex Lightning Web Components SOQL 2GP Managed Package External Credentials Named Credentials Platform Events Custom Metadata Types Custom Objects GitHub REST API Salesforce CLI Jest