Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/rahul-vashishtha/nodegui-mvc-starter

This boilerplate aims to provide a basic structure and format to build large complex application using NodeGUI.
https://github.com/rahul-vashishtha/nodegui-mvc-starter

Last synced: 27 days ago
JSON representation

This boilerplate aims to provide a basic structure and format to build large complex application using NodeGUI.

Awesome Lists containing this project

README

        

# nodegui-mvc-starter

**Clone and run to build complex applications in simple modular way.**

## About

This starter boilerplate is the modified version of the official [nodegui-starter](https://github.com/nodegui/nodegui-starter). This boilerplate aims to provide a basic structure and format to build large complex application using NodeGUI.
This uses the [nodegui-deb-builder](https://github.com/RinneganTech/nodegui-deb-builder "NodeGUI Debian Builder") to generate `.deb` package.

## To Use

To clone and run this repository you'll need [Git](https://git-scm.com) and [Node.js](https://nodejs.org/en/download/) (which comes with [npm](http://npmjs.com)) installed on your computer.

Make sure you have met the requirements listed here: https://docs.nodegui.org/#/tutorial/development-environment

From your command line:

```bash
# Clone this repository
git clone https://github.com/RinneganTech/nodegui-mvc-starter
# Go into the repository
cd nodegui-mvc-starter
# Install dependencies
npm install
# Run the app
npm start
```

## Resources for Learning NodeGui

- [docs.nodegui.org](https://nodegui.github.io/nodegui) - all of NodeGui and React Desktop's documentation

## Packaging app as a distributable

In order to distribute your finished app, you can use [@nodegui/packer](https://github.com/nodegui/packer).

**Note:** For building on Debian, Follow the [nodegui-deb-builder](https://github.com/RinneganTech/nodegui-deb-builder "NodeGUI Debian Builder") guide to build .deb executable.

### Step 1: (_**Run this command only once**_)

```sh
npx nodegui-packer --init MyAppName
```

This will produce the deploy directory containing the template. You can modify this to suite your needs. Like add icons, change the name, description and add other native features or dependencies. Make sure you commit this directory.

### Step 2: (_**Run this command every time you want to build a new distributable**_)

Next you can run the pack command:

```sh
npm run build
```

This will produce the js bundle along with assets inside the `./dist` directory

```sh
npx nodegui-packer --pack ./dist
```

This will build the distributable using @nodegui/packer based on your template. The output of the command is found under the build directory. You should gitignore the build directory.

More details about packer can be found here: https://github.com/nodegui/packer

## License

MIT