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