feat: integrate azd extensions into awesome-azd gallery

[jongio]

Summary

Integrates azd extensions into the awesome-azd gallery as a first-class content type alongside templates. Closes #748.

Screenshots

Templates Gallery (default view with toggle)

Extensions Gallery

Contextual Sidebar Filters (Extensions View)

Extensions Documentation

Updated Contribute Page

Extension Submission Flow

flowchart TD
    A[Developer builds azd extension] --> B[Creates registry.json<br/>via azd x publish]
    B --> C{Choose submission method}
    
    C -->|GitHub Issue| D[Opens 'Submit an azd Extension' issue]
    C -->|Manual Trigger| E[Runs workflow_dispatch<br/>from Actions tab]
    
    D --> F[Fills form:<br/>Registry URL, Source Repo,<br/>Author, Website]
    F --> G[Issue created with<br/>extension-submission label]
    G --> H[GitHub Actions workflow triggers]
    
    E --> H
    
    H --> I[Checkout repo + Setup Node.js]
    I --> J[Parse submission fields]
    J --> K[validate-extension.js<br/>fetches registry.json]
    
    K --> L{Validation passes?}
    
    L -->|No| M[❌ Comment on issue<br/>with error details]
    M --> N[Developer fixes and<br/>resubmits]
    N --> D
    
    L -->|Yes| O[Extract extension metadata:<br/>id, displayName, description,<br/>capabilities, version, platforms]
    O --> P[Update extensions.json<br/>add/update entries]
    P --> Q[peter-evans/create-pull-request<br/>creates PR automatically]
    Q --> R[✅ Comment on issue:<br/>PR created successfully]
    
    R --> S[Maintainer reviews PR]
    S --> T{Approved?}
    T -->|Yes| U[PR merged → Extension<br/>appears in gallery]
    T -->|No| V[Request changes]
    V --> S
    
    style A fill:#e1f5fe
    style U fill:#c8e6c9
    style M fill:#ffcdd2
    style H fill:#fff3e0
    style Q fill:#fff3e0

Loading

What's Changed

Gallery UI

• Templates | Extensions toggle to switch between content types
• Extension cards with capability badges (Commands, Lifecycle, MCP, etc.), version display, website/source links, and one-click install command copy
• Filtering by extension capabilities via left sidebar
• Search across extension name, description, author, namespace, id, and website
• Dynamic hero Γò¼├┤Γö£├ºΓö£Γòó title, description, and search placeholder adapt to content type
• Contextual CTA Γò¼├┤Γö£├ºΓö£Γòó "Built an extension? Submit it here Γò¼├┤Γö£├æΓö£├Ñ" when viewing extensions
• Pagination works across both content types

Data Layer

• website/static/extensions.json Γò¼├┤Γö£├ºΓö£Γòó Seed data for 5 extensions
• website/src/data/extensionTypes.ts Γò¼├┤Γö£├ºΓö£Γòó TypeScript types
• website/src/data/extensions.ts Γò¼├┤Γö£├ºΓö£Γòó Data loader with sorting
• website/src/data/tags.tsx Γò¼├┤Γö£├ºΓö£Γòó 6 new extension capability tags

Automated Submission Pipeline

• .github/ISSUE_TEMPLATE/extension-submission.yml Γò¼├┤Γö£├ºΓö£Γòó Issue form for submissions
• .github/workflows/extension-submission.yml Γò¼├┤Γö£├ºΓö£Γòó Validates registry.json, updates extensions.json, creates PR automatically
• website/scripts/validate-extension.js Γò¼├┤Γö£├ºΓö£Γòó Registry validation (structure, capabilities, semver, platforms)
• Supports both issue-triggered and workflow_dispatch triggers

Documentation

• website/docs/extensions.md Γò¼├┤Γö£├ºΓö£Γòó Extensions overview and submission guide
• website/docs/contribute.md Γò¼├┤Γö£├ºΓö£Γòó Added "Submit an azd Extension" section

Security

• Workflow uses process.env for all user-controlled inputs (prevents script injection)
• React hooks called unconditionally (Rules of Hooks compliance)
• Proper semver comparison (stable versions beat pre-release)
• Accessibility: aria-labels on interactive elements

