AzureLocal Platform

Centralized standards, reusable workflows, test frameworks, and scaffolding for the AzureLocal organization.

What this is

AzureLocal/platform is the single home for everything that's shared across the ~28 repos in the AzureLocal GitHub organization. Product repos contain only product-specific code and reference this repo for standards, testing frameworks, CI primitives, and scaffolding.

Companion repo: AzureLocal/.github owns GitHub-metadata governance (community health files, org-level reusable workflows). platform owns developer tooling.

Contents

Folder	Purpose
standards/	Canonical standards documents (single source of truth)
repo-management/	Templates for per-repo /repo-management folders + org-wide automation scripts
testing/maproom/	Offline fixture-based testing framework (classes, generators, harness, schema)
testing/trailhead/	Live-cluster validation templates and scripts
testing/iic-canon/	Canonical IIC identity data (the one copy)
templates/	Starter skeletons for new repos (5 variants: ps-module, ts-web-app, iac-solution, migration-runbook, training-site)
scripts/	Platform's own automation (build, test, release)
modules/powershell/	Shared PowerShell helpers (AzureLocal.Common)
docs/	Full MkDocs Material site source
decisions/	Architectural Decision Records (ADRs)

How product repos consume this

Every product repo carries three breadcrumbs pointing here:

1. A README badge linking to this repo
2. A STANDARDS.md stub at repo root linking to platform/standards
3. A .azurelocal-platform.yml metadata file declaring the repo type and which platform features it adopts

Reusable workflows are referenced by tag:

jobs:
  ci:
    uses: AzureLocal/platform/.github/workflows/reusable-ps-module-ci.yml@v1

See docs/reusable-workflows/consumer-patterns.md for copy-paste examples per repo type.

Documentation

Full docs site: https://AzureLocal.github.io/platform/

Quick links:

• Getting started
• Onboarding an existing repo
• Creating a new repo
• Consuming reusable workflows
• MAPROOM overview
• TRAILHEAD overview
• Architecture overview

License

MIT — see LICENSE.