NovaModuleTools
Menu Home

NovaModuleTools for developers

Build PowerShell modules with a workflow you can actually understand

This site is the end-user manual for NovaModuleTools. Use it to install the module, scaffold a project, understand project.json, and move through build, test, package, upload, publish, release, versioning, and self-update workflows without guessing.

Start with the quickstart Open the project.json reference
1 Get working fast

Use the quickstart to install Nova, scaffold the packaged example, build it, test it, and import a working module.

2 Learn the daily loop

Understand the normal scaffold → build → test → import/reload flow before you move on to packaging and release.

3 Configure with confidence

Use the project.json reference and delivery guides when you are ready to package, upload, publish, or automate.

This site is organized around how developers actually adopt the tool

You should not need to read built-in help cover to cover to become productive. Start with the quickstart, jump to the exact task you need next, and use the reference pages when you are tuning configuration or delivery behavior.

Choose your next task

Each page is written for developers who want a clear answer quickly, with commands, examples, and expected outcomes.

Getting Started

Install NovaModuleTools, understand the PowerShell and CLI entrypoints, and get your first working project built and tested.

Open the quickstart tutorial

Core Workflows

Follow the day-to-day scaffold, build, test, import, and reload workflow you will use most often.

Open the core workflow guide

project.json Reference

See every supported configuration area, defaults, and practical recipes for build, packaging, upload, and test settings.

Open the configuration reference

Working with Modules

Learn why Nova is designed around the built output in dist/, how to reload safely, and how to use the packaged example.

Open the working-with-modules guide

Troubleshooting

Fix the most common problems around paths, reload behavior, version bumps, package uploads, and command selection.

Open troubleshooting

Concepts

Build a mental model for how Nova structures a project, why it builds into dist/, and how settings shape the workflow.

Open the concepts guide

Recommended first 15-minute path

  1. Install the module and import it into PowerShell.
  2. If you want the nova launcher on macOS/Linux, install it with Install-NovaCli.
  3. Open Getting Started and keep the page on your chosen PowerShell or command-line surface.
  4. Scaffold the packaged example, then build and test it.
  5. Run the example command from the built or locally published module.

This path proves the tool works, shows the real folder structure, and gives you a runnable module before you start customizing anything.

What NovaModuleTools helps you do

  • scaffold a structured PowerShell module project
  • build a real module into dist/ instead of running loose source files
  • test the current project with Pester by using the project-defined workflow
  • create package artifacts for raw distribution
  • upload package artifacts to raw HTTP endpoints
  • publish modules locally or to PowerShell repositories
  • orchestrate build, test, version bump, and publish as a release flow