---

name: build description: Configure, reconfigure, and build targets in the nx-std monorepo using just tasks. Use when configuring build options, reconfiguring an existing build, or compiling NRO files and other build artifacts. allowed-tools: Bash(just --list:), Bash(just configure:), Bash(just reconfigure:), Bash(just list-targets:), Bash(just list-options:), Bash(just list-options-configured:), Bash(just list-dependencies:), Bash(just build:), Bash(just meson-compile:), Bash(just compile:), Bash(just build-tests:*)

Build Target Skill

MANDATORY: Use just tasks for all build operations in this project.

Important: This is a Meson Project

This project uses the Meson build system with Cargo integration. Configuration must be done first before building any targets.

Initial Configuration

If buildDir/ doesn't exist (first time setup):

Copyjust configure

This runs meson setup buildDir with default options from meson.options.

With options:

Copyjust configure -Duse_nx=enabled

Reconfiguring an Existing Build

If buildDir/ already exists and you need to change options, use reconfigure:

Copyjust reconfigure -Duse_nx=enabled -Duse_nx_sf=disabled

This runs meson setup --reconfigure to update the existing configuration.

When to use which:

• just configure - First time setup, or after just clean-all
• just reconfigure - Changing options on an already-configured build

Listing Available Options

List all project options (from meson.options):

Copyjust list-options

List currently configured options (requires configured build):

Copyjust list-options-configured

Configuring with Options

Configure with specific options:

Copyjust configure -Duse_nx=enabled

Configure with multiple options:

Copyjust configure -Duse_nx=enabled -Duse_libnx_dkp=disabled

Tip: Run just list-options first to see available options and their defaults.

Listing Available Targets

After configuration, list available targets to see what can be compiled:

Copyjust list-targets

This shows all build targets with their names, types, and locations.

Building a Target

Primary command: just build <target-name>

Aliases: just meson-compile <target-name> or just compile <target-name>

Examples

Build hbmenu:

Copyjust build hbmenu.nro

Build tests:

Copyjust build nx-tests.nro

Or use the dedicated test task:

Copyjust build-tests

Build multiple targets:

Copyjust build hbmenu.nro nx-tests.nro

Build all targets (no arguments):

Copyjust build

Critical Rules

1. Configure first - Run just configure before building if buildDir/ doesn't exist
2. Reconfigure to change options - Use just reconfigure when buildDir/ already exists
3. NEVER use ninja directly - always use just build
4. NEVER use meson compile directly - always use just build
5. NEVER use meson setup directly - always use just configure or just reconfigure
6. List targets first if unsure what can be built
7. Use exact target names from just list-targets output

Build Output

Build artifacts are located in:

• buildDir/ - Meson output (NRO/NSP bundles, C objects, ELF files)
• buildDir/cargo-target/ - Rust compilation artifacts

Complete Workflow

1. Initial setup (first time or clean build):

   Copyjust list-options                    # See available options
   just configure -Duse_nx=enabled      # Configure with desired options
   

2. List targets (if unsure):

   Copyjust list-targets
   

3. Build target:

   Copyjust build <target-name>
   

4. Verify build (check for symbol overrides):

   Copy/opt/devkitpro/devkitA64/bin/aarch64-none-elf-nm buildDir/path/to/file.elf | rg '__nx_'
   

5. Deploy (if building NRO):

   Copyjust deploy buildDir/path/to/file.nro
   

Reconfiguring

To change build options after initial configuration, use reconfigure:

Copyjust reconfigure -Duse_nx=disabled

To clean and start fresh:

Copyjust clean-all
just configure -Duse_nx=enabled