ci: release workflow

.github/actions/resolve-release-version/action.yml

@@ -0,0 +1,16 @@
+name: Resolve version
+description: Read "version" of "@tutorialkit/astro" to "steps.resolve-release-version.outputs.version"
+
+outputs:
+  version:
+    description: 'Version of @tutorialkit/astro'
+    value: ${{ steps.resolve-release-version.outputs.version }}
+
+runs:
+  using: composite
+
+  steps:
+    - name: Resolve release version
+      id: resolve-release-version
+      shell: bash
+      run: echo "version=$(jq -r .version ./packages/astro/package.json)" >> $GITHUB_OUTPUT

.github/actions/setup-and-build/action.yml

@@ -0,0 +1,25 @@
+name: Setup and build
+description: Generic setup action for actions
+inputs:
+  node-version:
+    required: false
+    description: Node version for setup-node
+    default: 20.x
+
+runs:
+  using: composite
+
+  steps:
+    - name: Set node version to ${{ inputs.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ inputs.node-version }}
+
+    - name: Install pnpm
+      uses: pnpm/action-setup@v2
+
+    - name: Install & Build
+      shell: bash
+      run: |
+        pnpm install
+        pnpm build

.github/workflows/ci.yaml

@@ -1,9 +1,11 @@
 name: CI
+
 on:
   push:
     branches:
       - main
   pull_request:
+
 jobs:
   test:
     name: Test
@@ -21,17 +23,14 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+
+      - uses: ./.github/actions/setup-and-build
         with:
           node-version: ${{ matrix.node-version }}
-      - name: Setup
-        uses: pnpm/action-setup@v4
-      - name: Install dependencies
-        run: pnpm install
+
       - name: Lint
         run: pnpm lint
-      - name: Build
-        run: pnpm build
+
       - name: Test
         run: pnpm test
 
@@ -41,12 +40,9 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v4
-      - name: Setup
-        uses: pnpm/action-setup@v4
-      - name: Install dependencies
-        run: pnpm install
-      - name: Build
-        run: pnpm build
+
+      - uses: ./.github/actions/setup-and-build
+
       - name: Build docs
         run: |
           pnpm run docs:build

.github/workflows/integration-test-cli.yaml

@@ -0,0 +1,27 @@
+name: Integration Tests CLI
+
+on:
+  pull_request:
+  workflow_dispatch:
+
+jobs:
+  cli-integration-test:
+    name: CLI Integration Tests
+    # Note: `prepare-release.yaml` sets this commit message
+    if: ${{ contains(github.event.pull_request.title, 'release tutorialkit CLI') }}
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup-and-build
+
+      - name: Update template's versions
+        working-directory: ./packages/cli
+        run: pnpm update-template
+
+      - name: Integration Tests
+        working-directory: ./integration
+        run: pnpm test

.github/workflows/prepare-release.yaml

@@ -0,0 +1,41 @@
+name: Prepare release PR
+
+on:
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish, e.g. 0.0.1'
+        required: true
+        default: '0.0.1'
+        type: string
+
+jobs:
+  prepare_release:
+    name: Prepare release PR
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup-and-build
+
+      - name: Bump versions
+        run: >
+          pnpm --recursive
+          --filter "@tutorialkit/*"
+          exec pnpm version --no-git-tag-version --allow-same-version ${{ inputs.version }}
+
+      - name: Generage changelog
+        run: pnpm run changelog
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          # Note: `publish-release.yaml` checks explicitly for this commit message
+          commit-message: 'chore: release @tutorialkit packages, version: ${{ inputs.version }}'
+          title: 'chore: release @tutorialkit packages, version: ${{ inputs.version }}'
+          body: 'Bump packages to version ${{ inputs.version }} and generate changelogs'
+          reviewers: SamVerschueren,d3lm,Nemikolh,AriPerkkio
+          branch: chore/release-${{ inputs.version }}

.github/workflows/publish-release.yaml

@@ -0,0 +1,108 @@
+name: Publish release
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  publish_release:
+    name: Publish release
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    # Note: `prepare-release.yaml` sets this commit message
+    if: ${{ contains(github.event.head_commit.message, 'release @tutorialkit packages') }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup-and-build
+
+      # Sets steps.resolve-release-version.outputs.version
+      - uses: ./.github/actions/resolve-release-version
+        id: resolve-release-version
+
+      - name: Publish to npm
+        run: >
+          pnpm --recursive
+          --filter "@tutorialkit/*"
+          exec pnpm publish --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+
+      - name: Create and push git tag
+        run: |
+          git config --global user.name 'github-actions'
+          git config --global user.email '[email protected]'
+          git tag v${{ steps.resolve-release-version.outputs.version }}
+          git push origin v${{ steps.resolve-release-version.outputs.version }}
+
+  prepare_cli_release:
+    name: Prepare release for CLI
+    needs: [publish_release]
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup-and-build
+
+      # Sets steps.resolve-release-version.outputs.version
+      - uses: ./.github/actions/resolve-release-version
+        id: resolve-release-version
+
+      - name: Bump version
+        run: >
+          pnpm --recursive
+          --filter tutorialkit
+          --filter create-tutorial
+          exec npm version --no-git-tag-version --allow-same-version ${{ steps.resolve-release-version.outputs.version }}
+
+      - name: Create Pull Request
+        uses: peter-evans/create-pull-request@v6
+        with:
+          # Note: `publish-release.yaml` checks explicitly for this commit message
+          commit-message: 'chore: release tutorialkit CLI, version: ${{ steps.resolve-release-version.outputs.version }}'
+          title: 'chore: release tutorialkit CLI, version: ${{ steps.resolve-release-version.outputs.version }}'
+          body: 'Bump tutorialkit CLI to version ${{ steps.resolve-release-version.outputs.version }}'
+          reviewers: SamVerschueren,d3lm,Nemikolh,AriPerkkio
+          branch: chore/release-cli-${{ steps.resolve-release-version.outputs.version }}
+
+  publish_release_CLI:
+    name: Publish release CLI
+    runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      id-token: write
+    # Note: `prepare-release.yaml` sets this commit message
+    if: ${{ contains(github.event.head_commit.message, 'release tutorialkit CLI') }}
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+
+      - uses: ./.github/actions/setup-and-build
+
+      - name: Update template's versions
+        working-directory: ./packages/cli
+        run: pnpm update-template
+
+      - name: Integration Tests
+        working-directory: ./integration
+        run: pnpm test
+
+      - name: Publish to npm
+        run: >
+          pnpm --recursive
+          --filter tutorialkit
+          --filter create-tutorial
+          exec pnpm publish --provenance
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}

.gitignore

@@ -18,7 +18,7 @@ dist-ssr
 *.sln
 *.sw?
 .pnpm-store
-/tutorialkit/template
+/packages/cli/template
 tsconfig.tsbuildinfo
 tsconfig.build.tsbuildinfo
 .tmp