@buildnbuzz/buzzform 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Parth Lad / BuildnBuzz
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,138 @@
+# BuzzForm
+
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)
+
+A schema-driven form library for React + shadcn/ui. Declare fields once, get validated forms with minimal boilerplate.
+
+## Features
+
+- 🎯 **Schema-Driven** – Define fields as data, render forms automatically
+- 🧩 **17+ Field Types** – Text, password, select, date, upload, arrays, tabs, and more
+- ⚡ **Auto Validation** – Generates Zod schemas from your field definitions
+- 🎨 **shadcn/ui Native** – Beautiful, accessible components out of the box
+- 🔌 **Adapter Pattern** – Built for React Hook Form, extensible to others
+- 📦 **Registry Ready** – Install components individually via shadcn CLI
+
+## Installation
+
+```bash
+# Install the core package
+npm install @buildnbuzz/buzzform
+
+# Install peer dependencies
+npm install react-hook-form zod
+
+# Install components via shadcn registry
+npx shadcn@latest add https://form.buildnbuzz.com/r/starter
+```
+
+## Quick Start
+
+```tsx
+import { createSchema, type InferSchema } from "@buildnbuzz/buzzform";
+import { Form } from "@/components/buzzform/form";
+
+const schema = createSchema([
+  { type: "text", name: "name", label: "Name", required: true },
+  { type: "email", name: "email", label: "Email", required: true },
+  { type: "password", name: "password", label: "Password", minLength: 8 },
+]);
+
+type FormData = InferSchema<typeof schema>;
+
+export function LoginForm() {
+  const handleSubmit = async (data: FormData) => {
+    console.log(data);
+  };
+
+  return <Form schema={schema} onSubmit={handleSubmit} submitLabel="Sign In" />;
+}
+```
+
+## Field Types
+
+### Data Fields
+
+| Type       | Description                                              |
+| ---------- | -------------------------------------------------------- |
+| `text`     | Single-line text input                                   |
+| `email`    | Email input with validation                              |
+| `password` | Password with strength indicator, requirements, generate |
+| `textarea` | Multi-line text with auto-resize                         |
+| `number`   | Numeric input with steppers, formatting                  |
+| `date`     | Date picker with presets                                 |
+| `datetime` | Date + time picker                                       |
+| `select`   | Dropdown with search, multi-select, async options        |
+| `checkbox` | Boolean checkbox                                         |
+| `switch`   | Toggle switch                                            |
+| `radio`    | Radio button group with card variant                     |
+| `tags`     | Tag/chip input                                           |
+| `upload`   | File upload with drag-drop, previews                     |
+
+### Layout Fields
+
+| Type          | Description                              |
+| ------------- | ---------------------------------------- |
+| `row`         | Horizontal field layout                  |
+| `group`       | Named object container                   |
+| `collapsible` | Expandable section                       |
+| `tabs`        | Tabbed interface                         |
+| `array`       | Repeatable fields with drag-drop sorting |
+
+## Advanced Usage
+
+### Conditional Fields
+
+```tsx
+const fields: Field[] = [
+  { type: "checkbox", name: "hasCompany", label: "I represent a company" },
+  {
+    type: "text",
+    name: "companyName",
+    label: "Company Name",
+    condition: (data) => data.hasCompany === true,
+  },
+];
+```
+
+### Dynamic Options
+
+```tsx
+const fields: Field[] = [
+  { type: "select", name: "country", label: "Country", options: countries },
+  {
+    type: "select",
+    name: "city",
+    label: "City",
+    dependencies: ["country"],
+    options: async ({ data }) => {
+      const cities = await fetchCities(data.country);
+      return cities;
+    },
+  },
+];
+```
+
+### Custom Validation
+
+```tsx
+const fields: Field[] = [
+  {
+    type: "text",
+    name: "username",
+    label: "Username",
+    validate: async (value, { data }) => {
+      const available = await checkUsername(value);
+      return available || "Username is taken";
+    },
+  },
+];
+```
+
+## Documentation
+
+Full documentation and examples: **[form.buildnbuzz.com](https://form.buildnbuzz.com)**
+
+## License
+
+MIT © [Parth Lad / BuildnBuzz](https://buildnbuzz.com)