Skip to content
Switch branches/tags
Go to file

GitHub license GitHub (pre-)release GitHub last commit HitCount Twitter OpenCollective Support us

Neutralino is a lightweight and portable application development framework. It lets you develop cross-platform applications using JavaScript/TypeScript, HTML and CSS.

Neutralinojs vs Electron vs NW.js

Get started with CLI.

 $ npm i -g @neutralinojs/neu
 $ neu create hello-world

Why Neutralinojs?

In Electron and NWjs, you have to install NodeJs and hundreds of dependency libraries. Embedded Chromium and Node creates large overhead and makes even simple apps like “hello world” considerable in size. Neutralino offers a lightweight and portable SDK which is an alternative for Electron and NW.js also with many advantages.

Ask questions on Stackoverflow using tag neutralinojs

See how it works

How it works?


Help Neutralino!

  • Give us a star
  • Fork and Clone! Awesome
  • Select existing issues or create a new issue and give us a PR with your bugfix or improvement after. We love it ❤️
  • Refer to this guide for Contribution Procedures and Standards.

Neutralinojs cloud

This experimental mode can be used to expose native functions for clients

./neutralino  /dev/null 2>&1 &

Check this article

Realtime Chat Room - Slack

Mailing List - Google Group

  • Join our Google group for feature proposals and requests.
  • You can help us by writing sample Neutralino apps,by composing or improving documentation or by writing code.

Framework Developer Guide

Required tools

To create Neutralino developer environment in your pc, install these tool kits.

Installing latest GNU C/C++ compilers


No need for separate installation of compilers because Linux distributions usually have GNU C/C++ compilers installed already.


Latest versions of GNU C/C++ compilers can be easily installed with MSYS2 tools collection. After a successfull installation you can run the following command on MSYS2 console to install GNU C/C++ compilers (64-bit versions).

 $ pacman -S mingw-w64-x86_64-gcc  

Build Neutralino platform in Windows

> build

Build Neutralino platform in Linux

Install GTk and webkit libraries

On Debian/Ubuntu based OS

If you are using a newer version of Ubuntu, there is no need to run the following commands.

$ sudo apt-get install libgtk-3-dev
$ sudo add-apt-repository ppa:webkit-team/ppa
$ sudo apt-get update
$ sudo apt-get install libwebkit2gtk-4.0-37 libwebkit2gtk-4.0-dev
$ bash linux

Neutralino platform components will be assembled in /dist

Build Neutralino server in Windows

> cd core-windows
> build

Build Neutralino server in Linux

$ cd core-linux
$ bash

Neutralino server will be compiled in /bin

MacOS Build

Neutralino now supports MacOSX

Build Requirenments

  • Xcode Command Line Tools
  • CMake 3.15+
$ bash macos

Debug Builds

Debug builds are unoptimized fat binaries containing debug information. This is the type you should use for any debugging purpose.

  • cd core-macos
  • bash
  • mkdir build
  • cd build
  • cmake ..
  • make -j "$(sysctl -n hw.physicalcpu)"

The resulting binary will be placed in build directory

Release Builds

Release builds are optimized binaries with a very small footprint. Suitable for distributions

  • mkdir release
  • cd release
  • cmake .. -DCMAKE_BUILD_TYPE=Release
  • make -j "$(sysctl -n hw.physicalcpu)"

The resulting binary will be placed in release directory

To install resulting binary to bin directory use

  • make install

Build Neutralino.js with webpack

$ cd neutralino.js
$ npm install
$ npm run build

Become a Backer

If you like to contribute by funding for sustaining our work, Please visit

Become a Patron




Made with contributors-img.