your-project/
├── .github/
│   └── workflows/
│       ├── ci.yml          ← runs tests on every push/PR
│       ├── release.yml     ← publishes package on tag push
│       └── codeql.yml      ← security scanning on schedule
├── src/
├── package.json
└── README.md

on:
  # Trigger on push to any branch
  push:
    branches: ['**']

  # Trigger on push to main or release branches only
  push:
    branches: [main, 'release/**']

  # Trigger on pull request targeting main
  pull_request:
    branches: [main]

  # Run on a schedule (cron syntax — every day at 2am UTC)
  schedule:
    - cron: '0 2 * * *'

  # Allow manual trigger from the GitHub UI or API
  workflow_dispatch:
    inputs:
      environment:
        description: 'Deployment environment'
        required: true
        default: 'staging'

  # Trigger when another workflow completes
  workflow_run:
    workflows: ['CI']
    types: [completed]

name: Hello World

on:
  push:
    branches: [main]

jobs:
  greet:
    runs-on: ubuntu-latest

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

      - name: Print a greeting
        run: echo "Hello from GitHub Actions!"

name: CI                     # Display name in GitHub UI

on:                          # Trigger events
  push:
    branches: [main]
  pull_request:
    branches: [main]

env:                         # Workflow-level environment variables
  NODE_VERSION: '20'

jobs:
  test:                      # Job ID (can be any identifier)
    name: Run tests          # Display name in GitHub UI
    runs-on: ubuntu-latest   # Runner OS

    steps:
      - uses: actions/checkout@v4    # Built-in checkout action

      - name: Setup Node.js
        uses: actions/setup-node@v4  # Action from marketplace
        with:                        # Action inputs
          node-version: ${{ env.NODE_VERSION }}

      - name: Install dependencies
        run: npm ci                  # Shell command

      - name: Run tests
        run: npm test

      - name: Upload coverage
        uses: actions/upload-artifact@v4
        with:
          name: coverage-report
          path: coverage/