Skip to content

Go Gamma Actions

Reusable GitHub Actions Workflows for Go Projects


Go Gamma Actions provides a comprehensive, production-ready CI/CD pipeline for Go projects. With a single workflow file, you get testing, linting, security scanning, and cross-platform builds.

Features

  • Comprehensive Testing


    Race detection, test shuffling, and automatic coverage uploads to Codecov.

    Testing Workflow

  • 50+ Linters


    Pre-configured golangci-lint with gocyclo, gosec, staticcheck, and more.

    Linting Workflow

  • Security Scanning


    gosec and govulncheck with GitHub Code Scanning integration.

    Security Workflow

  • Cross-Platform Builds


    Verify builds on Linux, macOS, and Windows automatically.

    Build Workflow

Quick Start

Add this to .github/workflows/ci.yml in your project:

name: CI

on:
  push:
    branches: [main]
  pull_request:
    branches: [main]

permissions:
  contents: read
  security-events: write

jobs:
  ci:
    uses: go-gamma/actions/.github/workflows/ci.yml@v1
    permissions:
      contents: read
      security-events: write
    with:
      go-version: '1.24'
    secrets:
      CODECOV_TOKEN: ${{ secrets.CODECOV_TOKEN }}

That's it! Your project now has a complete CI pipeline.

What's Included

Workflow Description
ci.yml Combined CI pipeline (recommended)
test.yml Testing with coverage
lint.yml Code quality analysis
security.yml Security scanning
build.yml Cross-platform builds
release.yml Automated releases

Requirements

  • Go 1.24+ (or specify via go-version-file)
  • GitHub Actions enabled on your repository
  • Codecov account (optional, for coverage tracking)

Next Steps