stacks 0.53.1 → 0.56.3

package/core/buddy/README.md

@@ -8,7 +8,7 @@
 [![npm downloads][npm-downloads-src]][npm-downloads-href]
 <!-- [![Codecov][codecov-src]][codecov-href] -->
 
-_Pre-release until public beta released. Coming May/June._
+_Beta coming soon._
 
 The goal of the framework is to _help you_ create & maintain frontends, backends, and clouds—without having to worry about the boilerplate. Stacks is a rapid application development framework, meeting all your full stack needs.
 
@@ -72,7 +72,7 @@ _Create your personal or professional Vercel-like cloud, based on MIT-licensed O
 - ⛅️ **Serverless** _on-demand, auto-scaling, zero maintenance_
 - 🚏 **CDN** _zero-config low-latency CDN, including request life-cycle hooks & optimized request compressions (Brotli & gzip)_
 - 🔀 **Domain** _version-controlled & zero-config domain management (e.g. DNS)_
-- 📧 **Email** _secure & simplistic <easy-peasy@custom-domains.com> mail_
+- 📧 **Email** _secure & simplistic easy-peasy@custom-domains.com mail_
 - 🔐 **Firewall** _native web application firewall support_
 - 🚜 **Maintenance** _handles your cloud infrastructure via the Stacks & Serverless framework_
 - 🤖 **Infrastructure as Code** _create & maintain your cloud infrastructure with ease_
@@ -94,7 +94,7 @@ _Enhanced productivity for developers. No more creating boilerplate._
 - 💪🏼 **Type Strong** _built-in e2e type-safety_
 - ✨ **Git Workflows** _committing with ease_
 - 🚗 **Auto Imports** _your components & functions, including date, string, array, & object helpers_
