Skip to content

Getting Started

Get BaseCoat assets into your repo in under 5 minutes.

Prerequisites

  • GitHub repo with Copilot enabled
  • gh CLI or direct repo access

Run the sync script in your repo root:

$tag = (gh release list --repo IBuySpy-Shared/basecoat --limit 1 --json tagName -q '.[0].tagName')
$url = "https://github.com/IBuySpy-Shared/basecoat/releases/download/$tag/base-coat-$tag.zip"
Invoke-WebRequest $url -OutFile base-coat.zip
Expand-Archive base-coat.zip -DestinationPath .github/base-coat -Force
Remove-Item base-coat.zip

curl -fsSL https://raw.githubusercontent.com/IBuySpy-Shared/basecoat/main/scripts/sync.sh | bash

After syncing, your repo will have a .github/base-coat/ directory containing all BaseCoat assets.

Option 2: Manual setup

  1. Go to the latest release
  2. Download base-coat-<version>.zip
  3. Extract to .github/base-coat/ in your repo
  4. Commit the result

Verify your sync

Check the version installed:

cat .github/base-coat/version.json

Keep it up to date

Add the version drift detector to your repo — it opens an issue automatically when BaseCoat has a new release:

# .github/workflows/check-basecoat-version.yml
name: Check BaseCoat Version
on:
  schedule:
    - cron: '0 9 * * 1'  # Weekly Monday 09:00 UTC
  workflow_dispatch:
jobs:
  check:
    uses: IBuySpy-Shared/basecoat/.github/workflows/check-basecoat-version-callable.yml@main
    with:
      stage_path: .github/base-coat
      alert_threshold: 1
    permissions:
      issues: write
      contents: read

Next steps