Get Started

Get your first survey live in under 5 minutes. This quick start guide walks you through creating a survey, embedding it on your site, and viewing responses.

What You'll Need

Step 1: Create a Survey in the Dashboard

  1. Log in to the SenseFolks Dashboard
  2. Click New Survey in the top right
  3. Choose a survey type (FastPoll is great for quick validation)
  4. Configure your questions and answer options
  5. Click Save to create your survey

Your survey is now created. You'll see a unique survey key (UUID) that you'll use to embed it.

Step 2: Copy the Embed Code

  1. In the dashboard, open your survey
  2. Click the Embed tab
  3. Copy the embed code snippet

The embed code includes two parts — a script tag and the component:

html
<!-- Load the SenseFolks component (add to head or before closing body) -->
<script type="module" src="https://unpkg.com/@sensefolks/fastpoll"></script>

<!-- Place the survey where you want it to appear -->
<sf-fastpoll survey-key="your-survey-uuid"></sf-fastpoll>

Step 3: Add the Survey to Your Website

Paste the embed code into your HTML where you want the survey to appear. Here's a complete example:

html
<!DOCTYPE html>
<html>
<head>
  <title>My Page</title>
  <script type="module" src="https://unpkg.com/@sensefolks/fastpoll"></script>
</head>
<body>
  <h1>We'd love your feedback</h1>
  <sf-fastpoll survey-key="your-survey-uuid"></sf-fastpoll>
</body>
</html>

The component works with React, Vue, Angular, and any other framework. See the embedding tutorial for framework-specific examples.

Step 4: View Responses

  1. Return to the dashboard
  2. Click on your survey
  3. Go to the Responses tab

You'll see responses as they come in, with visualizations and export options.

Optional: Customize Appearance

Style your survey to match your brand using CSS Parts:

css
sf-fastpoll::part(button) {
  background: #007bff;
  border-radius: 8px;
}

sf-fastpoll::part(heading) {
  font-family: 'Your Brand Font', sans-serif;
}

See the CSS Parts guide for all available styling options.

Next Steps