Getting Started

NAIDE is a programming language that transpiles to Node.js. It is designed for AI-speed code generation: one way to write everything, keyword-driven intent, and minimal token count.

Installation

Install the CLI globally via npm:

npm install -g naider

This gives you the naide command. Verify it works:

naide --version

Create a Project

Scaffold a new NAIDE project with init:

naide init my-app
cd my-app
npm install
npm run dev

This creates a project directory with a starter .naide file and package.json.

Your First App

Create a file called app.naide:

# app.naide
server app port 3000:
  get "/":
    ret {message: "Hello from NAIDE"}

  get "/greet/:name" (req, res):
    ret {hello: req.params.name}

Run it:

naide app.naide

Your server is now running at http://localhost:3000. Visit /greet/world to see {"hello":"world"}.

See the Output

To see what JavaScript NAIDE generates without running it:

naide --emit app.naide

To write the JavaScript to a file:

naide -o app.mjs app.naide

Watch Mode

Auto-restart on file changes during development:

naide -w app.naide

Build a Project

Transpile all .naide and .nx files to JavaScript:

naide build

Output goes to dist/ by default. You can specify source and output directories:

naide build src/ dist/

Editor Support

Install the VS Code extension with one command:

naide vscode

This provides syntax highlighting, LSP diagnostics, autocomplete, and hover docs for .naide and .nx files. Restart VS Code after installation.

For other editors, start the Language Server:

naide lsp

REPL

Start an interactive session to experiment with NAIDE syntax:

$ naide
NAIDE REPL v1.10.0 -- type NAIDE code, see JavaScript output
Type .exit to quit, .eval to toggle eval mode

>>> str name = "hello"
const name = "hello";

>>> fn add(int a, int b) -> int:
...   ret a + b
...
function add(a, b) {
  return a + b;
}

Type .eval to switch to evaluation mode, which runs the code instead of showing the JavaScript output.

Deploy

Generate Docker deployment files:

naide deploy

Then build and run the container:

docker build -t my-naide-app .
docker run -p 3000:3000 my-naide-app

Next Steps

← Home