> **datadog-app** — skill 23 of 48 in [datadog-labs/agent-skills](https://skillsdocs.com/datadog-labs/agent-skills).
>
> Book (all skills, one file): https://skillsdocs.com/datadog-labs/agent-skills.md
> Machine manifest: https://skillsdocs.com/datadog-labs/agent-skills/.well-known/agent-skills/index.json
> Install the book: `npx skills add datadog-labs/agent-skills`
> Upstream: https://github.com/datadog-labs/agent-skills/blob/main/dd-apps/datadog-app/SKILL.md @ `main`
> Raw bytes, no header: https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/SKILL.md
> Base for relative paths: https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/
> Licence: MIT — https://spdx.org/licenses/MIT.html
>
> Bundled files (9), referenced from this skill's directory:
>   - `references/build-upload-publish.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/build-upload-publish.md
>   - `references/cicd.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/cicd.md
>   - `references/getting-started.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/getting-started.md
>   - `references/querying-data/connections.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/querying-data/connections.md
>   - `references/querying-data/ddsql/datastores.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/querying-data/ddsql/datastores.md
>   - `references/querying-data/getting-started.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/querying-data/getting-started.md
>   - `references/troubleshooting.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/troubleshooting.md
>   - `references/upgrading.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/upgrading.md
>   - `references/workflow-http-trigger.md` — https://raw.githubusercontent.com/datadog-labs/agent-skills/main/dd-apps/datadog-app/references/workflow-http-trigger.md
>
> Content © its authors, served unmodified. Takedown: https://github.com/DreambaseAI/skillsdocs/issues/new?labels=takedown&title=Takedown+request

<!-- Verbatim upstream SKILL.md follows, YAML frontmatter included. -->

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