add open webpage flag, add open docs

packages/nuekit/src/cli-help.js

@@ -1,4 +1,4 @@
-import { colors, openUrl, version } from './util.js'
+import { colors, version } from './util.js'
 
 const HELP = `
 Usage
@@ -11,6 +11,7 @@ Commands
   build    Build the site under <root_dir>
   create   Use a project starter template
   init     Re-generate /@nue system files
+  docs     Open Nue's docs
 
 Options
   -r or --root          Source directory. Default "." (current working dir)
@@ -19,7 +20,8 @@ Options
   -n or --dry-run       Show what would be built. Does not create outputs
   -b or --esbuild       Use esbuild as JS bundler. Please install it manually
   -l or --lcss          Use lightningcss as CSS bundler. Please install it manually
-  -P or --port          Port to serve the site on
+  -P or --port          Serves the site on the specified port
+  -o or --open          Opens the local site in the browser
 
 File matches
   Only build files that match the rest of the arguments. For example:
@@ -39,15 +41,15 @@ Examples
   nue build .md .css
 
   # more examples
-  https://nuejs.org/docs/command-line-interface.html
+  Visit https://nuejs.org/docs/command-line-interface.html
 
  ┏━┓┏┓┏┳━━┓
  ┃┏┓┫┃┃┃┃━┫  ${version}
  ┃┃┃┃┗┛┃┃━┫  nuejs.org
  ┗┛┗┻━━┻━━┛
 `
 
-const commands = ['serve', 'build', 'init', 'create']
+const commands = ['serve', 'build', 'init', 'create', 'docs']
 
 function formatLine(line) {
   const { gray, magenta, cyan, green } = colors

packages/nuekit/src/cli.js

@@ -4,7 +4,7 @@ import { sep } from 'node:path'
 
 import esMain from 'es-main'
 
-import { log, colors, version, getEngine } from './util.js'
+import { log, colors, version, getEngine, openUrl } from './util.js'
 
 
 // [-npe] --> [-n, -p, -e]
@@ -22,7 +22,7 @@ export function expandArgs(args) {
 
 // TODO: tests
 export function getArgs(argv) {
-  const commands = ['serve', 'build', 'init', 'create']
+  const commands = ['serve', 'build', 'init', 'create', 'docs']
   const args = { paths: [], root: null }
   const checkExecutable = /[\\\/]nue(\.(cmd|ps1|bunx|exe))?$/
   let opt
@@ -52,6 +52,7 @@ export function getArgs(argv) {
       else if (['-l', '--lcss'].includes(arg)) args.lcss = true
       else if (['-d', '--deploy'].includes(arg)) args.deploy = args.is_prod = true
       else if (['-I', '--incremental'].includes(arg)) args.incremental = true
+      else if (['-o', '--open'].includes(arg)) args.open = true
 
       // string values
       else if (['-e', '--environment'].includes(arg)) opt = 'env'
@@ -87,6 +88,8 @@ async function printVersion() {
 }
 
 async function runCommand(args) {
+  if (args.cmd == 'docs') return openUrl('https://nuejs.org/docs/')
+
   const { createKit } = await import('./nuekit.js')
   const { cmd = 'serve', dryrun, deploy, root = null, port } = args
   const init = cmd == 'init'
@@ -105,6 +108,7 @@ async function runCommand(args) {
 
   const nue = await createKit(args)
   if (!nue) return
+  if (args.open) openUrl(`http://localhost:${nue.port}/`)
 
   // deployer (private repo)
   const { deploy: deployer } = deploy ? await import('nue-deployer') : {}