nx.js is a framework that enables the development of Nintendo Switch homebrew applications using JavaScript. Powered by the QuickJS engine, nx.js provides a streamlined environment for writing homebrew applications for the Nintendo Switch console.
With nx.js, developers can leverage their JavaScript skills and tools to create engaging and interactive experiences for the Nintendo Switch platform. The framework abstracts the underlying low-level details and provides a high-level JavaScript API that simplifies the development process.
nx.js is designed with Web standards in mind, so familiar APIs like
setTimeout()
, fetch()
, new URL()
, Canvas
and much more are
supported. If you are familar with web development then you should feel
right at home.
- JavaScript Development: Write homebrew applications for the Nintendo Switch using JavaScript, a popular and widely supported programming language.
- High-Level API: Benefit from a high-level JavaScript API designed specifically for the Nintendo Switch platform, providing easy access to console-specific features and functionality.
- Input Handling: Capture and process user input with ease, including buttons, touch screen, and motion controls, to create engaging gameplay experiences.
- Graphics and UI: Create visually appealing and interactive user interfaces using the web
Canvas
API. - Audio Support: Integrate audio playback and sound effects into your applications using the web
Audio
API. - WebAssembly: Support for executing code compiled to WebAssembly (WASM).
- Set up a custom firmware on your Switch, so that it can run homebrew applications (instructions).
- Download the
nxjs.nro
file from the Releases page. - Create a file called
nxjs.js
with the following contents:console.log('Hello Switch, from JavaScript!');
- Copy both files into the
/switch
directory on your SD card. - Launch the app from the homebrew loader.
- Profit!
See the API docs for further details, and check out the apps
directory for examples.
Run the following command to bootstrap the creation of an nx.js application:
npm create nxjs-app@latest
You will be able to choose from one of the example applications as a starting point. Follow the prompts, and afterwards a new directory will be created with the project name that you entered.
The following package.json
scripts are configured:
build
- Bundle the application code into a single JavaScript file usingesbuild
nro
- Package the bundled app (+ any other files in theromfs
dir) into a self-contained.nro
file
Contributions to nx.js are welcome! If you find any issues or have suggestions for improvements, please open an issue or submit a pull request in the GitHub repository.
nx.js is released under the MIT License. Please see
the LICENSE
file for more details.