Introduction

If you are approved to create a Buster account, you may log in to onboard additional datasources, manage account settings, and create additional projects.

⚠️ All projects must be tied to a “datasource”. If you have not set up any datasources, please refer to our documentation on onboarding a datasource

Create a new project

Create a Project Gif.gif

All of your project can be found at app.buster.so/projects. In order to create a new project do the following:

  1. Click “New Project” from the projects page
  2. Enter a project name
  3. Select the data source you want to use (this cannot be changed once a project is created)

Dashboard Builder Overview

📊 The dashboard builder is the primary way to embed Buster into your website. The builder is used to style and create metrics, publish versions of your projects, and edit project settings.

Create your first metric

Create a chart gif.gif

  1. Click on “Add chart”
  2. In the search box, type in your question or click on one of the suggested questions below
    1. Note: The suggested question that appear below search bar are questions that were previously “approved” as apart of the data source onboarding fine tuning step. These questions are selected randomly.
    2. As a user is typing, suggested questions drop down below the input. These questions are also selected from the “approved” questions from the data source onboarding fine tuning step.
  3. Depending on the complexity of the question, data should be returned between 5 - 15 seconds.

Changing chart details

The following details can be changed about your metric

DetailHow to change
TitleClick on the title, enter the new text in the input box, and click enter to save.
Sub-titleClick on the sub-title, enter the new text in the input box, and click enter to save.
Chart ViewThere is a toggle button to the right of the chart title, click the table view or chart view to change your desired visualization.
Chart TypeBuster currently supports over 15 chart types. A recommended chart type is automatically select when you chat with Buster. However, you can change the chart type by click the drop down above the visualization. Depending on the chart type, you can change the X, Y, and Category axis.
Chart are typically used to visualize “numerical” data. While you can plot a non-numerical value on the Y axis of most charts, this is not recommended.

You can continue chatting using the input at the bottom left to continue refining your data

Saving a metric

A metric can be saved by clicking the “Save” button in the top right hand corner of the chat. New metrics are automatically saved to the top left corner of your dashboard.

Screenshot 2023-10-20 at 3.03.51 PM.png


Edit metrics

📊 Metric added to your dashboard as well as metric in your “search history” can be edited.

Editing existing metrics

Edit existing chart gif.gif

To edit an existing metric:

  1. Click on the metric’s title on the dashboard to open that metric’s chat history
  2. Once the metric is open you can continue chatting with it, editing it’s title, or visualization. Nothing will be changed on your dashboard until you click “Save”.
  3. Save is disabled until changes are made to the chart or chat.

Search history

Search History Gif.gif

To see your previous chats, you can click the “Search history” icon from the dashboard’s main page or by click “Search history” from an existing chat.


Stylize your application

🧑‍🎨 Buster has been designed to match your companies brand.

Themes and sizing

Themeing Gif.gif

Buster allows you change many visual attributes of your application. These changes happen from the “Styling tab”. All changes are saved automatically but will not be reflected in your embedded application until you click “publish”.

Test data

The “beaker” icon in the top left of the page can be clicked to enable “test data”. Test data is a great way to visualize how different themes will look in your application.


Edit project settings

Screenshot 2023-10-20 at 3.11.08 PM.png

Currently you can use the project settings to edit the following details:

  • Company name
  • Company Logo

#Preview Mode

😊 The preview mode is used to see how your application will appear as is it embedded on your website.

Preview mode gif.gif

To open the preview mode:

  1. Click the “Preview” button at the top of the builder page.
  2. To exit the preview experience click “Edit dashboard”.

NOTE: A new “preview user” is created every time you open the preview mode. What this means in practice is that every time you enter preview mode the application will wiped clean and defaulted to it’s original original state.

Publish and Embed

Screenshot 2023-10-20 at 2.44.26 PM.png

To put buster into your company’s website you will need to do the following steps:

  1. Publish the application.

By click publish in the top right of right, you are saving all the application’s styles, metrics, and meta data.

  1. Embed the application Additional info on embedding the application can be found on _____. Your application will always pull the most recent published version’s style, metric, ect.

Additional Help

For additional help, please reach out to support@buster.so to schedule a call. If it is a bug you are reporting, please document how that error was created and send it to support@buster.so.