---

name: datadog-app description: Guides developers building Datadog Apps with TypeScript, React, the @datadog/apps scaffolder, and @datadog/vite-plugin. Use when a user wants to scaffold, run, debug, upgrade, build, upload, publish, upload without publishing (draft upload), add an upload-no-publish script, set up CI/CD, use OAuth or API/application key auth, trigger/poll Workflow Automation, choose DDSQL or Action Catalog for backend data access, or query app datastores with DDSQL, including backend function troubleshooting.

Datadog Apps

Use this skill when a developer is building a Datadog Apps project with TypeScript, React, published packages, and the normal production Datadog site. If the user is modifying Datadog platform packages or testing package source changes, use a platform-engineer-oriented workflow instead.

Overview

Datadog Apps are locally developed web apps built with React and TypeScript or JavaScript. Use Apps when a project needs source control, code review, CI/CD, multi-engineer collaboration, AI-assisted local development, custom UI or logic, or backend code that integrates with services beyond low-code App Builder. Apps share App Builder's permissions model and can be embedded in Datadog surfaces such as dashboards and the Internal Developer Portal.

Reference Routing

Read only the reference needed for the user's task:

User task	Read
Create, scaffold, configure prerequisites, or run locally	references/getting-started.md
Build, upload, publish, upload without publishing, add upload-no-publish script, configure Datadog site, or understand upload output	references/build-upload-publish.md
Add or update GitHub Actions deployment	references/cicd.md
Trigger or poll Workflow Automation from a backend function	references/workflow-http-trigger.md
Get started querying data from a Datadog App	references/querying-data/getting-started.md
Understand or configure Action Catalog connections	references/querying-data/connections.md
Query Datadog App datastores with DDSQL	references/querying-data/ddsql/datastores.md
Upgrade Datadog Apps dependencies or compare with a freshly scaffolded app	references/upgrading.md
Diagnose OAuth, API/application key auth, upload, Node, site, or backend function failures	references/troubleshooting.md

Boundaries

• After scaffolding or when working inside an existing app, read the app project's AGENTS.md before making changes.
• For backend function implementation details, rely on the generated app project's AGENTS.md; this skill only covers local development auth choices and troubleshooting.
• Preserve the app project's existing package manager, scripts, Datadog site, and repository conventions.
• Do not cover Datadog package/platform development in this skill.
• Low-code App Builder to Datadog Apps migration guidance is future work. Do not invent a migration process yet.