exeup v0.0.4

Exeup

Exeup: Pack up and bundle your Node.js project into a single .exe file for easy distribution and hassle-free execution on Windows!

📌 Table of Contents

• Installation
• Usage
  • Using the CLI
  • Using the npm Package
• Configuration (CLI Only)
• Options
• License

🚀 Installation

Install as a CLI Tool

To install Exeup globally, run:

npm install -g exeup

Install as a Developer Dependency

To use Exeup within a Node.js project:

npm install -D exeup

🔧 Usage

Using the CLI

Once installed, you can use the exeup command to package your Node.js project into an executable file.

Initialize Configuration

Before building, configure Exeup by running:

exeup config

This will prompt you for essential configuration details, such as the entry file, output path, version, and execution level.

Build an Executable

To create an executable from your project:

exeup build

Check Version

To check the installed version of Exeup:

exeup version

View Help

For a list of available commands:

exeup help

Using the npm Package

Exeup can be used programmatically within your Node.js project.

Example Usage

const exeup = require('exeup');

const options = {
    entry: './index.js',
    out: './build/myapp.exe',
    version: '1.0.0',
    icon: './assets/icon.ico',
    skipBundle: false,
    executionLevel: 'asInvoker',
    properties: {
        FileDescription: 'My Application',
        ProductName: 'MyApp',
        LegalCopyright: 'My Company',
        OriginalFilename: 'myapp.exe',
    }
};

exeup(options, (progressData) => {
    console.log(`${progressData.progress}% - ${progressData.message}`);
    if (progressData.done) {
        console.log('Executable successfully created!');
    }
}).catch(console.error);

⚙️ Configuration (CLI Only)

The CLI tool relies on a configuration file (exeup.config.json). You can generate this file using:

exeup config

Example exeup.config.json:

{
    "entry": "./index.js",
    "out": "./build/myapp.exe",
    "version": "1.0.0",
    "icon": "./assets/icon.ico",
    "skipBundle": false,
    "executionLevel": "asInvoker",
    "properties": {
        "FileDescription": "My Application",
        "ProductName": "MyApp",
        "LegalCopyright": "My Company",
        "OriginalFilename": "myapp.exe"
    }
}

⚡ Options

📜 License

Exeup is licensed under the MIT License. See the LICENSE file for more details.

📂 Source Code

Find the source code on GitHub: Sectly/Exeup