nx-start

Project generator for Nintendo Switch homebrews.

Table of Contents

• Features
• Installation
• Generating a libnx (C++) project
• Generating a libtransistor (C) project
• Generating a BrewJS project
• Generating a PyNX project
• Skip prompts

Features

• Generate a libnx (C++) project using nxstart libnx
• Generate a libtransistor (C) project using nxstart libt
• Generate a BrewJS (Javascript) project using nxstart brewjs
• Generate a PyNX (Python) project using nxstart pynx

Installation

Install from PyPi using pip, a package manager for Python.

pip install nxstart

Don't have pip installed? Try installing it, by running this from the command line:

curl "https://bootstrap.pypa.io/get-pip.py" | python

Or, you can download the source code for nxstart and then run:

python setup.py install

You may need to run the above commands with sudo.

Generating a libnx (C++) project

Run nxstart libnx. It will ask for a project name, author name and if you are using CLion (IDE by Jetbrains). If you say yes to CLion, CMakeLists.txt will be included.

The following project structure will be generated:

project
│   .editorconfig 
│   .gitignore
│   CMakeLists.txt  // Only if you use CLion
│   Makefile      
│   icon.jpg  
│   README.md
│
└───data
│   
└───include
│ 
└───source
    │   main.cpp    // Your main application file

Generating a libtransistor (C) project

Run nxstart libt. It will ask for a project name, author name and if you are using CLion (IDE by Jetbrains). If you say yes to CLion, CMakeLists.txt will be included.

The following project structure will be generated:

project
│   .editorconfig 
│   .gitignore
│   CMakeLists.txt  // Only if you use CLion
│   main.c          // Your main application file
│   Makefile
│   icon.jpg
│   README.md           
│

Generating a BrewJS (Javascript) project

Run nxstart brewjs. It will ask for a project name and author name. The following project structure will be generated:

project
│   .editorconfig 
│   .gitignore     
│   package.json
│   Source.js        // Your main application file
│   README.md   
│
└───assets
│   

Generating a PyNX (Python) project

Run nxstart pynx. It will ask for a project name and author name. The following project structure will be generated:

project
│   .editorconfig 
│   .gitignore     
│   main.py        // Your main application file
│   README.md   
│   

Skip prompts

To skip the prompts, provide the necessary flags. For example:

nxstart -n "My new project" -a "John Doe" libnx --clion

Or if you don't use CLion:

nxstart -n "My new project" -a "John Doe" libnx --no-clion

Running tests

Tests can be run with the pytest command. If you are contributing code, make sure all tests are green before submitting a PR.