🙋‍♂️ The Tripetto FormBuilder SDK helps building powerful and deeply customizable forms for your application, web app, or website.

👩‍💻 Create and run forms and surveys without depending on external services.

💸 Developing a custom form solution is tedious and expensive. Instead, use Tripetto and save time and money!

🌎 Trusted and used by organizations around the globe, including Fortune 500 companies.

This SDK is the ultimate form solution for everything from basic contact forms to surveys, quizzes and more with intricate flow logic. Whether you're just adding conversational forms to your website or application, or also need visual form-building capabilities inside your app, Tripetto has got you covered! Pick what you need from the SDK with visual form builder, form runners, and countless question types – all with extensive docs. Or take things up a notch by developing your own question types or even form runner UIs.

📦 Boilerplate for creating blocks

Perhaps one of the best things about Tripetto is that you can create your own building blocks (learn more about developing custom blocks here). If you want you can publish your custom block as a package (just like we do with our stock blocks). This boilerplate shows you how to do that.

🧑‍💻 Get started

1. Download or clone the repository to your local machine:

$ git clone https://gitlab.com/tripetto/blocks/boilerplate.git

2. Run npm i inside the downloaded/cloned folder:

$ npm i

3. Start the builder and load the block in developer (test) mode:

$ npm test

This command will start the local builder server and tries to open the URL http://localhost:3333 in your default browser. If no browser opens, just open the browser of your choice and navigate to this URL. By default, the form definition located at ./tests/example.json is loaded.

Next, open your favorite code editor/IDE and start working on your block. When a source code change is detected, the block should automatically recompile and the Tripetto builder in the browser should refresh.

✨ Publish your block

When your block is ready, you may want to publish it. Make sure you update the name and description in package.json before doing so. Also, set the private property to false (currently it is set to true to preserve unwanted publications).

Next, run the following command to increment the package version number, do a production build and publish the package to the npm registry.

$ npm run publish:patch

When your block is published, other people can install it and start using it inside the Tripetto form builder. All details on how to do that can be found here.

📖 Documentation

Tripetto has practical, extensive documentation. Find everything you need at tripetto.com/sdk/docs/.

🆘 Support

Run into issues or bugs? Report them here.

Need help or assistance? Please go to our support page. We're more than happy to help you.

💳 License

Have a blast. MIT.

👋 About us

If you want to learn more about Tripetto or contribute in any way, visit us at tripetto.com.