Repository files navigation

Javascript's God Mode: one language to rule them all.

Code everything, everywhere, for everything, in JavaScript.

No VM. No Bytecode. No packaging. No Garbage Collector. Fully compiled to native binaries.

• About NectarJS

• • Main objectives
• • Changelog
• • Sponsors
• • Contributors

• Get started

• • Installation
• • Usage
• • Advanced usage (platforms, optimization...)

• Benchmarks

• Supported platforms

• Development

• • Contributing
• • Code Of Conduct
• • TODO
• • Stores
• • ECMAScript Support

NectarJS is aJavaScript native compiler aiming to make JavaScript universal, NectarJS is able to compile native apps for Windows, Mac, Linux, iOS, Android, Raspberry, STM32 and more.

NectarJS is in active development, join us onDiscord orIRC if you need more information.

• Roadmap on Trello

• Quick Start

• Quick Hack

• NectarJS Documentation (WIP)

• Supporting EcmaScript 3 standard (then 5, 6 ...)
• Supporting NodeJS and NPM ecosystem
• Supporting a maximum of platforms (Windows, Mac, Linux, Android, Arduino, ...)
• Being secure
• Embeding debuging tools
• Compile everything that can be transpiled in JS: Ruby (Opal), Python (Transcript, Brython, JavaScrypthon), TypeScript ...

npm install -g nectarjs

• WindowsInstall Mingw and Clang for Windows here:http://winlibs.com/ or Clang here:https://releases.llvm.org/

You can also install Linux for Windows and use a linux system on Windows

You need MinGW with POSIX threads

• Linux / FreeBSDInstall it with your distro (apt install gcc, yum install gcc, ...).You can use GCC, CLANG, as well as any derivative of those compilers (arm-gcc ...)

• Apple iOSInstall xCode and you are ready.

You can check your installation withnpm start njs_test

Simplest way to use NectarJS:

nectar file.js

The output file name will be automatically chosen regarding the target. You can specify another output with-o something.out

You can select a preset (seeAdvanced usage):

nectar file.js --preset [none|speed|size]

You can also run the compiled executable just after compilation using --run:

nectar file.js --run

You can enable the quiet mode with --quiet:

nectar file.js --quiet

Changing the stack size (usefull on Windows):

nectar --stack 10000000 flood.js

You can install a module with:

nectar -i module_name

You can see the module list and participate in their development here:https://github.com/NectarJS/nectar_modules

You can initialize an empty module with the command:

nectar --init-module module_name --author me

For more informations about compilation output, use--verbose

For help, use--help

Compiled with GCC v10.2.0 on Windows

• Some code can be evaluated compile-time

Actively tested for

• Windows

• • win-x86-32
• • win-x86-64

• Linux

• • linux-x86-32
• • linux-x86-64
• • linux-arm32v7

• Arduino

• • arduino-nano
• • arduino-uno
• • arduino-mega1280
• • arduino-mega2560

• STM32 Nucleo

• • nucleo-l152re
• • nucleo-l432kc
• • nucleo-f446re

• Mobile

• • android

• Web

• • wasm
• • wast
• • asm-js

• macOS
• Sun OS

This project is in heavy development and a lot features are not implemented yet.

NectarJS compiled apps are tested to be publishable on:

• Apple Store

• • https://apps.apple.com/fr/app/hiphen-plant/id1523867733

NectarJS already supports more than 80% of ES3.