Deploy Skill

This skill provides deployment operations for sending build artifacts to a Nintendo Switch console.

When to Use This Skill

Use this skill when you need to:

• •Deploy build artifacts (e.g., NRO files) to a Nintendo Switch for testing
• •Send test builds to the console after compilation
• •Verify that built homebrew runs correctly on hardware

Prerequisites

1. •Nintendo Switch must be running a homebrew environment (e.g., Atmosphère)
2. •nxlink server must be running on the Switch (usually via hbmenu's netloader)
3. •Network connectivity between development machine and Switch
4. •cargo-nx must be installed (see installation section below)

Available Commands

Deploy Build Artifact

just deploy <path-to-file>

Deploys a build artifact to the Nintendo Switch via cargo nx link.

Examples

Deploy hbmenu:

just deploy buildDir/subprojects/nx-hbmenu/hbmenu.nro

Deploy test suite:

just deploy buildDir/subprojects/tests/nx-tests.nro

Deploy with extra flags:

just deploy buildDir/subprojects/tests/nx-tests.nro --address 192.168.1.100

Install cargo-nx

If cargo nx is not available, ask the user to install it:

just install-cargo-nx

🚨 Do NOT run this command yourself. Ask the user to run it manually.

This builds and installs cargo-nx from the submodule.

Common Deployment Paths

After building with just meson-compile, build artifacts are located at:

Workflow

Complete build-and-deploy workflow:

1. •

   Build the target:

   bash

   just meson-compile hbmenu.nro
   

2. •

   Deploy to Switch:

   bash

   just deploy buildDir/subprojects/nx-hbmenu/hbmenu.nro
   

3. •

   Ask user for confirmation:

   • •For general deployments: Ask user to confirm the deployment worked as expected
   • •For test deployments: Ask user to confirm the tests PASSED on the console

Retry on Failure

🚨 If deployment fails (e.g., Switch not found on network), retry up to 3 times with a 10-second delay between attempts.

# Attempt 1
just deploy buildDir/path/to/file.nro

# If failed, wait 10 seconds and retry
sleep 10
just deploy buildDir/path/to/file.nro

# If failed again, wait 10 seconds and retry one more time
sleep 10
just deploy buildDir/path/to/file.nro

Common reasons for deployment failure:

• •Switch not connected to the network
• •nxlink server not running on the Switch
• •Network timeout or connectivity issues

Troubleshooting

Connection Issues

• •Ensure Switch and development machine are on the same network
• •Check that nxlink server is running on the Switch

cargo-nx Not Found

If you see an error about cargo nx not being found, ask the user to run:

just install-cargo-nx

🚨 Do NOT run this command yourself.

Related Skills

• •/build - Build targets before deploying
• •/format - Format code before building
• •/test - Full test workflow with deploy