NoJS CLI

Official CLI for the No.JS framework

Scaffold projects, optimize HTML for production, run a dev server with live reload, validate templates, and manage plugins — all from the command line.

---

Install

npm install -g @erickxavier/nojs-cli

Requires Node.js >= 18.

---

Commands

Command	Alias	Description
nojs init [path]	i	Scaffold a new No.JS project with optional routing, i18n, and API base
nojs prebuild [dir]	b	Build-time HTML optimization (resource hints, speculation rules, sitemap, OG tags, image optimization)
nojs dev [path]	d	Local dev server with live reload (SSE), SPA fallback, colored request logging
nojs validate [files]	v	Validate No.JS templates against 10 rules (CI-friendly JSON output)
nojs plugin <action>	p	Manage plugins — search, install, update, remove, list
nojs help		Show help
nojs version		Show version

---

Quick Start

# Create a new project
nojs init my-app
cd my-app

# Start the dev server
nojs dev

# Validate your templates
nojs validate *.html

# Optimize for production
nojs prebuild

---

Init

Interactive wizard that generates a ready-to-go No.JS project:

nojs init ./my-app

Non-interactive mode:

nojs init ./my-app --routing --i18n --locales en,pt --api https://api.example.com --yes

Generates index.html, route pages (.tpl), i18n locale files, and a nojs.config.json.

---

Dev Server

nojs dev              # serve current directory
nojs dev ./docs/      # serve a specific path
nojs dev --port 8080  # custom port
nojs dev --open       # open browser on start
nojs dev --quiet      # suppress request logging
nojs dev --no-reload  # disable live reload

Features: live reload via SSE, SPA fallback (serves index.html for unmatched routes), MIME type detection, path traversal protection.

---

Prebuild

Build-time HTML optimization pipeline with 6 plugins:

nojs prebuild            # process current directory
nojs prebuild ./dist/    # process a specific path

Plugin	What it does
inject-resource-hints	Preload, prefetch, preconnect for get= and route templates
inject-head-attrs	Static page-title, page-description, page-canonical, page-jsonld
inject-speculation-rules	Speculation Rules API from <template route> definitions
inject-og-twitter	Open Graph and Twitter Card meta tags from page-* directives
generate-sitemap	sitemap.xml from route definitions and canonical URLs
optimize-images	Lazy loading, LCP preload, fetchpriority hints

---

Validate

nojs validate *.html
nojs validate src/ --format json   # JSON output for CI

Rules: missing as on fetch, each without in, foreach without from, model on non-form elements, bind-html warning, routes without route-view, empty event handlers, loops without key, duplicate store names, validate outside <form>.

---

Plugin Manager

Hybrid plugin manager — CDN for official plugins, npm for community packages:

nojs plugin search analytics
nojs plugin install @nojs/analytics
nojs plugin list
nojs plugin update @nojs/analytics
nojs plugin remove @nojs/analytics

CDN plugins get SRI integrity hashes (sha384) computed automatically.

---

Project Structure

src/
├── cli.js              # CLI entry point — argument parsing, command routing
├── commands/           # Top-level command handlers
├── init/               # Project scaffolding templates and wizard
├── prebuild/           # HTML optimization plugins
├── dev/                # Dev server (HTTP + SSE live reload)
├── validate/           # Template validation rules
└── plugin/             # Plugin manager (CDN + npm)

__tests__/              # Jest unit tests
bin/
└── nojs.js             # Executable entry point

---

Ecosystem

Tool	Description
No.JS	The HTML-first reactive framework
NoJS-LSP	VS Code extension — autocomplete, hover docs, diagnostics
NoJS-MCP	MCP server — AI tools for building No.JS apps
NoJS-Skill	AI agent skill — context-aware assistance for No.JS projects
NoJS-CLI	This package

---

Contributing

Contributions are welcome! Please read the Contributing Guide and our Code of Conduct before submitting a PR.

• Changelog

License

MIT

---

NoJS CLI — The command-line companion for No.JS
MIT License