ADMX Viewer

ADMX Viewer is a Bun-based web app for browsing local ADMX and ADML files, searching across policies, editing values, and exporting enforceable policy payloads.

The app reads the admx/ folder on every start, discovers available ADMX templates and localized ADML files, then renders a dark-mode three-panel UI inspired by admscope:

• Categories split by Computer Configuration and User Configuration
• Policies filtered by category or global search
• Details and editors for the selected policy
• Export output for .reg, PowerShell, Intune XML, and JSON

Requirements

• Bun 1.3+
• An admx/ directory in the repository root containing .admx files and language subfolders with matching .adml files

Example:

admx/
  VSCode.admx
  en-us/
    VSCode.adml
  ru-ru/
    VSCode.adml

Quick Start

bun install
bun run dev

Open http://localhost:3001.

Scripts

• bun run dev starts the Bun server with frontend HMR and reloads ADMX data on restart
• bun run test runs the Bun test suite
• bun run build creates a production bundle in dist/
• bun run start runs the app directly from source in production mode
• bun run start:dist runs the bundled output from dist/

Notes

• The app expects to be started from the repository root so the runtime can resolve the local admx/ folder.
• Search runs across all policies in the selected template and supports structured filters such as name:, desc:, class:, cat:, and quoted phrases.
• Bookmarks are intentionally not implemented.

Project Layout

server/   Bun server and ADMX/ADML ingestion
shared/   Shared policy types and export helpers
src/      React UI and shadcn components
build.ts  Bun production build entry

More implementation detail lives in DEVELOPMENT.md. User documentation lives in docs/.