A free, open-source Azure DevOps extension that provides a centralized, organization-wide help & support hub for every project member.
Features
- Project-level help hub — All team members see the same help content in their project's left navigation
- Organization-level admin panel — Administrators edit content once in Organization Settings → Extensions → Get Support
- Markdown with live preview — Write content in Markdown with GFM support (tables, task lists, code blocks) and see a real-time preview
- ADO-native look & feel — Built with
azure-devops-ui, the extension blends seamlessly into the Azure DevOps interface - Dark theme support — Automatically adapts to the user's theme preference
- Zero dependencies — No external services or databases required; uses Azure DevOps Extension Data Service for storage
Quick Start
- Install the extension from the Azure DevOps Marketplace
- As an organization administrator, go to Organization Settings → Extensions → Get Support
- Write your help content in Markdown and click Save
- All project members will now see the content under the Get Support tab in every project
Development
Prerequisites
- Node.js 18+
- TypeScript 5.3+
- tfx-cli (
npm install -g tfx-cli)
Setup
# Clone the repository
git clone https://github.com/yushiqi-cc/ado-ext-get-support.git
cd ado-ext-get-support
# Install dependencies
npm install
# Build the extension
npm run build
# Package for development
npm run package:dev
# Package for production
npm run package
Project Structure
src/
├── views/
│ ├── supportView.tsx # Project-level read-only view
│ ├── supportView.scss
│ ├── supportAdmin.tsx # Organization-level admin panel
│ └── supportAdmin.scss
├── components/
│ └── MarkdownPreview.tsx # Markdown rendering component
├── services/
│ └── dataService.ts # Extension data storage service
├── utils/
│ └── constants.ts # Storage keys and default content
└── styles/
└── markdown.scss # Shared Markdown rendering styles
Scripts
| Script | Description |
|---|---|
npm run build |
Production build |
npm run build:dev |
Development build |
npm run package |
Package the extension for production |
npm run package:dev |
Package the extension for development |
npm run publish |
Publish the extension to the Marketplace |
npm run clean |
Remove build artifacts |
Tech Stack
- React 18 with TypeScript
- azure-devops-ui — Azure DevOps native UI components
- azure-devops-extension-sdk — Extension SDK
- react-markdown + remark-gfm — Markdown rendering
- Webpack 5 — Module bundling
License
This project is licensed under the MIT License. See LICENSE for details.
Contributing
Contributions, issues, and feature requests are welcome! See CONTRIBUTING.md for guidelines.
Code of Conduct
Please read and follow our Code of Conduct.