@springmicro/cli 0.2.0-alpha.3 → 0.2.1

package/README.md

@@ -12,6 +12,11 @@ Command line utilities for SpringMicroHost.
 * [Commands](#commands)
 * [Development](#development)
 <!-- tocstop -->
+* [@springmicro/cli](#springmicrocli)
+* [Usage](#usage)
+* [Commands](#commands)
+* [Development](#development)
+<!-- tocstop -->
 
 - [@springmicro/cli](#springmicrocli)
 - [Usage](#usage)
@@ -26,13 +31,25 @@ $ npm install -g @springmicro/cli
 $ springmicro COMMAND
 running command...
 $ springmicro (--version)
-@springmicro/cli/0.2.0-alpha.3 win32-x64 node-v20.15.0
+@springmicro/cli/0.2.1 win32-x64 node-v20.15.0
 $ springmicro --help [COMMAND]
 USAGE
   $ springmicro COMMAND
 ...
 ```
 <!-- usagestop -->
+```sh-session
+$ npm install -g @springmicro/cli
+$ springmicro COMMAND
+running command...
+$ springmicro (--version)
+@springmicro/cli/0.2.0-alpha.3 win32-x64 node-v20.15.0
+$ springmicro --help [COMMAND]
+USAGE
+  $ springmicro COMMAND
+...
+```
+<!-- usagestop -->
 
 ```sh-session
 $ npm install -g @springmicro/cli
@@ -52,6 +69,7 @@ USAGE
 
 <!-- commands -->
 * [`springmicro add auth`](#springmicro-add-auth)
+* [`springmicro add form`](#springmicro-add-form)
 * [`springmicro help [COMMAND]`](#springmicro-help-command)
 * [`springmicro init PROJECTTYPE`](#springmicro-init-projecttype)
 * [`springmicro init astro`](#springmicro-init-astro)
@@ -81,7 +99,27 @@ EXAMPLES
   $ springmicro add auth
 ```
 
-_See code: [src/commands/add/auth.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/add/auth.ts)_
+_See code: [src/commands/add/auth.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.1/src/commands/add/auth.ts)_
+
+## `springmicro add form`
+
+add a form to your project
+
+```
+USAGE
+  $ springmicro add form [-t <value>]
+
+FLAGS
+  -t, --template=<value>  form template (contact|quote)
+
+DESCRIPTION
+  add a form to your project
+
+EXAMPLES
+  $ springmicro add form
+```
+
+_See code: [src/commands/add/form.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.1/src/commands/add/form.ts)_
 
 ## `springmicro help [COMMAND]`
 
@@ -101,7 +139,7 @@ DESCRIPTION
   Display help for springmicro.
 ```
 
-_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.5/src/commands/help.ts)_
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.7/src/commands/help.ts)_
 
 ## `springmicro init PROJECTTYPE`
 
@@ -124,7 +162,7 @@ EXAMPLES
   $ springmicro init astro -n example
 ```
 
-_See code: [src/commands/init/index.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/init/index.ts)_
+_See code: [src/commands/init/index.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.1/src/commands/init/index.ts)_
 
 ## `springmicro init astro`
 
@@ -144,7 +182,7 @@ EXAMPLES
   $ springmicro init astro -n <project-name>
 ```
 
-_See code: [src/commands/init/astro.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/init/astro.ts)_
+_See code: [src/commands/init/astro.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.1/src/commands/init/astro.ts)_
 
 ## `springmicro plugins`
 
@@ -167,7 +205,7 @@ EXAMPLES
   $ springmicro plugins
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/index.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/index.ts)_
 
 ## `springmicro plugins add PLUGIN`
 
@@ -241,7 +279,7 @@ EXAMPLES
   $ springmicro plugins inspect myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/inspect.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/inspect.ts)_
 
 ## `springmicro plugins install PLUGIN`
 
@@ -290,7 +328,7 @@ EXAMPLES
     $ springmicro plugins install someuser/someplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/install.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/install.ts)_
 
 ## `springmicro plugins link PATH`
 
@@ -320,7 +358,7 @@ EXAMPLES
   $ springmicro plugins link myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/link.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/link.ts)_
 
 ## `springmicro plugins remove [PLUGIN]`
 
@@ -361,7 +399,7 @@ FLAGS
   --reinstall  Reinstall all plugins after uninstalling.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/reset.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/reset.ts)_
 
 ## `springmicro plugins uninstall [PLUGIN]`
 
@@ -389,7 +427,7 @@ EXAMPLES
   $ springmicro plugins uninstall myplugin
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/uninstall.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/uninstall.ts)_
 
 ## `springmicro plugins unlink [PLUGIN]`
 
@@ -433,7 +471,391 @@ DESCRIPTION
   Update installed plugins.
 ```
 
-_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/update.ts)_
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.9/src/commands/plugins/update.ts)_
+<!-- commandsstop -->
+* [`springmicro add auth`](#springmicro-add-auth)
+* [`springmicro help [COMMAND]`](#springmicro-help-command)
+* [`springmicro init PROJECTTYPE`](#springmicro-init-projecttype)
+* [`springmicro init astro`](#springmicro-init-astro)
+* [`springmicro plugins`](#springmicro-plugins)
+* [`springmicro plugins add PLUGIN`](#springmicro-plugins-add-plugin)
+* [`springmicro plugins:inspect PLUGIN...`](#springmicro-pluginsinspect-plugin)
+* [`springmicro plugins install PLUGIN`](#springmicro-plugins-install-plugin)
+* [`springmicro plugins link PATH`](#springmicro-plugins-link-path)
+* [`springmicro plugins remove [PLUGIN]`](#springmicro-plugins-remove-plugin)
+* [`springmicro plugins reset`](#springmicro-plugins-reset)
+* [`springmicro plugins uninstall [PLUGIN]`](#springmicro-plugins-uninstall-plugin)
+* [`springmicro plugins unlink [PLUGIN]`](#springmicro-plugins-unlink-plugin)
+* [`springmicro plugins update`](#springmicro-plugins-update)
+
+## `springmicro add auth`
+
+describe the command here
+
+```
+USAGE
+  $ springmicro add auth
+
+DESCRIPTION
+  describe the command here
+
+EXAMPLES
+  $ springmicro add auth
+```
+
+_See code: [src/commands/add/auth.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/add/auth.ts)_
+
+## `springmicro help [COMMAND]`
+
+Display help for springmicro.
+
+```
+USAGE
+  $ springmicro help [COMMAND...] [-n]
+
+ARGUMENTS
+  COMMAND...  Command to show help for.
+
+FLAGS
+  -n, --nested-commands  Include all nested commands in the output.
+
+DESCRIPTION
+  Display help for springmicro.
+```
+
+_See code: [@oclif/plugin-help](https://github.com/oclif/plugin-help/blob/v6.2.5/src/commands/help.ts)_
+
+## `springmicro init PROJECTTYPE`
+
+Initialize a JavaScript framework project according to SpringMicroHost's specifications.
+
+```
+USAGE
+  $ springmicro init PROJECTTYPE -n <value>
+
+ARGUMENTS
+  PROJECTTYPE  Project type (astro)
+
+FLAGS
+  -n, --name=<value>  (required) Project name
+
+DESCRIPTION
+  Initialize a JavaScript framework project according to SpringMicroHost's specifications.
+
+EXAMPLES
+  $ springmicro init astro -n example
+```
+
+_See code: [src/commands/init/index.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/init/index.ts)_
+
+## `springmicro init astro`
+
+Initialize a Astro project according to SpringMicroHost's specifications.
+
+```
+USAGE
+  $ springmicro init astro -n <value>
+
+FLAGS
+  -n, --name=<value>  (required) Project name
+
+DESCRIPTION
+  Initialize a Astro project according to SpringMicroHost's specifications.
+
+EXAMPLES
+  $ springmicro init astro -n <project-name>
+```
+
+_See code: [src/commands/init/astro.ts](https://github.com/SpringMicro1/springmicrohost-js/blob/v0.2.0-alpha.3/src/commands/init/astro.ts)_
+
+## `springmicro plugins`
+
+List installed plugins.
+
+```
+USAGE
+  $ springmicro plugins [--json] [--core]
+
+FLAGS
+  --core  Show core plugins.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  List installed plugins.
+
+EXAMPLES
+  $ springmicro plugins
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/index.ts)_
+
+## `springmicro plugins add PLUGIN`
+
+Installs a plugin into springmicro.
+
+```
+USAGE
+  $ springmicro plugins add PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into springmicro.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the SPRINGMICRO_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the SPRINGMICRO_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ springmicro plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ springmicro plugins add myplugin
+
+  Install a plugin from a github url.
+
+    $ springmicro plugins add https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ springmicro plugins add someuser/someplugin
+```
+
+## `springmicro plugins:inspect PLUGIN...`
+
+Displays installation properties of a plugin.
+
+```
+USAGE
+  $ springmicro plugins inspect PLUGIN...
+
+ARGUMENTS
+  PLUGIN...  [default: .] Plugin to inspect.
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Displays installation properties of a plugin.
+
+EXAMPLES
+  $ springmicro plugins inspect myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/inspect.ts)_
+
+## `springmicro plugins install PLUGIN`
+
+Installs a plugin into springmicro.
+
+```
+USAGE
+  $ springmicro plugins install PLUGIN... [--json] [-f] [-h] [-s | -v]
+
+ARGUMENTS
+  PLUGIN...  Plugin to install.
+
+FLAGS
+  -f, --force    Force npm to fetch remote resources even if a local copy exists on disk.
+  -h, --help     Show CLI help.
+  -s, --silent   Silences npm output.
+  -v, --verbose  Show verbose npm output.
+
+GLOBAL FLAGS
+  --json  Format output as json.
+
+DESCRIPTION
+  Installs a plugin into springmicro.
+
+  Uses npm to install plugins.
+
+  Installation of a user-installed plugin will override a core plugin.
+
+  Use the SPRINGMICRO_NPM_LOG_LEVEL environment variable to set the npm loglevel.
+  Use the SPRINGMICRO_NPM_REGISTRY environment variable to set the npm registry.
+
+ALIASES
+  $ springmicro plugins add
+
+EXAMPLES
+  Install a plugin from npm registry.
+
+    $ springmicro plugins install myplugin
+
+  Install a plugin from a github url.
+
+    $ springmicro plugins install https://github.com/someuser/someplugin
+
+  Install a plugin from a github slug.
+
+    $ springmicro plugins install someuser/someplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/install.ts)_
+
+## `springmicro plugins link PATH`
+
+Links a plugin into the CLI for development.
+
+```
+USAGE
+  $ springmicro plugins link PATH [-h] [--install] [-v]
+
+ARGUMENTS
+  PATH  [default: .] path to plugin
+
+FLAGS
+  -h, --help          Show CLI help.
+  -v, --verbose
+      --[no-]install  Install dependencies after linking the plugin.
+
+DESCRIPTION
+  Links a plugin into the CLI for development.
+  Installation of a linked plugin will override a user-installed or core plugin.
+
+  e.g. If you have a user-installed or core plugin that has a 'hello' command, installing a linked plugin with a 'hello'
+  command will override the user-installed or core plugin implementation. This is useful for development work.
+
+
+EXAMPLES
+  $ springmicro plugins link myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/link.ts)_
+
+## `springmicro plugins remove [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ springmicro plugins remove [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ springmicro plugins unlink
+  $ springmicro plugins remove
+
+EXAMPLES
+  $ springmicro plugins remove myplugin
+```
+
+## `springmicro plugins reset`
+
+Remove all user-installed and linked plugins.
+
+```
+USAGE
+  $ springmicro plugins reset [--hard] [--reinstall]
+
+FLAGS
+  --hard       Delete node_modules and package manager related files in addition to uninstalling plugins.
+  --reinstall  Reinstall all plugins after uninstalling.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/reset.ts)_
+
+## `springmicro plugins uninstall [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ springmicro plugins uninstall [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ springmicro plugins unlink
+  $ springmicro plugins remove
+
+EXAMPLES
+  $ springmicro plugins uninstall myplugin
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/uninstall.ts)_
+
+## `springmicro plugins unlink [PLUGIN]`
+
+Removes a plugin from the CLI.
+
+```
+USAGE
+  $ springmicro plugins unlink [PLUGIN...] [-h] [-v]
+
+ARGUMENTS
+  PLUGIN...  plugin to uninstall
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Removes a plugin from the CLI.
+
+ALIASES
+  $ springmicro plugins unlink
+  $ springmicro plugins remove
+
+EXAMPLES
+  $ springmicro plugins unlink myplugin
+```
+
+## `springmicro plugins update`
+
+Update installed plugins.
+
+```
+USAGE
+  $ springmicro plugins update [-h] [-v]
+
+FLAGS
+  -h, --help     Show CLI help.
+  -v, --verbose
+
+DESCRIPTION
+  Update installed plugins.
+```
+
+_See code: [@oclif/plugin-plugins](https://github.com/oclif/plugin-plugins/blob/v5.3.4/src/commands/plugins/update.ts)_
 <!-- commandsstop -->
 
 - [`springmicro help [COMMAND]`](#springmicro-help-command)

package/dist/commands/add/form.d.ts

@@ -0,0 +1,12 @@
+import { Command } from '@oclif/core';
+import forms from '../../data/form/index.js';
+export default class Form extends Command {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        template: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    extractEnvVars(formString: string): string[];
+    writeForm(template: keyof typeof forms): void;
+    run(): Promise<void>;
+}

package/dist/commands/add/form.js

@@ -0,0 +1,51 @@
+import { Command, Flags } from '@oclif/core';
+import forms from '../../data/form/index.js';
+import { checkUnixShellAndSpawn } from '../../utils/shell.js';
+import path from 'node:path';
+import fs from 'node:fs';
+import chalk from 'chalk';
+export default class Form extends Command {
+    // static override args = {
+    //   file: Args.string({description: 'file to read'}),
+    // }
+    static description = 'add a form to your project';
+    static examples = ['<%= config.bin %> <%= command.id %>'];
+    static flags = {
+        // flag with a value (-t, --template=VALUE)
+        template: Flags.string({ char: 't', description: 'form template (contact|quote)' }),
+    };
+    extractEnvVars(formString) {
+        const envVarRegex = /import\.meta\.env\.(\w+)/g;
+        let match;
+        const envVars = [];
+        while ((match = envVarRegex.exec(formString)) !== null) {
+            envVars.push(match[1]);
+        }
+        return envVars;
+    }
+    writeForm(template) {
+        const baseDir = path.posix.join('src', 'components', 'forms');
+        const baseDirApi = path.posix.join('src', 'pages', 'api', 'forms');
+        fs.mkdirSync(baseDir, { recursive: true });
+        fs.mkdirSync(baseDirApi, { recursive: true });
+        const filePath = path.posix.join(baseDir, forms[template].name + '.tsx');
+        fs.writeFileSync(filePath, forms[template].tsx);
+        const filePathApi = path.posix.join(baseDirApi, forms[template].name.toLowerCase() + '.ts');
+        fs.writeFileSync(filePathApi, forms[template].api);
+        this.log('');
+        this.log(chalk.bgCyan.black('FINISHED!'));
+        const envVars = this.extractEnvVars(forms[template].api);
+        if (envVars.length > 0) {
+            this.log('');
+            this.log(chalk.cyan('Make sure to set the following environment variables:'));
+            envVars.forEach((v) => this.log(chalk.cyan(`- ${v}`)));
+        }
+    }
+    async run() {
+        const { args, flags } = await this.parse(Form);
+        const template = flags.template ?? 'contact';
+        if (Object.keys(forms).includes(template)) {
+            await checkUnixShellAndSpawn('sh', [path.posix.join(this.config.root, 'dist', 'scripts', 'forms.sh')], path.join(this.config.root, 'dist', 'scripts', 'forms.bat'), [], () => this.writeForm(template));
+        }
+    }
+}

package/dist/commands/init/astro.js

@@ -47,6 +47,8 @@ export default class Astro extends Command {
         tsConfig['compilerOptions'] = {
             ...tsConfig['compilerOptions'],
             baseUrl: '.',
+            // allow implicit type imports
+            verbatimModuleSyntax: false,
             paths: {
                 '@/*': ['./src/*'],
             },

package/dist/data/form/index.d.ts

@@ -0,0 +1,10 @@
+type FormStrings = {
+    tsx: string;
+    name: string;
+    api: string;
+};
+declare const _default: {
+    contact: FormStrings;
+    quote: FormStrings;
+};
+export default _default;

package/dist/data/form/index.js

@@ -0,0 +1,274 @@
+const contact = {
+    name: 'Contact',
+    tsx: `import { zodResolver } from "@hookform/resolvers/zod";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { Button } from "@/components/ui/button";
+import { toast } from "sonner";
+import {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/components/ui/form";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea"; // Assume you have a Textarea component
+
+const formSchema = z.object({
+  name: z.string().min(1, {
+    message: "Name is required.",
+  }),
+  email: z.string().email({
+    message: "Invalid email address.",
+  }),
+  message: z.string().min(1, {
+    message: "Message is required.",
+  }),
+});
+
+export function ContactForm() {
+  // 1. Define your form.
+  const form = useForm<z.infer<typeof formSchema>>({
+    resolver: zodResolver(formSchema),
+    defaultValues: {
+      name: "",
+      email: "",
+      message: "",
+    },
+  });
+
+  // 2. Define a submit handler.
+  async function onSubmit(values: z.infer<typeof formSchema>) {
+    // Do something with the form values.
+    console.log(values);
+    const res = await fetch("/api/forms/contact", {
+      method: "POST",
+      body: JSON.stringify(values),
+      headers: { "Content-Type": "application/json" },
+    });
+    if (res.ok) {
+      // success toast
+      toast("Form submitted!");
+    } else {
+      // error toast
+      toast("Error submitting form, refresh and try again.");
+    }
+  }
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-8">
+        <FormField
+          control={form.control}
+          name="name"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Name</FormLabel>
+              <FormControl>
+                <Input placeholder="Your Name" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <FormField
+          control={form.control}
+          name="email"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Email</FormLabel>
+              <FormControl>
+                <Input
+                  type="email"
+                  placeholder="your.email@example.com"
+                  {...field}
+                />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <FormField
+          control={form.control}
+          name="message"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Message</FormLabel>
+              <FormControl>
+                <Textarea rows={4} placeholder="Your message" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <Button type="submit">Submit</Button>
+      </form>
+    </Form>
+  );
+}
+
+`,
+    api: `import { emailOnlySGJSON } from "@springmicro/forms";
+import type { APIRoute } from "astro";
+
+export const POST: APIRoute = async ({ params, request }) => {
+  const subject = "Contact Form Submission";
+  const json = await request.json();
+  const to: string[] = [json.email];
+  const cc: string[] = [];
+  const bcc: string[] = [];
+
+  const res = await emailOnlySGJSON(
+    import.meta.env.SENDGRID_API_KEY,
+    subject,
+    json,
+    to,
+    cc,
+    bcc
+  );
+  return res;
+};
+`,
+};
+const quote = {
+    name: 'Quote',
+    tsx: `import { zodResolver } from "@hookform/resolvers/zod";
+import { useForm } from "react-hook-form";
+import { z } from "zod";
+import { Button } from "@/components/ui/button";
+import { toast } from "sonner";
+import {
+  Form,
+  FormControl,
+  FormDescription,
+  FormField,
+  FormItem,
+  FormLabel,
+  FormMessage,
+} from "@/components/ui/form";
+import { Input } from "@/components/ui/input";
+import { Textarea } from "@/components/ui/textarea"; // Assume you have a Textarea component
+
+const formSchema = z.object({
+  name: z.string().min(1, {
+    message: "Name is required.",
+  }),
+  email: z.string().email({
+    message: "Invalid email address.",
+  }),
+  message: z.string().min(1, {
+    message: "Message is required.",
+  }),
+});
+
+export function QuoteForm() {
+  // 1. Define your form.
+  const form = useForm<z.infer<typeof formSchema>>({
+    resolver: zodResolver(formSchema),
+    defaultValues: {
+      name: "",
+      email: "",
+      message: "",
+    },
+  });
+
+  // 2. Define a submit handler.
+  async function onSubmit(values: z.infer<typeof formSchema>) {
+    // Do something with the form values.
+    console.log(values);
+    const res = await fetch("/api/forms/quote", {
+      method: "POST",
+      body: JSON.stringify(values),
+      headers: { "Content-Type": "application/json" },
+    });
+    if (res.ok) {
+      // success toast
+      toast("Form submitted!");
+    } else {
+      // error toast
+      toast("Error submitting form, refresh and try again.");
+    }
+  }
+
+  return (
+    <Form {...form}>
+      <form onSubmit={form.handleSubmit(onSubmit)} className="space-y-8">
+        <FormField
+          control={form.control}
+          name="name"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Name</FormLabel>
+              <FormControl>
+                <Input placeholder="Your Name" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <FormField
+          control={form.control}
+          name="email"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Email</FormLabel>
+              <FormControl>
+                <Input
+                  type="email"
+                  placeholder="your.email@example.com"
+                  {...field}
+                />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <FormField
+          control={form.control}
+          name="message"
+          render={({ field }) => (
+            <FormItem>
+              <FormLabel>Message</FormLabel>
+              <FormControl>
+                <Textarea rows={4} placeholder="Your message" {...field} />
+              </FormControl>
+              <FormMessage />
+            </FormItem>
+          )}
+        />
+        <Button type="submit">Submit</Button>
+      </form>
+    </Form>
+  );
+}
+
+`,
+    api: `import { emailOnlySGJSON } from "@springmicro/forms";
+import type { APIRoute } from "astro";
+
+export const POST: APIRoute = async ({ params, request }) => {
+  const subject = "Request a Quote Submission";
+  const json = await request.json();
+  const to: string[] = [json.email];
+  const cc: string[] = [];
+  const bcc: string[] = [];
+
+  const res = await emailOnlySGJSON(
+    import.meta.env.SENDGRID_API_KEY,
+    subject,
+    json,
+    to,
+    cc,
+    bcc
+  );
+  return res;
+};
+`,
+};
+export default {
+    contact,
+    quote,
+};

package/dist/scripts/forms.bat

@@ -0,0 +1,10 @@
+@echo off
+
+REM Use PowerShell to simulate 'yes no' command and pipe to pnpm
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add form
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add button
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add textarea
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add label
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add input
+powershell -Command "while ($true) { Write-Output 'n' }" | pnpm dlx shadcn-ui@latest add sonner
+pnpm add @springmicro/forms

package/dist/scripts/forms.sh

@@ -0,0 +1,8 @@
+# no to overwriting shadcn components that have already been installed
+yes no | pnpm dlx shadcn-ui@latest add form
+yes no | pnpm dlx shadcn-ui@latest add button
+yes no | pnpm dlx shadcn-ui@latest add textarea
+yes no | pnpm dlx shadcn-ui@latest add label
+yes no | pnpm dlx shadcn-ui@latest add input
+yes no | pnpm dlx shadcn-ui@latest add sonner
+pnpm add @springmicro/forms

package/oclif.manifest.json

@@ -24,6 +24,39 @@
         "auth.js"
       ]
     },
+    "add:form": {
+      "aliases": [],
+      "args": {},
+      "description": "add a form to your project",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>"
+      ],
+      "flags": {
+        "template": {
+          "char": "t",
+          "description": "form template (contact|quote)",
+          "name": "template",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "add:form",
+      "pluginAlias": "@springmicro/cli",
+      "pluginName": "@springmicro/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "add",
+        "form.js"
+      ]
+    },
     "init:astro": {
       "aliases": [],
       "args": {},
@@ -101,5 +134,5 @@
       ]
     }
   },
-  "version": "0.2.0-alpha.3"
+  "version": "0.2.1"
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@springmicro/cli",
   "description": "A new CLI generated with oclif",
-  "version": "0.2.0-alpha.3",
+  "version": "0.2.1",
   "author": "David Buckley",
   "private": false,
   "publishConfig": {
@@ -76,5 +76,5 @@
     "version": "oclif readme && git add README.md"
   },
   "types": "dist/index.d.ts",
-  "gitHead": "0854b518932e657d4c08fb5877c725a9425b36e9"
+  "gitHead": "5060bfe477b5be4d15de32991fb8ebc839143430"
 }