neutralinojs/neutralinojs-cli

neu cli for Neutralinojs

The official CLI of Neutralinojs. See neu CLI documentation for more details. Release notes are available at this page.

npm i -g @neutralinojs/neu

Requirements

• Node.js v14 or later version.
• npm, yarn, or any Node.js package manager.

License

MIT

Contributing to Neutralinojs

We really appreciate your code contributions. Please read this contribution guide before sending a pull request. Thank you for your contributions.

⚠️ Notice for contributors

Please note that we would like to keep this project's dependencies list minimal as possible. Make sure that you don't add new dependencies (external npm modules) with your pull requests. Also, don't use latest Node/JavaScript features that won't work on older Node.js versions. Thank you 🎉

Contributors

Made with contributors-img.

neutralinojs-cli's Issues

Release latest version supporting neu listen along with v1.7.0 framework

Rename njs binaries with neu create command

Use app folder name

Download client js also from releases

Display client version in `neu version` command

neu release

Release app
For now the idea is to make a zip file

For future

--winsetup to create windows setup using https://www.npmjs.com/package/innosetup-compiler maybe

Add developer guide to README

React Typescript Template

I have been trying to figure out how to setup a React-Typescript project today. I thought opening this issue may bring the point up and maybe something like --template ts-react may be added. I'm not sure how problematic that'd be but for someone like me who creates projects very often for various work-related stuff, having this shorthand would be invaluable and time-saving.

CLI should warn about wrong param

For mistake, I run this command:

neu create-app myapp

The CLI didn't warn about my mistake.

Add option --auto-build to listen command

If this option is used. any change to the src directory will build and reload the app automatically.

Update njs release url

Terminate the listen process on window close

It would be great if the cli process detects window close and terminates the cli process.

Expected Behavior
Detect window close and terminate the running cli neu listen process.

Actual Behavior
Need to manually terminate the neu listen process.

Specifications

• NeutralinoJs Version: v1.5
• NeutralinoJs CLI version: 2.3.1
• Platform: macOS Catalina v10.15.7

Clean binaries from all templates and download with neu created command

Debug mode on server side (CLI) ?

I think a debug mode on the command line is needed to debug errors which are not related to the JS scripts (i.e. which are not "client-side"), but to anything else: e.g. : Configuration scripts (json files), for instance to avoid.

For instance : a typo in config.json will make the executable fail silently (at least on Windows 10).

it could be passed as an option to the executable, lilke neutralino-win.exe --debug, for instance.

That's what a regular server does by default (Express, for instance).

Add kotlin template support

Display logs with neu run

Packager like electron-builder

Is there any ongoing work towards a packager that bundles the executable and the source code into a single file?

Remove callbacks and refactor with async/await

Update client library with `neu update`

storage folder should be copied from dev path to dist on build process

Discussed in neutralinojs/neutralinojs#544

^{Originally posted by rince1984 August 5, 2021}
Actually after build process (CLI: neu build) the storage folder does not exist in the dist folder.
It would be nice if the storage folder would be created automatically through build process (in the dist folder). Much better would be a copy of the existing storage folder from app path itself. So I could store default values in it before build process. In that case the storage folder would only be copied if it exists in the app path (development path).

How I came to this:
I have an app where I need to store global settings in the storage. On app start I check the storage for a setting. If the storage entry is set to true I will display a modal window on app start. That works great in development. But after run the CLI build process neu build the .storage folder does not exist and I get an error.

`neu build` should create a `dist` directory

This CLI is not good. I had to download directly from /releases.

IMO, CLI should hide the implementation, and do not pre-generate too many files. neu build (and neu dev) instead, should generate needed files.

However, I made a set of scripts in https://github.com/patarapolw/neutralino-vue/tree/master/packages/app that can serve as a guideline for better CLI.

neu version

Add a neu version command that only print the currently installed version of Neutralino.

ERROR: template AngularJs

