NexisChat Docs
ActionsSetup

Local Testing with act

Run GitHub Actions locally using act and helper scripts.

Test workflows locally to iterate faster.

Prerequisites

  • Install Docker and ensure it is running
  • Install act
    • macOS: brew install act
    • Linux: curl https://raw.githubusercontent.com/nektos/act/master/install.sh | sudo bash
    • Windows: choco install act-cli

Helper scripts

  • act-test (from @repo/scripts package)

    • List workflows: bun run act-test list
    • Run CI: bun run act-test ci
    • Run job: bun run act-test job ci typecheck
    • Dry run: bun run act-test dry-run ci

  • act-component-test (from @repo/scripts package)

    • List components: bun run act-component-test list
    • Test a component: bun run act-component-test test apps/client build
    • Test all components: bun run act-component-test test-all lint

Secrets

  • Use .secrets file for local env values; the helper script can scaffold it if missing

Husky Pre-push & Commitlint

Enforce local checks before pushing and Conventional Commits formatting.

Project Setup

Expectations for scripts and structure to integrate cleanly with CI and local tooling.