Skip to content

Create an App

This page focuses on nsx create-app as the normal entry point for new work.

Task

Generate a new app with an initial board target.

Command

nsx create-app <app-dir> --board <board>

Example:

nsx create-app hello_ap510 --board apollo510_evb

What Happens

NSX:

  1. creates the app directory
  2. writes nsx.yml
  3. writes the top-level CMakeLists.txt
  4. copies packaged cmake/nsx/ support
  5. resolves the initial module closure for the selected board
  6. vendors modules and board files into the app

The selected board is the app's initial active target. The app model also supports an explicit targets.default and targets.supported set; lifecycle commands select one declared board at a time with --board.

Result

You get a standalone app at:

<app-dir>

If you are working from a source checkout, activate the uv environment first and then run the same nsx ... command.

See App Layout for the resulting structure.