area44/workflows

This repository provides reusable GitHub Actions workflows and composite actions for the AREA44 ecosystem. It helps standardize and streamline CI/CD processes across projects.

Composite Actions

• Pages (area44/workflows/pages@main): Unified action to build static sites and upload GitHub Pages artifacts with automatic environment setup and Vite+ detection.
• Autofix (area44/workflows/autofix@main): Automatically update code.

Quick Usage

name: GitHub Pages

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

permissions:
  contents: read
  pages: write
  id-token: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v7

      - name: Build site artifact
        uses: area44/workflows/pages@main
        with:
          # Optional: runtime: 'node@24'
          # Optional: path: 'dist'
          # Optional: build-command: 'npm run build'

Public Action API Summary

Each action's action.yml serves as the single source of truth for its public API contract (inputs, outputs, defaults, required status).

pages (GitHub Pages Build and Upload)

Inputs

Name	Description	Default	Required
path	Directory where the built site is located	dist	Optional
runtime	Optional runtime and version override (e.g. node@24, bun@1.4)		Optional
build-command	Custom build command	<package-manager> run build	Optional

Outputs

Name	Description
node-version	The Node.js version used
bun-version	The Bun version used
package-manager	The package manager used
package-manager-version	The version of the package manager used
runtime	The runtime used (node or bun)
toolchain	The resolved toolchain (vite or vite-plus)
vp-version	The version of Vite+ installed

autofix (Automatically update code)

Inputs

Name	Description	Default	Required
runtime	Optional runtime and version override (e.g. node@24, bun@1.4)		Optional

Outputs

Name	Description
node-version	The Node.js version used
bun-version	The Bun version used
package-manager	The package manager used
package-manager-version	The version of the package manager used
runtime	The runtime used (node or bun)
has-python-source	Whether Python source code was detected
python-version	The Python version used
python-package-manager	The Python package manager detected (uv or pip)
ruff-version	The Ruff version specified by the project or empty string for default

Documentation Architecture

Specialized documentation guides explain specific contracts and operational guarantees:

• Error Contract: Defines the error handling architecture, native error propagation.
• Security Boundaries: Input trust model, command tokenization without subshell execution, and credential masking.
• Maintenance & Repository Health: Repository invariants, source of truth files, and release process.

License

This project is licensed under the MIT License.