Testing

• All 15 tests pass (12 existing + 3 new extension tests)
• Build succeeds
• Validation script tested against real registries (azd-app, azd-copilot)

Seed Extensions

Extension	Capabilities
jongio.azd.app	Commands, Lifecycle, Metadata
jongio.azd.copilot	Commands, Lifecycle, MCP, Metadata
jongio.azd.exec	Commands, Lifecycle
jongio.azd.rest	Commands, Lifecycle, MCP, Metadata
microsoft.azd.demo	Commands, Lifecycle, MCP, Service Target, Framework

[Copilot]

Pull request overview

This pull request integrates azd extensions into the awesome-azd gallery as a first-class content type alongside templates. The PR adds a comprehensive extension discovery and submission system that parallels the existing template infrastructure.

Changes:

• Adds a toggle UI to switch between Templates and Extensions views in the gallery with dynamic hero text, search placeholders, and contextual CTAs
• Implements extension data layer with JSON seed data for 5 extensions, TypeScript types, data loaders, and 6 new capability tags for filtering
• Creates an automated submission pipeline with GitHub issue template, validation workflow, and registry.json validator that automatically creates PRs for new extensions

Reviewed changes

Copilot reviewed 16 out of 22 changed files in this pull request and generated 8 comments.

Show a summary per file

File	Description
website/static/extensions.json	Seed data for 5 initial extensions (4 community, 1 Microsoft)
website/src/data/extensionTypes.ts	TypeScript type definitions for Extension, ExtensionCapability, and ExtensionPlatform
website/src/data/extensions.ts	Data loader with sorting logic mirroring the template pattern
website/src/data/tags.tsx	Added 6 extension capability tag types (ext-custom-commands, ext-lifecycle-events, etc.)
website/src/pages/ShowcaseCardPage.tsx	Content type toggle, extension filtering, pagination support for both content types
website/src/pages/ShowcaseExtensionCards.tsx	Container component for rendering extension card grid
website/src/components/gallery/ShowcaseExtensionCard/index.tsx	Extension card component with capability badges, version info, install command copy
website/src/components/gallery/ShowcaseExtensionCard/styles.module.css	Styling for extension cards with light/dark theme support
website/src/components/gallery/ShowcaseTemplateSearch/index.tsx	Dynamic title, description, and placeholder based on content type
website/src/components/gallery/ShowcaseLeftFilters/index.tsx	Added Extension Capabilities filter section
.github/workflows/extension-submission.yml	Automated workflow to validate registries and create PRs from issue submissions
.github/ISSUE_TEMPLATE/extension-submission.yml	GitHub issue form for extension submissions
website/scripts/validate-extension.js	Node.js script to validate registry.json structure, capabilities, semver, and platforms
website/docs/extensions.md	New documentation page about azd extensions with installation and submission guides
website/docs/contribute.md	Added "Submit an azd Extension" section with submission workflow
website/test/tags_match.test.ts	Added 3 test cases for extension validation (tags exist, unique IDs, required fields)

[wbreza]

This is solid but I do have some questions on the validations and whether we can build those directly into the x extension or somewhere else.

We also likely have a little more work to do before accepting 3rd party contributions.

• CELA review
• Security review
• Indepth code scanning

[hemarina]

Thank you very much for adding the extension to the gallery. This is awesome! I'm looking forward to seeing it go live.

[Copilot]

Pull request overview

Copilot reviewed 20 out of 21 changed files in this pull request and generated 10 comments.

[hemarina]

Could we also add author filter in extension's filter?

[jongio]

Added! The Authors filter now appears in the extensions sidebar too, populated with extension authors. It also supports filtering — selecting an author filters extension cards to only show that author's extensions. Pushed in 808db66.

[Copilot]

Pull request overview

Copilot reviewed 20 out of 23 changed files in this pull request and generated 3 comments.

[Copilot]

Pull request overview

Copilot reviewed 20 out of 23 changed files in this pull request and generated no new comments.

[hemarina]

LGTM