roundtable-js

RoundtableJS

Programmatic survey software


Cloud editor •
Slack •
Documentation

RoundtableJS is an open-source JavaScript library for building complex surveys, forms, and data annotation tasks. It's designed to be simple but completely customizable. We make it easy to add complex logic (e.g. branching, skipping, looping), modify question types, and fully customize the design.

🌟 Features

- Designed for the Modern Web: We're designed in JavaScript and leverage its asynchronous functionality for managing survey logic. For example, rather than determining this logic based on callbacks that trigger when a page is submitted, our library builds the timeline in an async function which means the logic flows intuitively from top to bottom.

- Developer-Friendly: We are open-source and API-first. The idea for RoundtableJS arose by seeing how difficult it was to integrate Roundtable's API into other survey software. We want the open-source offering to include a robust plugin ecosystem where people can introduce new question types, integrate with tools like CRMs, and control how data is stored and processed.

- AI-Native Functionality: Our cloud offering has AI-native features such as natural language programming and automated fraud detection. We're continuously expanding our AI features. Let us know what tools you'd like to see!

🖼️ Examples

Here are some example surveys built with RoundtableJS. All code is in the examples/studies directory.

- Customer Feedback Survey
- Product Market Fit Survey
- Book a Demo Form
- Enterprise Market Research Survey
- Data Annotation Task

🚀 Quick Start

Installation

$3

1. Install roundtable-js using npm:
``bash
npm install roundtable-js
`

$3

1. Clone the repository:
`
git clone https://github.com/roundtableAI/roundtable-js.git
`

2. Navigate to the project directory:
`
cd roundtable-js
`

3. Include the necessary files in your project.

$3

1. Include the following script tag in your HTML:

`html

`

Usage

1. Import the necessary modules in your JavaScript file for npm or Git installations:


`javascript
import Survey from 'roundtable-js/core/survey.js';
import SingleSelect from 'roundtable-js/question_types/singleSelect.js';
`

For CDN installation, ensure the script is loaded and use the global RoundtableJS object:

`javascript
const { Survey, SingleSelect } = RoundtableJS;
`


2. Create a survey instance and add pages with questions:

`javascript
// Define an asynchronous function to run the survey
async function runSurvey() {
// Create a new Survey instance with a specific participant ID
const survey = new Survey({ participantId: 'participant_123' });

// Define the first question as a single-select question with two options
const question1 = new SingleSelect({
id: 'question1',
text: 'A question',
options: ['Option 1', 'Option 2'],
});

// Define the second question as a single-select question with two options
const question2 = new SingleSelect({
id: 'question2',
text: 'A second question',
options: ['Option 1', 'Option 2'],
});

// Show the first page with the first question and wait for it to be answered
await survey.showPage({ id: 'page1', elements: [question1] });

// This code runs only after the first page is completed
console.log('Page 1 completed');

// Show the next page with the second question and wait for it to be answered
await survey.showPage({ id: 'page2', elements: [question2] });

// Finish the survey once all pages are completed and display an end message
survey.finishSurvey('Thank you for completing the survey!');
}

// Start the survey by calling the runSurvey function
runSurvey();
`

3. Set up your HTML:

`html











``

📚 Documentation

Read our full documentation.

🎉 Community

Join our community:
- Slack
- Twitter
- Blog
- LinkedIn

🛠️ Development / Open-Source Community

Please see our Contributing Guide.

📜 License

RoundtableJS is open source software licensed.

---