Guides¶

These guides explain each PSScriptBuilder feature in depth. They assume you already have a working build if you are new, start with the Quick Start. The guides are grouped into three areas that follow the natural workflow: building a script, analyzing its structure, and publishing a release.

Building¶

Configure, collect, and assemble these guides cover each step of the build pipeline in order.

Configuration

Centralizes build and release settings in a single JSON file. Covers path resolution and project root discovery.

Configuration
Collectors

Scan source files and extract classes, functions, enums, using statements, and raw file content.

Collectors
Templates

Define the output script structure with placeholders Free, Hybrid, and Ordered mode.

Templates
Build Pipeline

Run the full pipeline, interpret the result, configure backups, and post-process the output.

Build Pipeline
Tool Integrations

Combine PSScriptBuilder with Invoke-Build, PSScriptAnalyzer, Pester, and ModuleBuilder.

Tool Integrations

Analysis¶

Inspect what PSScriptBuilder collects and resolves without producing any output.

Dependency Analysis

Build a dependency graph, detect cycles, and determine the correct component load order.

Dependency Analysis
Code Analysis

Inspect your project's structure and collector content without running a build.

Code Analysis

Publishing¶

Manage versions, propagate metadata, and automate the full workflow in CI/CD.

Release Management

Track and propagate version numbers, build metadata, and Git context across all registered project files.

Release Management
CI/CD Integration

Integrate PSScriptBuilder into any CI/CD system with a GitHub Actions example.

CI/CD Integration