-- ⏩ **Code Snippets** _say goodbye to the boilerplate—thank you [Sarah Drasner](https://github.com/sdras/vue-vscode-snippets)_
+- ⏩ **Code Snippets** _say goodbye to the boilerplate—thank you Sarah Drasner_
 - 🔤 **Spell Checker** _be notified once there are typos_
 - 🛠️ **Utilities** _Collections, VueUse, and more_
 - 🧪 **Testing** _unit & e2e tests powered by Vitest & Playwright_
@@ -110,27 +110,24 @@ Develop beautiful, reactive, composable UIs without learning a new set of langua
 It's incredibly easy to get started with this framework. Simply run the following command in your terminal:
 
 ```bash
-sh <(curl stacksjs.dev)
+sh <(curl stacksjs.dev) my-project
 
-# alternatively, if Node.js >= v18.12 is installed already,
+# alternatively, if Node.js >= v18.16 is installed already,
 # you may also get started via:
 npx stacks new my-project
 ```
 
-> **Note**
-> pnpm 8 required. _Run the setup script & 🐶 Buddy will set you up. He barks otherwise._
-
 ## 🤖 Usage
 
 The following list includes some of the most common ways to interact with the Stacks API. Meet the toolkit, Buddy:
 
 ```bash
 buddy install # installs all dependencies
-buddy dev # starts one of the dev servers (components, functions, pages, or docs)
+buddy dev # starts one of the dev servers (components, functions, views, or docs)
 buddy build # follow CLI prompts to select which library (or server) to build
 buddy commit # follow CLI prompts for committing changes
 buddy release # creates the releases for the stack & consequently, publishes them to npm
-buddy upgrade # auto-update deps & the Stacks framework
+buddy upgrade # auto-update all deps & the Stacks framework
 
 buddy make:component HelloWorld # scaffolds a component
 buddy make:function HelloWorld # scaffolds a function
@@ -148,69 +145,76 @@ buddy --help # view help menu
 # please note: you may suffix any command with the
 # `command --help` flag to review the help menu
 
-buddy install # installs your dependencies
+buddy install # installs dependencies
+buddy add # adds a stack or dependency
 buddy fresh # fresh reinstall of all deps
-buddy clean # removes all your deps
+buddy clean # removes all deps
 
-buddy update # auto-update deps & the Stacks framework
-buddy update:dependencies # auto-update deps & the Stacks framework
-buddy update:framework # auto-update deps & the Stacks framework
-buddy update:package-manager # auto-update deps & the Stacks framework
-buddy update:search-engine # auto-updates Meilisearch
-buddy update:node # update to latest project-defined node version
-buddy update:all # update Node, package manager, framework, dependencies
+buddy upgrade # auto-upgrades deps, framework, node.js, and/or pnpm
+buddy upgrade:dependencies # auto-upgrades deps & the Stacks framework
+buddy upgrade:framework # auto-upgrades deps & the Stacks framework
+buddy upgrade:package-manager # auto-upgrades deps & the Stacks framework
+buddy upgrade:search-engine # auto-upgrades configured search engine
+buddy upgrade:node # upgrades to latest project-defined node version
+buddy upgrade:all # upgrades Node, package manager, framework, dependencies
 
 # if you need any more info on any command listed here, you may suffix
 # any of them via the "help option", i.e. `buddy ... --help`
 
-buddy dev # start one of the dev servers (components, functions, pages, or docs)
-buddy dev:components # start local playground dev server
+buddy dev # starts one of the dev servers (components, functions, views, or docs)
+buddy dev:components # starts local playground dev server
 buddy dev:desktop # starts the Desktop playground
-buddy dev:pages # start local playground pages dev server
-buddy dev:functions # stub local the functions
-buddy dev:docs # start local docs dev server
+buddy dev:views # starts local playground views dev server
+buddy dev:functions # stubs local the functions
+buddy dev:docs # starts local docs dev server
 buddy development # `buddy dev` alias
 
 # for Laravel folks, `serve` may ring more familiar than the `dev` name. Hence, we aliased it:
 buddy serve
 buddy serve:components
-buddy serve:pages
+buddy serve:desktop
+buddy serve:views
 buddy serve:functions
 buddy serve:docs
 
 # building for production (e.g. AWS, Google Cloud, npm, Vercel, Netlify, et al.)
 buddy build # select a specific build (follow CLI prompts)
-buddy build:components # build Vue component library & Web Component library
-buddy build:vue-components # build Vue 2 & 3-ready Component library
-buddy build:web-components # build framework agnostic Web Component library (i.e. Custom Elements)
-buddy build:functions # build function library
-buddy build:pages # build SSG pages
-buddy build:all # build all your code
+buddy build:views # builds SSG views
+buddy build:desktop # builds Desktop application
+buddy build:library # builds any or all libraries
+buddy build:functions # builds function library
+buddy build:components # builds Vue component library & Web Component library
+buddy build:web-components # builds framework agnostic Web Component library (i.e. Custom Elements)
+buddy build:vue-components # builds Vue 2 & 3-ready Component library
+buddy build:all # builds all your code
 
 # `buddy build` aliases
 buddy prod
 buddy prod:components
+buddy prod:desktop
+buddy prod:library
+buddy prod:views
+buddy prod:functions
 buddy prod:vue-components
 buddy prod:web-components
-buddy prod:functions
-buddy prod:pages
 buddy prod:all
 buddy production # `buddy prod` alias
 
 # sets your application key
 buddy key:generate
 
-buddy make:stack project
-buddy make:component HelloWorld
-buddy make:function hello-world
-buddy make:page hello-world
-buddy make:lang de
-buddy make:notification welcome-email
-buddy make:database cars
-buddy make:table brands
-buddy make:migration create_cars_table
-buddy make:factory cars
-buddy make:seed cars
+buddy make:component HelloWorld # bootstraps a HelloWorld component
+buddy make:function hello-world # bootstraps a hello-world function
+buddy make:page hello-world # bootstraps a hello-word page
+buddy make:model Car # bootstraps a Car model
+buddy make:database cars # creates a cars database
+buddy make:migration create_cars_table # creates a cars migration file
+buddy make:factory cars # creates a Car factory file
+buddy make:seed cars # creates a Car seed file
+buddy make:table cars # boostraps a cars data table
+buddy make:notification welcome-email # bootstraps a welcome-email notification
+buddy make:lang de # bootstraps a lang/de.yml language file
+buddy make:stack my-project # shares logic with `npx stacks new my-project`
 
 buddy lint # runs linter
 buddy lint:fix # runs linter and fixes issues
@@ -220,33 +224,33 @@ buddy release # creates the releases for the stack & triggers the Release Action
 buddy changelog # generates CHANGELOG.md
 
 # when deploying your app/s to a remote server or cloud provider
-buddy deploy
-buddy deploy:docs
-buddy deploy:functions
-buddy deploy:pages
-buddy deploy:all
+buddy deploy # select a specific deployment (follow CLI prompts)
+buddy deploy:docs # deploys docs to AWS (or other configured provider)
+buddy deploy:functions # deploys functions to AWS (or other configured provider)
+buddy deploy:views # deploys views to AWS (or other configured provider)
+buddy deploy:all # deploys all your code
 
 # select the example to run (follow CLI prompts)
-buddy example
-buddy example:vue
-buddy example:web-components
+buddy example # prompts you to select which example to run
+buddy example:vue # runs the Vue example
+buddy example:web-components # runs the Web Component example
 
 # you likely won't need to run these commands as they are auto-triggered, but they are available
-buddy generate
-buddy generate:entries
-buddy generate:vue-compat
-buddy generate:web-types
-buddy generate:vscode-custom-data
-buddy generate:ide-helpers
-buddy generate:component-meta
-buddy generate:all
+buddy generate  # prompts you to select which generator to run
+buddy generate:entries # generates entry files for components, functions, & views
+buddy generate:vue-compat # generates Vue 2 compatibility layer
+buddy generate:web-types # generates Web Component types
+buddy generate:vscode-custom-data # generates VSCode custom data
+buddy generate:ide-helpers # generates IDE helpers
+buddy generate:component-meta # generates component meta
+buddy generate:all # runs all generators
 
 # generates your application key
-buddy key:generate
+buddy key:generate # generates your application key
 
 # generate your TypeScript declarations
-buddy types:generate
-buddy types:fix
+buddy types:generate # generates types for your components, functions, & views
+buddy types:fix # auto-fixes types for your components, functions, & views
 
 # test your stack
 buddy test # runs test suite (unit & e2e)
@@ -259,12 +263,6 @@ stx fresh
 buddy fresh
 bud fresh
 buddy fresh
-pnpm stx fresh
-pnpm buddy fresh
-pnpm buddy fresh
-pnpm fresh
-pnpm run fresh
-pnpm run buddy fresh
 ```
 
 </details>
@@ -275,7 +273,7 @@ Read more here about the Stacks CLI in the documentation.
 
 Because Stacks optimizes the development of easily reusable & composable component & function libraries, the primary intention is to always _keep it simple, yet configurable._
 
-By default, Stacks realizes whether your Stack includes components, functions, and/or pages. Based on that determination, Stacks builds your outputs.
+By default, Stacks realizes whether your Stack includes components, functions, and/or views. Based on that determination, Stacks builds your outputs.
 
 The UI libraries that automatically get built are: a Web Component (Custom Elements) & Vue Component library.
 
@@ -347,7 +345,7 @@ You may view this framework as an incredibly “useful set of frames” to assis
 
 Part of the Stacks ecosystem are the following first-party supported stacks:
 
-- [Table](https://github.com/stacksjs/table) (Data tables with ease)
+- [Table](https://github.com/stacksjs/stacks/tree/main/.stacks/stacks/tables) (Data tables with ease)
 - [Calendar](https://github.com/stacksjs/calendar) (Add to Calendar utilities—iCal, Google, and more)
 - [Command Palette](https://github.com/stacksjs/command-palette) (`⌘ + k` for the web)
 - [Date Picker](https://github.com/stacksjs/date-picker) (Beautiful, modern date picker)
@@ -355,11 +353,10 @@ Part of the Stacks ecosystem are the following first-party supported stacks:
 - [Image](https://github.com/stacksjs/image) (Modern image experience)
 - [Video](https://github.com/stacksjs/video) (Modern video experience)
 - [Audio](https://github.com/stacksjs/audio) (Modern audio experience)
-- [Web3](https://github.com/stacksjs/web3) (Solana support, cross-chain core. _Ethereum & Cardano drivers coming._)
-  - [Wallets](https://github.com/stacksjs/wallets) (Wallet Authentication)
-  - [NFT](https://github.com/stacksjs/nft) (NFTs, Candy Machine mechanisms, and more.)
-  - [DeFi](https://github.com/stacksjs/defi) (Cross-chain DeFi engine, including staking support)
-  - [DAO](https://github.com/stacksjs/dao) (Powerful toolkit for DAO governance, including a Reddit-type of voting system)
+- [Identity](https://github.com/stacksjs/identity) (Identity providers & wallet integrations)
+- [Digital Ownership](https://github.com/stacksjs/ownership) (Public ownership protocol integrations)
+- [Payments](https://github.com/stacksjs/payments) (Unified payment APIs)
+- [Governance](https://github.com/stacksjs/governance) (Powerful toolkit for democratic governance)
 
 View our detailed roadmap/s [here](https://github.com/stacksjs/stacks/projects?query=is%3Aopen), for more information. Additionally, you may find interesting stacks, information & examples over at [Awesome Stacks](https://github.com/stacksjs/awesome-stacks).
 

package/core/buddy/build.config.ts

@@ -1,5 +1,4 @@
-import { defineBuildConfig } from 'unbuild'
-import { alias } from '@stacksjs/alias'
+import { alias, defineBuildConfig } from '@stacksjs/development'
 
 export default defineBuildConfig({
   alias,

package/core/buddy/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@stacksjs/buddy",
   "type": "module",
-  "version": "0.53.1",
-  "packageManager": "pnpm@8.5.1",
+  "version": "0.56.3",
+  "packageManager": "pnpm@8.6.5",
   "description": "Meet Buddy. The Stacks runtime.",
   "author": "Chris Breuer",
   "license": "MIT",
@@ -66,7 +66,7 @@
     "preinstall": "npx only-allow pnpm",
     "build": "unbuild",
     "dev": "unbuild --stub",
-    "prepublishOnly": "pnpm buddy prepublish",
+    "prepublishOnly": "tsx ./src/cli.ts prepublish",
     "typecheck": "tsc --noEmit"
   },
   "peerDependencies": {
@@ -84,8 +84,8 @@
     "@stacksjs/database": "workspace:*",
     "@stacksjs/desktop": "workspace:*",
     "@stacksjs/development": "workspace:*",
+    "@stacksjs/dns": "workspace:*",
     "@stacksjs/docs": "workspace:*",
-    "@stacksjs/domains": "workspace:*",
     "@stacksjs/email": "workspace:*",
     "@stacksjs/error-handling": "workspace:*",
     "@stacksjs/events": "workspace:*",

package/core/buddy/src/cli.ts

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
 import { runAction } from '@stacksjs/actions'
+import { handleError } from '@stacksjs/error-handling'
 import { command, log } from '@stacksjs/cli'
-import { env, frameworkVersion, installIfVersionMismatch, isProjectCreated } from '@stacksjs/utils'
+import { env } from '@stacksjs/validation'
+import { frameworkVersion, installIfVersionMismatch, isProjectCreated } from '@stacksjs/utils'
 import { projectPath } from '@stacksjs/path'
 import { Action } from '@stacksjs/types'
 import { build, changelog, clean, commit, create, dev, example, fresh, generate, key, lint, make, migrate, preinstall, prepublish, release, seed, setup, test, upgrade, version } from './commands'
@@ -9,8 +11,8 @@ import { build, changelog, clean, commit, create, dev, example, fresh, generate,
 const cli = command('buddy')
 
 // setup global error handlers
-process.on('uncaughtException', errorHandler)
-process.on('unhandledRejection', errorHandler)
+process.on('uncaughtException', handleError)
+process.on('unhandledRejection', handleError)
 
 async function main() {
   // the following commands are not dependent on the project being initialized
@@ -20,20 +22,15 @@ async function main() {
 
   // before running any commands, check if the project is already initialized
   if (!await isProjectCreated()) {
-    if (env('APP_ENV') !== 'production') {
+    if (env.APP_ENV !== 'production')
       log.info('Project not yet initialized, generating application key...')
-    }
-    else {
-      log.error('Please run `buddy key:generate` to generate an application key.')
-      process.exit()
-    }
+    else
+      handleError(new Error('Please run `buddy key:generate` to generate an application key'))
 
     const result = await runAction(Action.KeyGenerate, { cwd: projectPath() })
 
-    if (result.isErr()) {
-      log.error(result.error)
-      process.exit()
-    }
+    if (result.isErr())
+      handleError(result.error as Error)
 
     log.info('Application key generated.')
 
@@ -66,8 +63,3 @@ async function main() {
 }
 
 main()
-
-function errorHandler(error: Error): void {
-  log.error(error)
-  process.exit(1)
-}

package/core/buddy/src/commands/add.ts

@@ -1,6 +1,6 @@
 import type { AddOptions, BuildOptions, CLI } from '@stacksjs/types'
 import { ExitCode } from '@stacksjs/types'
-import { prompt } from '@stacksjs/cli'
+import { log } from '@stacksjs/cli'
 import { invoke } from '@stacksjs/actions/add'
 
 async function add(buddy: CLI) {
@@ -21,7 +21,7 @@ async function add(buddy: CLI) {
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompt(descriptions.select, {
+        const answers = await log.prompt(descriptions.select, {
           type: 'multiselect',
           options: [
             { label: 'Calendar', value: 'calendar' },

package/core/buddy/src/commands/build.ts

@@ -1,6 +1,6 @@
 import type { BuildOptions, CLI } from '@stacksjs/types'
 import { Action, ExitCode } from '@stacksjs/types'
-import { intro, outro, prompt } from '@stacksjs/cli'
+import { intro, log, outro, prompt } from '@stacksjs/cli'
 import { runAction } from '@stacksjs/actions'
 
 async function build(buddy: CLI) {
@@ -10,7 +10,7 @@ async function build(buddy: CLI) {
     webComponents: 'Build your framework agnostic web component library',
     elements: 'An alias to the -w flag',
     functions: 'Build your function library',
-    pages: 'Build your SSG pages',
+    pages: 'Build your SSG views',
     docs: 'Build your documentation site',
     stacks: 'Build Stacks framework',
     select: 'What are you trying to build?',
@@ -24,29 +24,36 @@ async function build(buddy: CLI) {
     .option('-w, --web-components', descriptions.webComponents) // these are automatically built with your -c option as well
     .option('-e, --elements', descriptions.elements)
     .option('-f, --functions', descriptions.functions)
-    .option('-p, --pages', descriptions.pages)
+    .option('-p, --views', descriptions.pages)
     .option('-d, --docs', descriptions.docs)
     .option('-s, --stacks', descriptions.stacks, { default: false })
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: BuildOptions) => {
       if (hasNoOptions(options)) {
-        const answers = await prompt(descriptions.select, {
-          type: 'multiselect',
-          required: true,
-          options: [
-            { label: 'Components', value: 'components' },
-            // { label: 'Vue Components', value: 'vue-components' },
-            // { label: 'Web Components', value: 'web-components' },
-            { label: 'Functions', value: 'functions' },
-            { label: 'Pages', value: 'pages' },
-            { label: 'Documentation', value: 'docs' },
-          ],
-        })
+        let answers = await prompt.require()
+          .multiselect(descriptions.select, {
+            options: [
+              { label: 'Components', value: 'components' },
+              // { label: 'Vue Components', value: 'vue-components' },
+              // { label: 'Web Components', value: 'web-components' },
+              { label: 'Functions', value: 'functions' },
+              { label: 'Pages', value: 'pages' },
+              { label: 'Documentation', value: 'docs' },
+            ],
+          })
+
+        if (answers !== null)
+          process.exit(ExitCode.InvalidArgument)
+
+        if (isString(answers))
+          answers = [answers]
 
         // creates an object out of array and sets answers to true
         options = answers.reduce((a: any, v: any) => ({ ...a, [v]: true }), {})
       }
 
+      console.log('options', options)
+
       await runAction(Action.BuildStacks, options)
 
       process.exit(ExitCode.Success)
@@ -111,7 +118,7 @@ async function build(buddy: CLI) {
       const result = await runAction(Action.BuildCore, options)
 
       if (result.isErr()) {
-        log.error('Failed to build the Stacks core.', result.error as Error)
+        log.error('Failed to build the Stacks core.', result.error)
         process.exit()
       }
 

package/core/buddy/src/commands/create.ts

@@ -13,7 +13,7 @@ async function create(buddy: CLI) {
     components: 'Are you building UI components?',
     webComponents: 'Automagically built optimized custom elements/web components?',
     vue: 'Automagically built a Vue component library?',
-    pages: 'How about pages?',
+    pages: 'How about views/views?',
     functions: 'Are you developing functions/composables?',
     api: 'Are you building an API?',
     database: 'Do you need a database?',
@@ -26,7 +26,7 @@ async function create(buddy: CLI) {
     .option('-c, --components', descriptions.components, { default: true }) // if no, -v and -w would be false
     .option('-w, --web-components', descriptions.webComponents, { default: true })
     .option('-v, --vue', descriptions.vue, { default: true })
-    .option('-p, --pages', descriptions.pages, { default: true }) // pages need an HTTP server
+    .option('-p, --views', descriptions.pages, { default: true }) // views need an HTTP server
     .option('-f, --functions', descriptions.functions, { default: true }) // if no, API would be false
     .option('-a, --api', descriptions.api, { default: true }) // APIs need an HTTP server & assumes functions is true
     .option('-d, --database', descriptions.database, { default: true })

package/core/buddy/src/commands/dev.ts

@@ -4,7 +4,7 @@ import type { CLI, DevOptions } from '@stacksjs/types'
 import { intro, log, outro, prompt } from '@stacksjs/cli'
 import { components, desktop, functions, pages } from '@stacksjs/actions/dev'
 
-// import { components, desktop, functions, pages, invoke as startDevelopmentServer } from '@stacksjs/actions/dev'
+// import { components, desktop, functions, views, invoke as startDevelopmentServer } from '@stacksjs/actions/dev'
 
 async function dev(buddy: CLI) {
   const descriptions = {
@@ -22,24 +22,25 @@ async function dev(buddy: CLI) {
     .option('-c, --components', descriptions.components)
     .option('-f, --functions', descriptions.functions)
     .option('-d, --docs', descriptions.docs)
-    .option('-p, --pages', descriptions.pages)
+    .option('-p, --views', descriptions.pages)
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: DevOptions) => {
+      // const perf = await intro('buddy dev')
+      // const result = await runAction(Action.Dev, { ...options, verbose: true })
+
       if (hasNoOptions(options)) {
-        const answer = await prompt(descriptions.select, {
-          type: 'select',
-          required: true,
-          options: [
-            { value: 'pages', label: 'Pages' },
-            { value: 'desktop', label: 'Desktop' },
-            { value: 'components', label: 'Components' },
-            { value: 'functions', label: 'Functions' },
-            { value: 'docs', label: 'Documentation' },
-          ],
-        })
-
-        if (answer !== null)
-          process.exit(ExitCode.InvalidArgument)
+        const answer = await prompt.require()
+          .select(descriptions.select, {
+            options: [
+              { value: 'all', label: 'All' },
+              { value: 'pages', label: 'Frontend' },
+              { value: 'api', label: 'Backend' },
+              { value: 'desktop', label: 'Desktop' },
+              { value: 'components', label: 'Components' },
+              { value: 'functions', label: 'Functions' },
+              { value: 'docs', label: 'Documentation' },
+            ],
+          })
 
         if (answer === 'components')
           await components(options)
@@ -48,12 +49,21 @@ async function dev(buddy: CLI) {
         else if (answer === 'pages')
           await pages(options)
         // else if (answer === 'docs')
-          // await docs(options)
+        //   await docs(options)
 
         else process.exit(ExitCode.InvalidArgument)
       }
-
+      else {
+        if (options.components)
+          await components(options)
+        else if (options.functions)
+          await functions(options)
+        else if (options.pages)
+          await pages(options)
+        // else if (options.docs)
+      }
       // await startDevelopmentServer(options)
+
       process.exit(ExitCode.Success)
     })
 
@@ -64,19 +74,10 @@ async function dev(buddy: CLI) {
       const result = await runAction(Action.DevComponents, { ...options, verbose: true })
 
       if (options.verbose)
-        log.info('The result object is', result)
-
-      // check if result is an array
-      if (Array.isArray(result)) {
-        // check if any of the items in the array is an error
-        // if (result.some(item => item.isErr())) {
-        //   outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true })
-        //   process.exit()
-        // }
-      }
+        log.info('runAction result is', result)
 
       // check if result is an error
-      else if (result.isErr()) {
+      if (result.isErr()) {
         outro('While running the dev:components command, there was an issue', { startTime: perf, useSeconds: true, isError: true }, result.error ?? undefined)
         process.exit()
       }
@@ -127,7 +128,7 @@ async function dev(buddy: CLI) {
     })
 
   buddy
-    .command('dev:pages', descriptions.pages)
+    .command('dev:views', descriptions.pages)
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: DevOptions) => {
       await pages(options)

package/core/buddy/src/commands/example.ts

@@ -1,6 +1,6 @@
 import { ExitCode } from '@stacksjs/types'
 import type { CLI, ExamplesOptions } from '@stacksjs/types'
-import { italic, log, prompt } from '@stacksjs/cli'
+import { prompt } from '@stacksjs/cli'
 import { componentExample, invoke as runExample, webComponentExample } from '@stacksjs/actions/examples'
 
 async function example(buddy: CLI) {
@@ -20,19 +20,13 @@ async function example(buddy: CLI) {
     .option('-w, --web-components', descriptions.webComponents)
     .option('--verbose', descriptions.verbose, { default: false })
     .action(async (options: ExamplesOptions) => {
-      const answer = await prompt(descriptions.select, {
-        type: 'select',
-        required: true,
-        options: [
-          { value: 'components', label: 'Vue Components' },
-          { value: 'web-components', label: 'Web Components' },
-        ],
-      })
-
-      if (answer !== null) {
-        log.error(`You did not provide an answer. Please try again, ${italic('or report the issue')}`)
-        process.exit()
-      }
+      const answer = await prompt.require()
+        .select(descriptions.select, {
+          options: [
+            { value: 'components', label: 'Vue Components' },
+            { value: 'web-components', label: 'Web Components' },
+          ],
+        })
 
       if (answer === 'components')
         await componentExample(options)