Skip to content

Update from code changes: custom app dependencies + kill-switch#971

Open
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/a500dcd2
Open

Update from code changes: custom app dependencies + kill-switch#971
mintlify[bot] wants to merge 3 commits into
mainfrom
mintlify/a500dcd2

Conversation

@mintlify

@mintlify mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

Summary

Documents the custom-dependencies feature for data apps end-to-end: local authoring, the instance kill-switch, the layered org/scope gates, upload-time security screens, and the CSP change that unblocks blob-URL workers.

Changes

  • guides/data-apps.mdx: new Declared dependencies section covering pnpm add, lockfile requirement, .npmrc ignore-scripts=true, @lightdash/query-sdk release-age exemption, upload validation rules, the CSP now allowing blob: in script-src / worker-src / child-src, and the three-layer upload gate (instance flag, per-org feature flag, admin-only manage:DataAppDependency scope). Iterating section calls out the package chip that appears in the version timeline for versions with custom deps. Replaced the "Fixed dependency set" constraint with a pointer to the new section.
  • guides/data-apps/self-hosting.mdx: new Custom dependencies subsection documenting LIGHTDASH_APP_CUSTOM_DEPENDENCIES_ENABLED, LIGHTDASH_APP_DEPENDENCY_REGISTRY_HOSTS, and LIGHTDASH_APP_DEPENDENCY_INSTALL_TIMEOUT_MS, and noting that the enable flag is a full kill-switch (also blocks builds/AI iterations/restores of previously-approved dep sets). New Upload-time dependency checks subsection for the OSV malware screen (LIGHTDASH_APP_DEPENDENCY_MALWARE_CHECK_ENABLED, default on, fails closed) and the optional minimum release-age guard (LIGHTDASH_APP_DEPENDENCY_MIN_RELEASE_AGE_DAYS). Permissions section calls out manage:DataAppDependency as an admin-only scope required to declare custom dependencies.
  • self-host/customize-deployment/environment-variables.mdx: the five custom-dependency env vars added to the Data apps runtime reference table.

Context

Source PRs:

Update history

@mintlify

mintlify Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor Author

Preview deployment for your docs. Learn more about Mintlify Previews.

Project Status Preview Updated (UTC)
lightdash 🟢 Ready View Preview Jul 10, 2026, 1:03 AM

@github-actions

github-actions Bot commented Jul 10, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@github-actions

github-actions Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor

🤖 Documentation Bot

All checks passed! No issues found.

@mintlify

mintlify Bot commented Jul 11, 2026

Copy link
Copy Markdown
Contributor Author

Update from code changes updated this PR.

Documented the org feature flag, admin-only scope, and OSV malware and release-age upload checks for data app dependencies.

Source PRs

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant