@formstork/vue

Vue composable for Formstork. Your forms, delivered.

Turn any form into a working contact form with one composable. No server, no backend code.

npm install @formstork/vue

Usage

<script setup>
import { useFormstork } from "@formstork/vue";

const { submit, isSubmitting, isSuccess, message } = useFormstork({
  accessKey: "YOUR_ACCESS_KEY", // get one at https://app.formstork.com
});
</script>

<template>
  <p v-if="isSuccess">Thanks, {{ message }}</p>
  <form v-else @submit="submit">
    <input type="text" name="name" required />
    <input type="email" name="email" required />
    <textarea name="message" required></textarea>
    <button :disabled="isSubmitting">
      {{ isSubmitting ? "Sending..." : "Send" }}
    </button>
  </form>
</template>

API

useFormstork({ accessKey, endpoint?, onSuccess?, onError? }) returns refs:

| Field | Type | Description | |---|---|---| | submit | (e) => Promise | submit handler, collects form fields automatically | | send | (payload) => Promise | Programmatic submit | | reset | () => void | Reset back to idle | | state | Ref<"idle" \| "submitting" \| "success" \| "error"> | Current state | | message | Ref<string \| null> | Server or error message | | isSubmitting / isSuccess / isError | ComputedRef<boolean> | Convenience flags |

Also exports submitToFormstork(accessKey, payload, endpoint?) for non-Vue use.

MIT · formstork.com