Niral for VS CodeLanguage support for Niral — the zero-dependency, compiler-first full-stack web framework — and for NiralScript, its independent reactive language. Like the framework it serves, this extension ships zero dependencies: a single
file that speaks LSP to Features
|
| Command | What it does |
|---|---|
| Niral: Restart Language Server | Relaunches niral lsp. |
| Niral: Show Language Server Output | Opens the Niral output channel. |
| Niral: Open Documentation | Opens niral.site. |
A status bar item shows whether the server is running; click it for the log.
Requirements
- Node.js 22+ — Niral is Node standard library, end to end.
- The
niralCLI, which comes with your project:
npx create-niral my-app
cd my-app
niral dev
Open any .niral file and IntelliSense works immediately. The extension finds the
CLI in node_modules, in a sibling checkout, or at the project root. If yours lives
somewhere else, point niral.serverPath at its bin/niral.js.
Highlighting and snippets never depend on the CLI — only diagnostics, completions, hover and Go to Definition do.
Settings
| Setting | Default | Purpose |
|---|---|---|
niral.serverPath |
"" |
Path to bin/niral.js. Empty means auto-detect. |
niral.niralscriptStrictTypes |
false |
Require narrowing unknown and nullable values in standalone .nrs checking, matching nrs check --strict. |
niral.niralscriptGlobals |
[] |
Explicit host globals for standalone .nrs checking — the same contract as nrs --global. |
niral.showStatusBar |
true |
Show the status bar item for Niral files. |
Standalone NiralScript has no implicit host globals; add names to
niral.niralscriptGlobals only when your host actually supplies them.
Notes and limits
- Hover reports declared annotations and signatures, not general inferred types.
- Symbol navigation needs a parseable program. An unfinished receiver such as
counter.still recovers member completions; otherwise you get keyword completions. - Completions cover top-level names rather than every local lexical scope.
- NiralScript imports must be explicit relative
.nrspaths to existing, non-private files inside the project, without symlinks. - The language server runs your project's own
niralCLI, so it stays off until the workspace is trusted.
Great with AI agents
Every Niral project scaffolds an AGENTS.md, so GitHub Copilot, Claude and Cursor
follow the framework's conventions instead of guessing. New projects recommend this
extension through .vscode/extensions.json, and agents can verify their own edits
with niral check (the real TypeScript compiler) and niral test.
Links
- Docs — https://niral.site
- GitHub — https://github.com/Zyora-Dev/niral
- Issues — https://github.com/Zyora-Dev/niral/issues
- Changelog — CHANGELOG.md
Built by ZyoraLabs. The framework is MIT; the NiralScript compiler is Apache-2.0 with a Runtime Library Exception. Zero dependencies, forever.