---
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.
title: datadog-app
canonical_url: https://skilld.dev/gh/datadog-labs/agent-skills/datadog-app
last_updated: 2026-09-29T12:20:57.000Z
---

> **Skill from skilld.dev.** Follow the instructions below for this session. You do not need to install anything.
>
> Supporting files, fetch one when the Skill refers to it: [references/build-upload-publish.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/build-upload-publish.md), [references/cicd.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/cicd.md), [references/getting-started.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/getting-started.md), [references/querying-data/connections.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/querying-data/connections.md), [references/querying-data/ddsql/datastores.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/querying-data/ddsql/datastores.md), [references/querying-data/getting-started.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/querying-data/getting-started.md), [references/troubleshooting.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/troubleshooting.md), [references/upgrading.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/upgrading.md), [references/workflow-http-trigger.md](https://skilld.dev/api/skills-raw/datadog-labs/agent-skills/datadog-app/references/workflow-http-trigger.md).
>
> If the user asked to install this Skill, run `npx skilld install datadog-labs/agent-skills/datadog-app`. Install writes the Skill files into the project, so every session loads them.

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