Don't import package.json file into my folder application

$path\template-angular>neu build
npm ERR! code ENOENT
npm ERR! syscall open
npm ERR! path $path\template-angular\package.json
npm ERR! errno -4058
npm ERR! enoent ENOENT: no such file or directory, open '$path\template-angular\package.json'
npm ERR! enoent This is related to npm not being able to find a file.
npm ERR! enoent

Building for Linux and Windows for Distribution

Just found this project. Looks very promising being a slimmed down SDK for apps.

I do have a couple of question, I've got it to work fine locally, but for apps that I would like to distribute, when doing the build process. Is there anyway that I could have the target result be an AppImage for Linux and a binary archive or single portable exe file for Windows builds?

The other question, since I work off Linux (and my typical Linux Electron dev is in a VM), is it possible to build for Windows on Linux? If so, do we need WINE or will the CLI be able to handle things without WINE?

Thanks for the help and keep up with the project. I've been a fan of Electron, but having an alternative be less resource intensive would be great.

Add CLI plugin support

• neu add <plugin-npm-package>
• Search for plugins and register
• Once plugin is linked. developers will be able to add custom commands to neu-cli

use cases

Able to create some tools like https://github.com/jiahaog/nativefier
Eg:- neu nativefy <url> will generate something similar to above solution

Run basic setup on win64 don't start

Expected Behavior
Run basic setup on win64

Actual Behavior
Don't works

Steps to Reproduce the Problem

1. npm install -g @neutralinojs/neu
2. neu create myapp
3. cd myapp
4. neu run

Specifications

• NeutralinoJs Version: last
• NeutralinoJs CLI version: last
• Platform: win10 64

Improve config file handling

• Show a friendly message when project-related commands are executed globally.
• Do refactorings to make code better

A Vue-cli plugin ?

Hi,
Nice job.
Do you plan to easily use neutralinojs with vue and vue cli ?
Actually we use VueJs, and Vue Cli, but folder structure not working with your.

A vue cli plugin would be a good starting point to increase adoption of neutralinojs in vue world.
https://cli.vuejs.org/dev-guide/plugin-dev.html

Something like electron builder plugin :
https://nklayman.github.io/vue-cli-plugin-electron-builder/

Add contributors profile images same as neutralinojs main repo

Download template zip . git clone is too slow

Error when building js template out-of-the-box

Steps to reproduce:
enter following commands into command-line:
neu create hello_world_app --template js
cd hello_world_app && neu build
run neutralino-win.exe

Am I missing something here? I did install the npm dependencies and built the project again yielding the same result.

However replacing the index.html, app.css and app.js files inside /app with the code shown at https://neutralino.js.org/docs/#/gettingstarted solves the problem

Implement neu listen

neu listen will check for changes and automatically execute neu build

Implement neu update

EACCES permission denied, syscall: copyfile when "neu build --release"

Greetings neutralinojs team

This problem is most likely entirely my fault, however I'd like another pair of eyes on it.

I have a working desktop application as the screenshot shows:

However, the issue occurs upon executing the CLI command:

neu build --release

I receive the below EACCES permission denied error:

I cannot seem to copy over the Linux binaries..

A temp folder is created that is an exact copy of the /frontend/ folder.

You can also see in the folder directory that I am not using the /resources/ folder, and have instead created my own /frontend/ folder.

I will also include an image of my config file:

I cannot seem to fix this issue, another opinion on the subject would be of great help to me.

neu run

execute correct binary according to the platform

Support new log file format when coloring

File watcher: watch only project files (ignore node_modules etc)

neu run is missing permissions for binary first time

Use latest binaries

Weird MacOS binary behavior

Expected Behavior
When running neu build --release and copying the dist folder to a mac machine, I expect to be able to run the app as is

Actual Behavior
The binary opens with Text Editor. To get it to run, you have to run the following command through the terminal chmod +x appnamehere

