datadog-app

---
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.

From datadog-labs/agent-skills at 9cbd518, shown as plain text under its license: MIT (permissive). The license text is in LICENSE.

• SKILL.md3.0 KB · 4e993341b64f
• references/
• build-upload-publish.md2.9 KB · f915421b1091
• cicd.md1.3 KB · a0fe6f49f271
• getting-started.md4.7 KB · cede0efbf40b
• querying-data/
• connections.md2.9 KB · 3a2f183d7b92
• ddsql/
• datastores.md3.3 KB · ad44e108caf5
• getting-started.md6.6 KB · 209acc295584
• troubleshooting.md5.3 KB · 6bbcf5677c3a
• upgrading.md2.8 KB · 64c3bbf48fec
• workflow-http-trigger.md7.7 KB · 5807728a663d

10 files, 40 KB in total. Each file has a sha256 in the pin's manifest; the first 12 characters are shown.