• 🚀 Generate Go applications and libraries in seconds within your Nx workspace
• ⚡ Zero-config setup – Automatic task inference for projects with go.mod
• 💨 Blazing-fast tasks – Optimized caching with smart inputs and outputs
• 🤝 Community friendly – Integration with recognized community projects such as Air
• 🗃️ Reliable – Use official Go commands in the background

You need to have a stable version of Go installed on your machine. And.. you are ready!

npx create-nx-workspace go-workspace --preset=@nx-go/nx-go

nx add @nx-go/nx-go

nx migrate @nx-go/nx-go

# Install it manually in your Nx workspace
npm install -D @nx-go/nx-go@beta
nx g @nx-go/nx-go:init

# Migrate if already using nx-go
nx migrate @nx-go/nx-go@beta

The plugin configures a multi-module Go workspace by default, to simplify project management and improve the quality of the Nx graph. If you don't want to take advantage of this feature, you can use generator convert-to-one-mod after the plugin installation. Generators will automatically adapt to your configuration.

nx g @nx-go/nx-go:convert-to-one-mod

You need to have a multi-module Go workspace to use inferred tasks.
Convert existing projects from executor-based to inferred task configuration:

nx g infer-targets

• application: Generate a Go application
• library: Generate a Go library

• build: Build a Go project
• generate: Generate code using Go
• lint: Format and lint a Go project
• serve: Run a Go application
• serve-air: Run a Go application with Air live reload
• test: Run tests of a Go project
• tidy: Ensures go.mod file matches a project source code

Want to try out these capabilities quickly? Visit our playground!

Need more customization? A plugin configuration is also available.

This plugin is only tested on stable versions of Go, older versions does not receive support. However, you can expect a fair degree of compatibility. Please note that multi-module Go workspaces require Go 1.18 or later.

Bram Borggreve Creator

Maxime Malgorn Maintainer

Licensed under MIT