Along with this, opening the binary also opens a terminal window that stays open, even after the app is closed. I had another mac user confirm this behavior and they've been able to replicate it

Steps to Reproduce the Problem

1. Create a new neutralinojs app
2. Run neu build --release
3. Copy the dist folder to a mac machine
4. Try to open the mac binary. It should open with text editor
5. Run command chmod +x binaryname from a terminal inside the dist folder
6. The app now runs, but opens a terminal window that stays open after closing the app

Specifications

• NeutralinoJs Version: Built from Master branch, but has been present in 2.x
• NeutralinoJs CLI version: 4.0.0
• Platform: MacOS Big Sur 11.4

Add a template for js with webpack

Extend `neu version` to display current project's module versions

ERROR: 'neu listen' EADDRINUSE: address already in use :::8080

When trying to run neu listen I get an error:

Error: listen EADDRINUSE: address already in use :::8080

I require that port for another application. Is it possible to change the port being used?

App icon will not be packed with release

Set appname and title based on user input

These files: app/settings.json, app/settings-browser.json, app/settings-cloud.json are using "my app" as appname and title.

Shouln't better if we use the name we included in neu create command?

Avoid calling npm install with neu create

"EACCES: permission denied" received when building "Getting Started" app

• I am starting out with neutralino to see if I like it. I have a fresh install of neutralino 2.3.0 (yarn global add @neutralinojs/neu) on macOS 10.15.7

• neu create firstneuapp worked as described in the "Getting Started". So did cd firstneuapp && neu run

• I then entered neu build --release and got this error:

Error: EACCES: permission denied, copyfile 'bin/neutralino-mac' -> 'dist/firstneuapp/firstneuapp-mac'

Expected Behavior
I had expected to build the binaries without error

Actual Behavior
The full output from the build step is below. Linux & Win10 binaries seem to be present (although I have not tested them). No macOS binary.

Steps to Reproduce the Problem

1. See description above
2. Note the permissions on the neutralino-mac file in the ./bin directory

Specifications

• NeutralinoJs Version: [Version number of NeutralinoJs framework] 2.3.0
• NeutralinoJs CLI version: [neu-cli version] 5.0.0
• Platform: [Platform specifications] macOS 10.15.7

Full error log

