Inspect Angular component trees, signals, dependency injection, and routes — at dev time, build time, or through a coding agent. Built with Devframe so the same tool runs as an embedded panel, standalone CLI, static report, MCP server, or Chrome DevTools extension.
- Component inspector — discover components, inputs, outputs, and source files; view injected providers per component
- Signal graph — visualize signal, computed, linkedSignal, effect nodes and their dependency edges (Angular 19+)
- DI inspector — browse the injector hierarchy (element and environment) with providers at each level (Angular 17+)
- Route inspector — the live route, every navigation as a full story (who started it, redirects, per-phase timing, which guard or resolver decided it, errors explained), the live route config with URL testing, router setup, route lint, and actions to navigate, replay, probe and abort
- NgRx Store inspector: live
@ngrx/signalsstores (state, computed, methods, the component fields that use them) with a change log, per-change diffs and state restore (callregisterNgrxSignals({ patchState })from@santoshyadavdev/ng-devtools/overlayonce, so restore also notifieswatchStatelisteners), plus the@ngrx/storestate and action log (time travel withprovideStoreDevtools()); source scan ofsignalStoremembers,signalState,signalMethod, actions, reducers, effects, selectors and features - Forms inspector — every form on the page (Signal Forms, reactive and template-driven) with each field's value, status, touched/dirty state and readable errors, plus a timeline of recent changes; hover a field to highlight its input
- SSR & HTTP inspector — the TransferState payload, a timeline of HTTP calls made during SSR and on the client, hydration stats and warnings, and fault injection (status, delay, mock JSON body) per URL pattern on the client, in SSR or both
- Build metadata — Angular version, TypeScript version, SSR status
- In-page popup — floating devtools panel with dock modes (float, bottom, right), drag, resize, and localStorage persistence
- Agent-native — all inspectors exposed as MCP tools and resources
- Deep linking — URL hash navigates to a specific tab (
#tab=signals) - Page overlay — highlights components in the running app
npm install @santoshyadavdev/ng-devtools devframeMCP agent support (@devframes/agentic) is included.
Mount the devtools hub in your Express server:
// server.ts
import { initNgDevtoolsHub } from '@santoshyadavdev/ng-devtools/hub';
const devtools = initNgDevtoolsHub({ ws: false });
app.use(devtools.nodeMiddleware);Load the overlay in development (see Browser Overlay) and a floating button appears on your page. It opens the devtools with one dock entry per tool:
| Dock entry | Shows |
|---|---|
| Angular | Dashboard, components, routes, signals, injectors and forms |
| NgRx | Store patterns from source, and live state and actions |
| Analog | File routes, server calls, render modes and lint (a notice in non-Analog apps) |
| NativeScript | Coming soon |
| Capacitor | Coming soon |
The full-page viewer is at http://localhost:4000/__devframes/. The hub is built on @devframes/hub, so other devframe tools can join the same dock.
To mount only the devtools panel without the dock, use initDevframe(ngDevtools, { base: '/__ng-devtools/' }) from devframe/initiate, as before.
To fill the SSR & HTTP tab, add the interceptor and hydration hooks to your app config:
// app.config.ts
import { provideHttpClient, withFetch } from '@angular/common/http';
import { provideNgDevtoolsHttp, withNgDevtools } from '@santoshyadavdev/ng-devtools/http';
export const appConfig: ApplicationConfig = {
providers: [
provideClientHydration(),
provideHttpClient(withFetch(), withNgDevtools()),
provideNgDevtoolsHttp(),
],
};# Dev server with live RPC
npx @santoshyadavdev/ng-devtools dev
# Static report (offline HTML)
npx @santoshyadavdev/ng-devtools build --outDir dist-report
# MCP server for coding agents
npx @santoshyadavdev/ng-devtools mcpClaude Desktop — add to claude_desktop_config.json:
{
"mcpServers": {
"ng-devtools": {
"command": "npx",
"args": ["@santoshyadavdev/ng-devtools", "mcp"]
}
}
}VS Code — add to .vscode/mcp.json:
{
"servers": {
"ng-devtools": {
"command": "npx",
"args": ["@santoshyadavdev/ng-devtools", "mcp"]
}
}
}When embedded in Express, the MCP endpoint is also available over HTTP at /__devframes/__mcp (or /__ng-devtools/__mcp without the hub).
MCP clients see these with an underscore, as ng-devtools_get-routes.
| Tool | Description |
|---|---|
ng-devtools:get-routes |
List Angular routes from source |
ng-devtools:get-components |
Discover components and directives, with inputs and outputs |
ng-devtools:get-signals |
Signal declarations from source |
ng-devtools:get-providers |
DI providers from source |
ng-devtools:build-meta |
Angular/TS versions, SSR status |
ng-devtools:highlight |
Highlight a component in the page |
ng-devtools:inspect-signals |
Signal graph a connected page reported |
ng-devtools:inspect-providers |
Injector tree a connected page reported |
ng-devtools:get-ngrx-store |
Scan source for NgRx store patterns |
ng-devtools:inspect-forms |
Forms on the page with every field's state and errors |
ng-devtools:explain-form-invalid |
Which fields make a form invalid, and why |
ng-devtools:explain-field |
One field: error sources, skip reasons, binding, source |
ng-devtools:explain-submit |
What submit will do, and why it might do nothing |
ng-devtools:form-payload |
What the form sends: value vs raw value, unvalidated fields |
ng-devtools:form-history |
Change timeline with origin (user, code, devtools) |
ng-devtools:form-diff |
Net change since a marker |
ng-devtools:lint-forms |
Form bugs and model-aware accessibility checks |
ng-devtools:explain-custom-control |
How a field is bound, and what is wrong with the binding |
ng-devtools:export-form |
JSON snapshot or test fixture |
ng-devtools:wait-for-form |
Wait until settled, valid, not pending or submitted |
ng-devtools:form-action |
Set, touch, revalidate, reset, submit, focus, snapshot |
ng-devtools:fill-form |
Fill several fields through the inputs |
ng-devtools:inspect-route |
The current route with params, data, guards and resolvers |
ng-devtools:explain-navigation |
Recent navigations and why each succeeded or not |
ng-devtools:list-routes |
Live route config; match a URL; audit guard protection |
ng-devtools:lint-routes |
Route config mistakes, with fixes |
ng-devtools:router-config |
Router options, features and strategies in effect |
ng-devtools:export-navigation |
Markdown repro of a navigation |
ng-devtools:explain-render-mode |
ServerRoute and render mode for a URL |
ng-devtools:navigate |
Navigate, abort, replay, probe, instrument (dev only) |
ng-devtools:analog-routes |
Analog file routes with their page, layout and server files |
ng-devtools:analog-explain-url |
Which Analog files render a URL, or why nothing matches |
ng-devtools:analog-current-page |
The open page's files, load() data and hydration state |
ng-devtools:analog-server-calls |
Page renders, load(), server function and API calls |
ng-devtools:analog-api-routes |
Server routes with method, URL and file |
ng-devtools:analog-call-api |
Send a request to a server route (non-GET needs confirm) |
ng-devtools:analog-render-modes |
SSR, prerendered or client only, per page |
ng-devtools:analog-prerender-plan |
prerender.routes compared with pages and build output |
ng-devtools:analog-content |
Markdown content with slug and frontmatter |
ng-devtools:analog-lint |
Analog routing, server, prerender and content mistakes |
The Forms tab and the forms tools read Signal Forms, reactive forms and template-driven forms from the running page, in development builds only. Signal Forms need Angular 21 or later. The live change timeline for reactive and template-driven forms uses control.events (Angular 18+); on Angular 17 changes are picked up every few seconds instead, without submit and reset events.
- Each field shows its value, status, touched/dirty state and errors, plus: Signal Forms constraints (
min,max,minLength,maxLength,pattern), a pendingdebounce,submitting, and disabled reasons; for reactive and template-driven forms, whether validators and async validators are attached, the valuereset()goes back to,updateOn, and the boundControlValueAccessor. ng-devtools:explain-form-invalidis the tool to reach for first: without arguments it lists every form that is invalid or waiting on async validation, with each failing field's current value, the validator that failed, its message and whether it was touched. Passform(an id likeform-1, or part of a label likeSignupComponent) to explain one form.ng-devtools:inspect-formslists the forms with their status and error counts. Passformfor a field tree, pluspath(e.g.address.city),onlyInvalidorincludeValues: falseto narrow it down.- Both tools note when the page last reported, so an agent can tell when the data is stale.
- Each error says where it comes from: a validator, a template attribute, a cross-field rule (and on which ancestor), async, parse, a server/submission error, or
setErrors().explain-fieldadds why validation is skipped (hidden, disabled, readonly), typed-but-uncommitted values (updateOn,debounce), stale validity after validator changes, the binding, whether the error text is visible, and the file and line of the form and its rules. - Agents can loop: inspect, act (
form-action,fill-form),wait-for-form, thenform-difffrom the marker they had. Writes need a development build;reset,submitandrestoreneedconfirm: true. - The Forms tab has Fields (with filters and per-field actions), Timeline, Submit and Lint views. Pick a field on the page to select it, or open a form from its component in the Components tab.
- Timeline recording (a checkbox in the Timeline view, or
form-actionwithinstrument) adds the calling code of each change, validator changes, async validation times and component renders per keystroke. Array items are tracked by identity, so moves show as moves.
Form values leave the page: they are sent to the devtools server, shown in the Forms tab and returned to agents. Values of password fields, fields with a password, one-time-code or credit-card autocomplete, fields inside .sentry-mask, .rr-mask, [data-private] or [data-ng-devtools="mask"], and fields whose name contains a secret word (password, token, card, cvv, apiKey and similar) are replaced with [redacted], and those values are also removed from error messages. [data-ng-devtools="unmask"] opts a field back in; window.__NG_DEVTOOLS_FORMS__ = { mask: ['iban'], unmask: ['passport'] } does the same by key. DevTools never writes secret fields. Other values are sent as they are, so keep real credentials out of forms you inspect, and don't expose the dev server beyond localhost.
The Routes tab and the router tools read the running app's Router, in development builds only. The Router is found through the debug helper provideRouter() publishes, or through the injector for RouterModule.forRoot() apps. Without debug utils (a production build) only navigation events are available, and the Setup view says so.
The Routes tab has five views:
- Current: the URL (and the browser URL when they differ), the navigation in flight with an Abort button, each active route with its component, params and data and where each value comes from (own, inherited, static or resolved), the route title and whether it is inherited, and the outlet tree with the inputs the router binds.
- Navigations: every navigation as one story: where it came from, who started it (a RouterLink, the code that called
navigate, back/forward), extras, redirect chains and loops, a phase bar (recognize, guards, resolve, activate), guards and resolvers, lazy loads, reused components, HTTP requests, scroll, the title afterwards, router warnings, and the cancel or error reason. Turn on "Record each guard and resolver" to see each one's verdict and time (for exampleauthGuard returned UrlTree /login). Replay a navigation, copy a markdown repro, or export the list as JSON. - Routes: the live route config with lazy children merged in once they load and the active branch marked. Test a URL to predict which route matches it (or the nearest ones), probe it with the real matcher, navigate to any route (with its params), or read the routes of a lazy route that has not loaded.
- Setup: provideRouter or forRoot, effective options with set/default markers, enabled features, strategies, base href and hydration.
- Lint: route config mistakes (unreachable routes after
**, a:paramshadowing a literal, duplicate paths, empty-path redirects withoutpathMatch: 'full', redirect cycles, deprecated class guards andcanLoad, lazy chunks downloaded before a rejectingcanActivate, missing or duplicate titles, param/input typos,routerLinkActivewithoutariaCurrentWhenActive, emails in URLs, return URLs taken from query params), each with a fix and whether Angular throws or stays silent.
Components rendered by the router show the route and outlet in the Components tab.
For agents:
ng-devtools:explain-navigationanswers "why did this navigation not work" or "why was I redirected": passurloridto narrow it,limitfor more than the last 5, orperffor the slowest navigations and preloads. NG04xxx and related errors are explained.ng-devtools:inspect-routedescribes the route the page is on right now; passselector(a component class, tag or link text) to see which route a component was rendered for or whether a link counts as active.ng-devtools:list-routeslists the live config with source files and example URLs;matchpredicts which route a URL hits,auditlists the guards that protect each page.ng-devtools:lint-routes,ng-devtools:router-configandng-devtools:export-navigationgive the lint findings, the setup and a repro.ng-devtools:explain-render-modereads the workspace's*.routes.server.tsand says which render mode a URL gets.ng-devtools:navigateacts on the router:navigate(a relative URL, or a pattern with params),abort,replay,probe(runs the real matcher without navigating; it runscanMatchand may load lazy chunks),instrumentandresolve-lazy. It only accepts same-origin relative URLs.
Without instrumentation, the guards listed for a navigation are candidates (the canDeactivate guards of the page being left and the canActivate/canActivateChild guards of the target), because the router reports one result for all of them. Instrumentation wraps each guard and resolver in the live config to record its verdict; it is off by default and undone when turned off. A navigation that finished before the devtools connected is listed without timing or guard details.
Query, matrix and fragment keys that look secret (token, password, api key, code, sig, session, jwt and similar), including inside encoded return URLs, JWTs, bearer tokens, long opaque tokens and route params with such names are replaced with [redacted] in URLs, params, data and messages. A secret route param is only known once the route is recognized or found in the config, so a navigation that fails before that (for example inside a lazy route that failed to load) can still show it in its URL.
For Analog apps, add the Vite plugin next to analog() and load the overlay in main.ts:
// vite.config.ts
import analog from '@analogjs/platform';
import ngDevtools from '@santoshyadavdev/ng-devtools/vite';
import { defineConfig } from 'vite';
export default defineConfig({
plugins: [analog(), ngDevtools()],
});// src/main.ts
bootstrapApplication(App, appConfig).then(() => {
if (import.meta.env.DEV) void import('@santoshyadavdev/ng-devtools/overlay');
});The floating button appears on the page, the full viewer is at /__devframes/ on the Vite dev server, and the MCP endpoint at /__devframes/__mcp.
The devtools only answer this machine, and only pages served from localhost, 127.0.0.1 or the Chrome extension, so another website open in your browser can't reach them. If you open the dev server through another hostname that points to your machine (for example myapp.test), list it in Vite's server.allowedHosts and the devtools trust it too. Other origins can be added with ngDevtools({ allowedOrigins: ['https://tunnel.example'] }).
The Analog dock shows:
- Routes: every page, layout and markdown file with its URL, route groups,
[param]and catch-all segments,.server.tsfiles and routeMeta. Test a URL to see which files render it. - Server: page renders (server rendered or client only),
load()fetches, server functions and API calls with status, time and a redacted preview, plus a request playground for API routes and a button to clear the list. Aload()that runs while a page is server rendered and again in the browser right after it loads is flagged. - Render: SSR, prerendered or client only per page, from config, build output and the last request.
- Content and Lint: markdown files, and checks for duplicate URLs, missing default exports, layouts without
<router-outlet>, orphan.server.tsfiles, API method suffixes, prerender entries and frontmatter.
The Analog dock is always in the rail, but it shows Analog data only in Analog apps; in other apps it shows a "This app doesn’t use Analog" page. In Analog apps it is also a tab when the panel is mounted without the hub, and the Routes tab and Dashboard switch to Analog's file routes and SSR setting. Tested with Analog 2.7 on Angular 20 (a fresh app from the official template, npm and pnpm) and Angular 22. The demo lives in examples/analog (pnpm analog:dev).
The SSR & HTTP tab needs withNgDevtools() and provideNgDevtoolsHttp() (see Embedded in an Angular app), and SSR and the devtools middleware must run in the same Express process. It works in development builds only; in production the interceptor passes requests through untouched.
Register withNgDevtools() before your own interceptors (provideHttpClient(withNgDevtools(), withInterceptors([auth]))), so it records requests as the app makes them and fault rules apply before anything else. Transfer cache hits are detected when the cached response comes back right away, or when the page's TransferState holds a GET or HEAD entry for the same URL, so an async interceptor after it does not hide them.
- HTTP timeline: every
HttpClientrequest, tagged SSR or Client, with method, URL, the page that made it, status, time, whether the transfer cache answered it, and whether a fault rule changed it. Click a row for a response preview. Pick the page at the top; the timeline shows its client calls and the SSR calls made while rendering its first URL. The picker stays on the page you picked until that tab closes. Calls are kept until you press Clear timeline. - Fault injection: add a rule with a URL pattern (a substring, or a glob where
*matches anything, so/api/*matches both relative and absolute URLs), an optional method, where it applies (SSR + client, SSR only, client only), and a status, a delay (up to 10 s) and an optional JSON body. A status of 400 or more fails the request with anHttpErrorResponse; a lower status returns the body as a mocked response (aresponseType: 'text'request gets the body as text). A rule with only a delay passes the request through. Client rules apply right away; SSR rules apply from the next page load. SSR mocks are not written to TransferState, so the browser requests the URL again; apply the rule on SSR + client to mock both. - Hydration: whether hydration is on (the server sent hydration annotations), hydrated components and nodes, skipped components, incremental defer blocks, mismatched components with the expected and actual DOM, and the hydration warnings (NG05xx) Angular logged. Warnings are captured only with
provideNgDevtoolsHttp(). - TransferState payload: each entry in the page's
{APP_ID}-statescript with its size, with HttpClient and Analog cache entries decoded to status, URL and body, and__nghData__/__nghDeferData__labelled as hydration annotations.
Routes that are prerendered at build time make no requests at runtime and ignore SSR rules. Use RenderMode.Server in app.routes.server.ts for pages you want to test this way.
Response previews and TransferState values are not redacted: they are sent to the devtools server as they are, so don't expose the dev server beyond localhost.
| Resource | Content |
|---|---|
ng-devtools:component-tree |
Live component hierarchy |
ng-devtools:signal-graph |
Signal dependency graph |
ng-devtools:injector-tree |
DI injector hierarchy |
ng-devtools:ngrx-store |
Live NgRx stores & change log |
ng-devtools:forms |
Live forms and recent changes |
ng-devtools:router |
Live route and navigations |
Mount as a dock panel inside Vite DevTools:
// vite.config.ts
import { viteDevframeHub } from '@devframes/vite/hub';
import { createUi } from '@devframes/hub-ui';
import ngDevtools from '@santoshyadavdev/ng-devtools/devframe';
export default defineConfig({
plugins: [
viteDevframeHub({
devframes: [ngDevtools],
ui: createUi({ branding: { productName: 'Angular DevTools' } }),
}),
],
});See the Chrome Extension section below for how to package this as a Chrome extension.
The overlay runs inside the user's Angular page and collects live component, signal, DI, and NgRx data. Importing the module starts it, so in most apps that import is all that is needed:
import '@santoshyadavdev/ng-devtools/overlay';It looks for the devframe connection next to the page, then at
/__ng-devtools/ and /__devframes/ng-devtools/. It also adds the floating
button below; with the hub mounted, the button opens the whole hub (every dock
in a side rail).
initOverlay is exported for a devtools mounted somewhere else. Importing the
module has already started an overlay on the default URLs by then, so dispose of
that one before starting another, or the page ends up with two connections and
two polling intervals:
import { initOverlay } from '@santoshyadavdev/ng-devtools/overlay';
const dispose = await initOverlay({ baseURL: '/__my-devtools/' });The devtools can appear as a floating popup directly on your page — no browser extension needed:
import { createDevtoolsPopup } from '@santoshyadavdev/ng-devtools/popup';
createDevtoolsPopup();This adds a floating button (bottom-right) that opens the full devtools UI in an iframe. Supports three dock modes (float, bottom, right), dragging, resizing, and persists position via localStorage. The popup is automatically loaded in development when using the demo app.
The repository includes a demo app, Angular Travel (src/), that looks and behaves like a real booking site so every inspector has something to show:
- Destinations: search, region filter and sort kept in the URL, backed by an
@ngrx/signalsstore (withState,withComputed,withMethods) - Trip pages: loaded by a resolver that redirects unknown trips, with a route title resolver
- Booking: a Signal Forms checkout with a departure date rule, a seat limit and an unsaved-changes guard
- My Trips: behind a sign-in guard that redirects to a reactive form and back
- DevTools Lab (
/examples): small, focused pages for signals, components, DI, routes and all three form APIs - SSR & HTTP (
/examples/http): a product list fetched from/api/productsduring SSR and replayed from the transfer cache. The endpoint accepts?delay=and?fail=for backend scenarios; run the SSR server (pnpm build --configuration development && node dist/angular-devtools/server/server.mjs) to see server calls
Run pnpm start and click the amber button in the corner to open the devtools. Destination photos are from Unsplash, credited in public/destinations/CREDITS.md.
# Install dependencies
pnpm install
# Dev server for the devtools UI (with live RPC)
pnpm devtools:dev
# Build the devtools UI SPA
pnpm devtools:build
# Build the publishable package (library + UI in dist/)
pnpm devtools:build-pkg
# Run the Angular host app (builds the package first, includes in-page devtools popup)
pnpm startThe devtool ships as one npm package, @santoshyadavdev/ng-devtools: Node-side logic, RPC, CLI, overlay, popup, and the built UI in dist/public.
# Builds on prepack, then publishes
pnpm devtools:publishTo distribute this as a Chrome DevTools extension, you need a thin Chrome extension shell that opens the devtools UI in a DevTools panel. The built SPA already works standalone — the extension just embeds it.
Create an extension/ directory:
extension/
manifest.json
devtools.html
devtools.js
panel.html
{
"manifest_version": 3,
"name": "Angular DevTools",
"version": "0.0.1",
"description": "Inspect Angular components, signals, DI, and routes.",
"devtools_page": "devtools.html",
"permissions": ["scripting"],
"host_permissions": [
"http://localhost/*",
"https://localhost/*",
"http://127.0.0.1/*",
"https://127.0.0.1/*"
],
"icons": {
"128": "icon-128.png"
}
}<!-- devtools.html -->
<!doctype html>
<script src="devtools.js"></script>// devtools.js — creates the panel in Chrome DevTools
chrome.devtools.panels.create('Angular', 'icon-128.png', 'panel.html');This is where the built SPA loads. Copy the built assets (dist/devtools-ui/) into the extension and point panel.html at the SPA's index.html:
<!-- panel.html — the devtools SPA loads here -->
<!doctype html>
<html>
<head>
<meta charset="utf-8" />
</head>
<body>
<iframe src="ui/index.html" style="width:100%;height:100vh;border:none;"></iframe>
</body>
</html># Build the devtools SPA
pnpm devtools:build
# Copy into the extension
mkdir -p extension/ui
cp -r dist/devtools-ui/* extension/ui/- Go to
chrome://extensions - Enable Developer mode
- Click Load unpacked → select the
extension/directory - Open DevTools on any Angular app → the Angular panel appears
- Zip the
extension/directory - Go to the Chrome Developer Dashboard
- Click New item → upload the zip
- Fill in the listing details and submit for review
The extension panel loads the SPA in static mode by default. To connect it to a live dev server for real-time RPC, the extension's content script or background service worker needs to detect the devframe's __connection.json on the inspected page and pass the connection to the panel. This is the same pattern the official Angular DevTools Chrome extension uses — a content script bridges the inspected page and the DevTools panel via chrome.runtime.connect.
Join the conversation, ask questions, and share feedback on Discord.
If Angular DevTools helps your work, please consider sponsoring the project on GitHub. Your support keeps development going.
Thanks to our current sponsors:
MIT


