@formbuilder-cloud/create

npm create @formbuilder-cloud starts a formBuilder Cloud project from a template: React, Next.js, Vue, plain HTML or a Node webhook receiver. It copies the template into a new directory and writes .env from the template's .env.example. It installs nothing, makes no network request and sends no telemetry.

Version 0.1.0, not published yet. npm create @formbuilder-cloud works once Kevin publishes this package and the @formbuilder-cloud/adapter and /sdk packages the templates install (RELEASING.md). In this repository, run the built bin directly: npm -w create run build && node create/dist/bin.js my-app --template react.

npm create @formbuilder-cloud@latest my-app -- --template react
cd my-app
# fill in .env: FORMBUILDER_FORM_ID, FORMBUILDER_COLLECTION_KEY (README.md, "Environment")
npm install
npm run dev

npm runs this package's create-formbuilder-cloud bin, so npx @formbuilder-cloud/create my-app --template react does the same. With npm, options go after --.

| Template | What | |---|---| | react | React (Vite) with the adapter | | nextjs | Next.js (App Router) with the SDK and the adapter | | vue | Vue 3 (Vite) with the adapter | | html | Plain HTML with the embed script (a tiny Node server) | | node-webhook | Node webhook receiver (signature verification, no dependencies) |

Each template is a copy of examples/<name> in the formbuilder-cloud repository, taken when this package is built. Each runs with only FORMBUILDER_* variables; examples/README.md has the full table.

Options

create-formbuilder-cloud [directory] [--template <name>]
  -t, --template <name>  the template (asked for when omitted in a terminal)
      --list             print the template names, one per line
  -h, --help             the usage
  -v, --version          the version

• directory defaults to formbuilder-cloud-<template>. It must not exist, or be empty. The new package.json is named after it.
• Without --template, it asks in a terminal. Without a terminal (CI, an agent), it exits 2 with the usage and creates nothing.
• Exit codes: 0 done, 1 refused (the directory is not empty), 2 usage (an unknown template or option).
• .env is written with mode 0600, and each template's .gitignore excludes it.

Licence

UNLICENSED: proprietary. Copyright (c) 2026 Kevin Chappell, all rights reserved. You may use it only with the formBuilder Cloud service and under that service's terms (LICENSE). Each template's README.md carries its notice into the project it creates: Copyright (c) 2026 Kevin Chappell. All rights reserved. You may copy and modify the example/template code in this directory into your own applications that use the formBuilder Cloud service (decision-register item 39, option C). The templates install jQuery and formRender from npm, and those keep their own MIT licences.