?130 firstneuapp % neu build --release
Bundling app...
Generating res.neu...
Copying binaries...
Error: EACCES: permission denied, copyfile 'bin/neutralino-mac' -> 'dist/firstneuapp/firstneuapp-mac'
    at Object.copyFileSync (fs.js:1941:3)
    at copyFile (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:67:6)
    at onFile (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:53:25)
    at getStats (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:48:44)
    at startCopy (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:38:10)
    at handleFilterAndCopy (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:33:10)
    at Object.copySync (/Users/richb/.config/yarn/global/node_modules/fs-extra/lib/copy-sync/copy-sync.js:26:10)
    at Object.module.exports.bundleApp (/Users/richb/.config/yarn/global/node_modules/@neutralinojs/neu/src/modules/bundler.js:34:13)
    at processTicksAndRejections (internal/process/task_queues.js:93:5)
    at async Command.<anonymous> (/Users/richb/.config/yarn/global/node_modules/@neutralinojs/neu/src/commands/build.js:11:13) {
  errno: -13,
  syscall: 'copyfile',
  code: 'EACCES',
  path: 'bin/neutralino-mac',
  dest: 'dist/firstneuapp/firstneuapp-mac'
}
  _   _            _             _ _             _
 | \ | | ___ _   _| |_ _ __ __ _| (_)_ __   ___ (_)___
 |  \| |/ _ \ | | | __| '__/ _` | | | '_ \ / _ \| / __|
 | |\  |  __/ |_| | |_| | | (_| | | | | | | (_) | \__ \
 |_| \_|\___|\__,_|\__|_|  \__,_|_|_|_| |_|\___// |___/
                                              |__/
Please check the ./dist directory!

√ firstneuapp % ll
total 32
drwxr-xr-x   11 richb  staff   352B Jun 19 07:33 .
drwxr-xr-x  307 richb  staff   9.6K Jun 19 07:28 ..
-rw-r--r--    1 richb  staff   137B Jun 19 07:28 .gitignore
-rw-r--r--    1 richb  staff   1.1K Jun 19 07:28 LICENSE
-rw-r--r--    1 richb  staff   379B Jun 19 07:28 README.md
drwxr-xr-x    6 richb  staff   192B Jun 19 07:28 bin
drwxr-xr-x    3 richb  staff    96B Jun 19 07:33 dist
-rw-r--r--    1 richb  staff   785B Jun 19 07:28 neutralino.config.json
-rw-r--r--    1 richb  staff     0B Jun 19 07:29 neutralinojs.log
drwxr-xr-x    6 richb  staff   192B Jun 19 07:28 resources
drwxr-xr-x    4 richb  staff   128B Jun 19 07:33 temp

√ firstneuapp % ll dist
total 0
drwxr-xr-x   3 richb  staff    96B Jun 19 07:33 .
drwxr-xr-x  11 richb  staff   352B Jun 19 07:33 ..
drwxr-xr-x   5 richb  staff   160B Jun 19 07:33 firstneuapp

√ firstneuapp % ll dist/firstneuapp
total 9736
drwxr-xr-x  5 richb  staff   160B Jun 19 07:33 .
drwxr-xr-x  3 richb  staff    96B Jun 19 07:33 ..
-rw-r--r--  1 richb  staff   3.2M Jun 19 07:33 firstneuapp-linux
-rw-r--r--  1 richb  staff   1.5M Jun 19 07:33 firstneuapp-win.exe
-rw-r--r--  1 richb  staff    28K Jun 19 07:33 res.neu

?130 firstneuapp % ll bin
total 12456
drwxr-xr-x   6 richb  staff   192B Jun 19 07:28 .
drwxr-xr-x  11 richb  staff   352B Jun 19 07:33 ..
-rw-r--r--   1 richb  staff   418K Jun 19 07:28 WebView2Loader.dll
-rw-r--r--   1 richb  staff   3.2M Jun 19 07:28 neutralino-linux
--wxrw--wt   1 richb  staff   968K Jun 19 07:28 neutralino-mac
-rw-r--r--   1 richb  staff   1.5M Jun 19 07:28 neutralino-win.exe

?1 firstneuapp % neu version
  _   _            _             _ _             _
 | \ | | ___ _   _| |_ _ __ __ _| (_)_ __   ___ (_)___
 |  \| |/ _ \ | | | __| '__/ _` | | | '_ \ / _ \| / __|
 | |\  |  __/ |_| | |_| | | (_| | | | | | | (_) | \__ \
 |_| \_|\___|\__,_|\__|_|  \__,_|_|_|_| |_|\___// |___/
                                              |__/
--- Global ---
Neutralinojs binaries: v2.3.0
neu CLI: v5.0.0

--- Project: firstneuapp (js.neutralino.sample) ---
Neutralinojs binaries: v2.3.0
√ firstneuapp %

neu patch

Patch /dist/index.html with Neutralino JavaScript files and binaries.

My plan is to run these concurrently

• vue-cli-service build --watch
• neu patch && neu run

Remove neutralinojs-cli-appify in package.json

Remove `neu listen` and add auto-reload to `neu run`

ES6 module template

As of now, only a "minimal" template can be generated, which consists of a var library from https://github.com/neutralinojs/neutralino.jshttps://github.com/neutralinojs/neutralino.js generated by webpack hosted on
https://github.com/neutralinojs/neutralinojs-minimal.

A "module" template can be created from the same source by editing the webpack config, and hosted as "neutralinojs-module". This template will allow selective imports from the Neutrino API instead of loading the entire library through a <script> tag.

If these changes are approved, I'll make a PR.