go-build/README.md
Snider cbdb8028dc feat(build): action-style upload artifact naming + doc parity
- release.yml: generated workflow computes upload artifact names in action
  shape {build-name}_{os}_{arch}_{tag|shortsha} with repo-name fallback
- workflow_test + cmd_workflow_test: artifact-name derivation coverage
- README + docs/index + docs/architecture + CLAUDE.md: refreshed to describe
  current module path, builders/publishers, generated workflow/action surface,
  Apple pipeline — replaces pre-spec documentation

Verified: go test ./... passes

Co-Authored-By: Virgil <virgil@lethean.io>
2026-04-14 21:24:17 +01:00

1.7 KiB

go-build

dappco.re/go/core/build is the build, release, SDK, Apple packaging, and workflow toolkit behind core build, core release, core sdk, core ci, and the public dAppCore/build@v3 GitHub Action surface.

What It Covers

  • Project discovery across Go, Wails, Node, Deno, PHP, Python, Rust, Docs, Docker, LinuxKit, C++, and Taskfile projects
  • Cross-platform artifact builds with archive and checksum generation
  • Eight release publishers: GitHub, Docker, npm, Homebrew, Scoop, AUR, Chocolatey, and LinuxKit
  • macOS Apple pipeline: core build apple, codesign, notarisation, DMG packaging, TestFlight/App Store submission, Info.plist and entitlements generation, Xcode Cloud scripts
  • OpenAPI SDK generation for TypeScript, Python, Go, and PHP with oasdiff breaking-change checks
  • Reusable release workflow generation via core build workflow

Action/Workflow Parity

The generated reusable workflow mirrors the dAppCore/build@v3 action architecture:

  • Auto-detects stack markers including subtree frontend manifests and MkDocs projects
  • Installs Go, Node, Python, Conan, MkDocs, Deno, and Wails when required
  • Applies distro-aware Linux WebKit dependencies for Wails builds
  • Supports obfuscation, NSIS packaging, WebView2 modes, Deno frontend overrides, and build cache restore/save
  • Uploads workflow artifacts using the action-style naming shape: {build-name}_{os}_{arch}_{tag|shortsha}

Commands

core build
core build apple
core build workflow
core build sdk
core ci

Module

import "dappco.re/go/core/build/pkg/build"

The repository is a library/command-registration module. It does not ship its own standalone binary.