Code Quality Check and Build workflow (talebook/talebook)

The Code Quality Check and Build workflow from talebook/talebook, explained and optimized by Latchkey.

CI health: C - fair

Point runs-on at Latchkey and get run de-duplication, job timeouts, self-healing for flaky steps, and up to 58% lower cost, applied automatically.

Grade your own workflow free or run it on Latchkey →

Source: talebook/talebook.github/workflows/ci.ymlLicense BSD-2-ClauseView source

What it does

This is the Code Quality Check and Build workflow from the talebook/talebook repository, a real project running GitHub Actions. It is shown here with attribution under its BSD-2-Clause license.

Below, Latchkey shows a faster, safer version produced by its optimization engine.

The workflow

workflow (.yml)

name: Code Quality Check and Build

on:
  push:
    branches:
      - master
      - dev
      - dev-*
  pull_request:
    branches:
      - master

jobs:
  test-server:
    runs-on: ubuntu-latest
    container:
      image: talebook/talebook-base:latest
      options: --user root

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Configure Git safe directory
        run: git config --global --add safe.directory /__w/talebook/talebook

      - name: Inspect environment
        run: |
          which calibre
          calibre --version
          python3 --version
          pip3 --version

      - name: Install Python dependencies
        run: make init

      - name: Lint with ruff
        run: make lint-py

      - name: Run tests with pytest
        run: make pytest

  test-ui:
    runs-on: ubuntu-latest
    container:
      image: node:20-alpine

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Install dependencies
        run: |
          cd app
          npm ci

      - name: Run linting
        run: |
          cd app
          npm run lint

      - name: Nuxt build
        run: |
          cd app
          npm run build

      - name: Generate build artifact
        if: success()
        uses: actions/upload-artifact@v4
        with:
          name: nuxt-build
          path: app/.nuxt
          retention-days: 1

  integration-test:
    runs-on: ubuntu-latest
    needs: [test-server, test-ui]

    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: All tests passed
        run: |
          echo "✅ All tests completed successfully"
          echo "Server tests: ✓"
          echo "UI tests: ✓"

The same workflow, on Latchkey

Removes redundant runs and caps runaway jobs. Added and changed lines are highlighted.

name: Code Quality Check and Build
 
on:
  push:
    branches:
      - master
      - dev
      - dev-*
  pull_request:
    branches:
      - master
 
concurrency:
  group: ${{ github.workflow }}-${{ github.ref }}
  cancel-in-progress: true
 
jobs:
  test-server:
    timeout-minutes: 30
    runs-on: latchkey-small
    container:
      image: talebook/talebook-base:latest
      options: --user root
 
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
 
      - name: Configure Git safe directory
        run: git config --global --add safe.directory /__w/talebook/talebook
 
      - name: Inspect environment
        run: |
          which calibre
          calibre --version
          python3 --version
          pip3 --version
 
      - name: Install Python dependencies
        run: make init
 
      - name: Lint with ruff
        run: make lint-py
 
      - name: Run tests with pytest
        run: make pytest
 
  test-ui:
    timeout-minutes: 30
    runs-on: latchkey-small
    container:
      image: node:20-alpine
 
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
 
      - name: Install dependencies
        run: |
          cd app
          npm ci
 
      - name: Run linting
        run: |
          cd app
          npm run lint
 
      - name: Nuxt build
        run: |
          cd app
          npm run build
 
      - name: Generate build artifact
        if: success()
        uses: actions/upload-artifact@v4
        with:
          name: nuxt-build
          path: app/.nuxt
          retention-days: 1
 
  integration-test:
    timeout-minutes: 30
    runs-on: latchkey-small
    needs: [test-server, test-ui]
 
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
 
      - name: All tests passed
        run: |
          echo "✅ All tests completed successfully"
          echo "Server tests: ✓"
          echo "UI tests: ✓"

What changed

Run on Latchkey managed runners with one line (runs-on), which apply the fixes below automatically and self-heal transient failures. This example uses latchkey-small; pick the runner size that fits the job.
Cancel superseded runs when a branch or PR gets a newer push.
Add a job timeout so a hung step cannot burn hours of runner time.

What Latchkey heals here

This workflow has steps that commonly fail on transient issues (network, registries, flaky browsers). On Latchkey managed runners they are detected, retried, and self-healed instead of failing your build:

Dependency installs

This workflow runs 3 jobs per trigger. On Latchkey the same minutes cost up to 58% less than GitHub-hosted, with zero queue time.

Actions used in this workflow

actions/checkout actions/upload-artifact