# neutralinojs
**Repository Path**: zmwcodediy/neutralinojs
## Basic Information
- **Project Name**: neutralinojs
- **Description**: neutralinojs
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-07-26
- **Last Updated**: 2024-06-07
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
[](https://github.com/neutralinojs/neutralinojs/releases)
[](https://github.com/neutralinojs/neutralinojs/commits/master)
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fneutralinojs%2Fneutralinojs?ref=badge_shield)
[](https://twitter.com/intent/tweet?text=NeutralinoJs%20is%20a%20portable%20and%20lightweight%20framework%20which%20lets%20you%20to%20develop%20apps%20with%20native%20functions%20that%20can%20run%20inside%20web%20browsers.%20Check%20it%20out:&url=https%3A%2F%2Fgithub.com%2Fneutralinojs%2Fneutralinojs)
[](#backers)
Neutralinojs is a lightweight and portable desktop application development framework. It lets you develop lightweight cross-platform desktop applications using JavaScript, HTML and CSS. Apps built with Neutralinojs can run on Linux, macOS, Windows, and Web.
- [Neutralinojs vs Electron vs NW.js](https://github.com/neutralinojs/evaluation)
- [Roadmap for 2021](https://github.com/neutralinojs/roadmap#roadmapplan-2021)
Get started with the neu CLI.
```bash
# Creating a new app
$ npm i -g @neutralinojs/neu
$ neu create hello-world
$ cd hello-world
$ neu run
# Building your app
$ neu build
```
This documentation is for contributors. If you would like to learn Neutralinojs application development, please check [this](https://neutralino.js.org/docs) documentation.
## Why Neutralinojs?
In Electron and NWjs, you have to install NodeJs and hundreds of dependency libraries. Embedded Chromium and Node make simple apps bloaty. Neutralinojs offers a lightweight and portable SDK which is an alternative for Electron and NW.js. Neutralinojs implements a RESTful API for native operations, and it embeds a static web server to serve the web content. Also, it offers a built-in [JavaScript client library](https://github.com/neutralinojs/neutralino.js) for developers.
Ask questions on StackOverflow using tag [neutralinojs](https://stackoverflow.com/questions/tagged/neutralinojs)
## Contribution
- Select existing [issues](https://github.com/neutralinojs/neutralinojs/issues) or create a [new issue](https://github.com/neutralinojs/neutralinojs/issues/new). Send us a pull request with your code changes. We are happy to review it ❤️
- Refer to [this guide](https://github.com/neutralinojs/neutralinojs/blob/master/CONTRIBUTING.md) for contribution guidelines.
### Collaboration and communication
- We use Slack for quick discussions. [get your invite](https://join.slack.com/t/neutralinojs/shared_invite/zt-b7mbivj5-pKpO6U5drmeT68vKD_pc6w)
- Join our [Google group](https://groups.google.com/forum/#!forum/neutralinojs) for feature proposals and long discussions.
## Framework Developer Guide
### Setup and compilation
**Linux**
No need for separate compilers because Linux distributions usually have GNU C/C++ compilers installed already.
Install GTk and webkit libraries
**Ubuntu**
If you are using a newer version of Ubuntu, some libraries may be pre-installed.
```bash
$ sudo apt-get install \
libgtk-3-dev \
libwebkit2gtk-4.0-37 \
libwebkit2gtk-4.0-dev \
libappindicator3-dev
```
**Fedora**
```bash
$ sudo dnf install \
@development-tools \
libappindicator-gtk3.x86_64 \
gtk3 \
webkit2gtk3.x86_64 \
webkit2gtk3-devel.x86_64
```
Compiling Neutralino server on Linux
```bash
$ bash build_linux.sh
```
**Windows**
Install the latest Visual Studio IDE. Neutralinojs compilation on Windows will use MSVC (aka `cl.exe`) C++ compiler.
Compiling Neutralino server on Windows
```bash
$ ./build_windows.bat
```
**macOS**
Install Xcode Command Line Tools.
Compiling Neutralino server on MacOS
```bash
$ bash build_macos.sh
```
## Sponsors and Donators
Organizations and individuals support Neutralinojs. See: https://codezri.org/sponsors
If you like to support our work, you can donate to Neutralinojs via [Patreon](https://www.patreon.com/shalithasuranga).
[](https://www.patreon.com/shalithasuranga)
## Licenses and Copyrights
- Neutralinojs core: MIT. Copyright (c) 2021 Neutralinojs and contributors.
- HTTP server library: MIT from [yhirose/cpp-httplib](https://github.com/yhirose/cpp-httplib). Copyright (c) 2017 Yuji Hirose.
- JSON parser library: MIT from [nlohmann/json](https://github.com/nlohmann/json). Copyright (c) 2013-2021 Niels Lohmann.
- Cross-platform webview library: MIT from [webview/webview](https://github.com/webview/webview). Copyright (c) 2017 Serge Zaitsev.
- Cross-platform tray library: MIT from [zserge/tray](https://github.com/zserge/tray). Copyright (c) 2017 Serge Zaitsev.
- Cross-platform message box library: MIT from [aaronmjacobs/Boxer](https://github.com/aaronmjacobs/Boxer). Copyright (c) 2014 Aaron Jacobs.
- Logo design credits: [IconsPng](https://www.iconspng.com/image/2688/atom-orange). Copyright free as mentioned in their website.
Please check all licenses from [this](LICENSE) link.
[](https://app.fossa.com/projects/git%2Bgithub.com%2Fneutralinojs%2Fneutralinojs?ref=badge_large)
## Contributors
The above image was generated with [contributors-img](https://contributors-img.firebaseapp.com).