Contributing

Share your component

Add a complete, documented sample so others can understand the scenario, inspect the code, and run it in their own tenant.

Read the contribution guide
  1. 1

    Fork and branch

    Work from the latest main branch and keep the pull request focused.

  2. 2

    Add the sample

    Include source, a complete README ending with its sample-specific view tracker, metadata, and at least one referenced gallery image.

  3. 3

    Validate and submit

    Run the gallery validation, then open a pull request with the scenario and test details.

Required structure

One self-contained sample folder

samples/
└── your-sample-name/
    ├── assets/
    │   └── sample.json
    ├── src/
    └── README.md

End the README with https://m365-visitor-stats.azurewebsites.net/spfx-copilot-components/samples/your-sample-name. Pull request validation requires the URL slug to match the sample folder.

Gallery metadata

Reference the image you want featured

The gallery uses the first image in thumbnails by ascending order. The file can have any name; its URL, alt text, and local file must be valid.