Skip to content

Publish the branded Power Platform sample gallery and automated validation - #199

Merged
VesaJuvonen merged 1 commit into
mainfrom
feat/power-platform-gallery-publication
Oct 22, 2026
Merged

VesaJuvonen merged 1 commit into
mainfrom
feat/power-platform-gallery-publication

Conversation

@VesaJuvonen

Copy link
Copy Markdown
Collaborator

By submitting this pull request, you agree to the contribution guidelines

If you aren't familiar with how to contribute to open-source repositories using GitHub, or if you find the instructions on this page confusing, sign up for one of our Sharing is Caring events. It's completely free, and we'll guide you through the process.

To submit a pull request with multiple authors, make sure that at least one commit is a co-authored commit by adding a Co-authored-by: trailer to the commit's message. E.g.: Co-authored-by: name <name@example.com>

Put an x in all the items that apply ([x], without spaces), make notes next to any that haven't been addressed.

  • Bug fix? Repairs missing/invalid gallery metadata, migrated image/source links, case-sensitive Linux image paths, and UTF-8 portability in the newly merged sample's reference tests.
  • New sample? No; Add Moonfield Archive collectible-card binder and free packs #198 was reviewed and merged separately.
  • Related issues: no issue is automatically closed by this gallery publication PR.
  • Needs API permissions? No additional Power Platform API permissions. Only the Pages deployment job receives Pages/OIDC write permissions.
  • Has other prerequisites? Node.js 22.12+, GitHub Actions, and switching Pages from the legacy branch source to Actions after CI passes.

What's in this Pull Request?

Publish the Power Platform sample gallery with supplied product/platform logos, all five human portraits, StandardPath/GradientMesh artwork, light/dark themes, discovery filters, detail pages, contributor recognition, contribution guidance, and community/demo links.

  • Represent all 75 current sample folders and 36 contributors without silently excluding incomplete metadata.
  • Add read-only PR validation and a single GitHub Pages publisher with a daily legacy metadata refresh.
  • Preserve the historical catalog, 116 legacy sample links, a compatible 191-record samples.json export, the original snapshot/cleanup report, and 12 old-navigation redirects.
  • Explicitly report known non-sample artifacts in historical feeds instead of treating them as samples.
  • Verify the deployed commit, catalogs, current sample routes, and primary preview images after publication.
  • Replace the failing metadata branch-writer, retaining the historical Docs and gh-pages branches.
  • Add the actual gallery promo PNG to root assets and update README/contribution/development guidance.
  • Add legacy-repositories-assessment.md with recent activity, open contributions/issues, migration gaps, and archive prerequisites. No legacy repository archive settings are changed.
  • Retain single-count sample-view tracking; localhost previews and automated browser checks do not send visitor events.

Validation evidence

  • npm test in site: passed, 26 tests.
  • npm run check / final npx astro check: passed, zero errors, warnings, or hints.
  • npm run build:publication, followed by the final npx astro build after correcting redirect base paths: passed; 75 local samples, 116 legacy links, 191 compatible catalog records.
  • npm run validate:links: passed; 95 HTML pages and 601 unique internal targets.
  • npm run test:e2e: passed, 24 desktop/mobile tests, including both themes, accessibility, 320/375/768/1440 px overflow checks, legacy navigation, filtering/history, and tracking.
  • python -B -m unittest discover -s tests -v in samples/collectible-card-binder: passed, 22 reference/source tests after explicit UTF-8 file decoding. These do not execute Power Fx or import a solution.
  • npm run deployment:verify against the local production preview with expected revision local: passed; every current sample route and primary preview checked.
  • Important community, source, and download destinations: HTTP 200 after redirects.
  • Live GitHub deployment verification will run only after this PR passes CI and is merged to main.

Checklist

This checklist is mostly useful as a reminder of small things that can easily be forgotten – it is meant as a helpful tool rather than hoops to jump through.

Put an x in all the items that apply ([x], no spaces), make notes next to any that haven't been addressed.

  • My pull request affects only ONE sample. Not applicable: this is a repository-wide gallery/publication and metadata-maintenance change, not a new sample submission.
  • My sample includes a completed assets/sample.json metadata file. All 75 current sample folders are accounted for.
  • I have updated the sample's README.md. Related sample image references and repository/site guidance are updated.
  • My README has at least one static high-resolution screenshot (i.e. not a GIF). The root README includes a real 1440 px gallery promo PNG.
  • My README contains complete setup instructions, including prerequisites and required permissions.
  • The final line of my README is <img src="https://m365-visitor-stats.azurewebsites.net/powerplatform-samples/{sample-path}" />, with {sample-path} replaced by the repository-relative sample folder path. All 75 existing sample trackers are validated semantically, preserving valid attributes.

Submitter Guidance (DELETE AFTER READING)

Please update this PR information accordingly. We'll use this as part of our release notes in monthly communications.

Pull requests that do not follow this template will be automatically rejected.

Please target your PR to main branch.

Remember that this repository is maintained by community members who volunteer their time to help. Be courteous and patient.

(DELETE THIS SECTION AFTER READING)

…compatibility

Add the branded Astro gallery, repaired metadata, README promotion, read-only PR checks, Pages deployment verification, preserved legacy collections, and an archive-readiness assessment. Also make the newly merged sample reference tests portable across UTF-8 platforms.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@VesaJuvonen

Copy link
Copy Markdown
Collaborator Author

Linux CI passed: tracker validation, gallery/publication unit tests, sample reference tests, Astro checks/build, generated link checks, and desktop/mobile browser/accessibility tests. Pages is now configured to use GitHub Actions; the approved main-branch deployment will verify its live commit, catalogs, sample pages, and previews.

@VesaJuvonen
VesaJuvonen merged commit 85aed14 into main Oct 22, 2026
2 checks passed
@VesaJuvonen

Copy link
Copy Markdown
Collaborator Author

Published and live-verified: https://pnp.github.io/powerplatform-samples/ . Deployment run https://github.com/pnp/powerplatform-samples/actions/runs/39840589266 succeeded, including the expected commit check (85aed14), both catalogs, all current sample routes, and primary previews. The site serves 75 current samples, 36 contributors, 116 legacy links, and 191 compatibility records. PR validation and daily Pages refresh are enabled. No legacy repository archive settings were changed.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant