FAQs and Troubleshooting

Getting stuck with Buzzy AI? Your answer might be here.

When I click "Connect to Buzzy" in the plugin, it takes me to a blank page

When you click the "Connect to Buzzy" it should redirect you to a Figma page, that looks like

Sometimes, due to timeouts, you may need to "Allow access" twice.

If you get a blank page, it is most likely a web browser security/session issue. Please check your browser for an security warning/popup blockers and allow them to open the Buzzy and Figma page.

If the problem still persists, if you're using Chrome, please try use the default Chrome session, not one logged in as a specific user Chrome profile (usually a colored tab).

I purchased an AI Creator license, why can't I see the AI features in the plugin?

• Make sure you are logged in Figma with the same email address as the one you provided in the form after your purchase.

• Close the plugin, and rerun it.

• In the plugin settings, disconnect from Buzzy then connect to Buzzy again.

You can check which email address you are signed in with by going to the plugin settings (cog icon).

I have the plugin opened and the AI features unlocked, why can't I generate screens?

To generate your app design and create your screens with Buzzy AI, you need to be in the Markup tab of the plugin. Click on the "Generate app design" to create your screens.

Make sure that:

• You have successfully generated your app brief (in the Brief tab) and your data model (in the Model tab) first.

• You are working in one of the Buzzy AI toolkits. If you are not using a toolkit, you will see the following error message: "Buzzy toolkit not found, cannot generate screens"

Where can I find the Buzzy AI toolkit?

You need to work in a Buzzy AI enabled toolkit if you are using Buzzy AI to create your app. Get it at https://www.figma.com/community/file/1308246684509963788/buzzy-ai-toolkit.

Buzzy AI Toolkit | Figma CommunityFigma

Previewing my Buzzy app in a browser shows a blank screen

Make sure you are using a standard modern browser such as Chrome, Safari, Edge or Firefox. We have had reports of issues with the Brave browser - if this applies to you, try using the 'Shields down' option to see if it's one your settings (eg disabling scripts) that might be the cause.

What are the different tabs and what do they do?

The tabs at the top of the plugin represent your app creation process, from the initial idea to the final app. They were designed to be followed from left to right.

The Brief and the Theme tabs are new additions to the Buzzy plugin. The Model tab was previously named Data. The Markup tab was previously named Design. The Publish tab is unchanged.

1. Brief: Create the overall description of the app to be built, including a high-level overview of the app, the main features (i.e. actions a user is expected to perform in the app) and the user roles (i.e. personas, user types).

2. Model: Create an optimised data model based on the app brief.

3. Theme (coming soon): Provide streamlined customisation.

   Note: Customisation is already possible as the file is entirely editable in Figma.

4. Markup: Set up Buzzy markup to link frontend to backend.

5. Publish: Publish the app on a server.

How can I edit the look of an app created with Buzzy AI?

All Figma files created with Buzzy AI are fully editable in Figma. Buzzy AI generates apps based on a tool kit that you can modify as you wish to change the look and feel of your app.

To import your Buzzy AI app into Figma, see this guide.

For additional guidance on how to customise a Buzzy AI app, watch this video: Buzzy Figma Plugin: Editing a Buzzy AI Figma app

How do I get my Buzzy AI app into Figma to edit it?

If you've used Buzzy AI to generate a new app via the Buzzy website or Buzzy Workspace, you can import the app into a Figma file. You can then edit and republish the app directly from Figma using the Buzzy Figma plugin.

1. Grab a copy of the Buzzy AI toolkit file

2. Follow the instructions in the toolkit file to run the Buzzy Figma plugin

3. Follow the instructions in the Buzzy Figma plugin to connect your Figma and Buzzy accounts

4. Use the Buzzy Figma plugin to find and import your app into Figma

See this guide for detailed instructions!

What if I want to change something in the app brief?

You can edit your app brief in 2 ways, from the Brief tab.

1. You can edit the brief manually by clicking on the Edit app brief button. You’ll then be able to add/edit/remove specific words or phrases from the brief. This is generally a good approach when you need to refine a few things and add small details to your brief.

2. You can ask the AI to change the brief based on a new prompt. Simply write a new prompt in the chat window that outlines the changes you want to make. This is generally a good approach if you want to make significant or numerous changes to the brief.

Depending on which step of the app creation process you’re at, you might need to rerun some AI functions. If you have only created your app brief, you can edit the brief without any concerns. If you have already generated a data model, you will need to generate an updated version of it by clicking the Regenerate data model button, once your new brief is completed. If you have already created your app design, you will need to regenerate the app design in the Markup tab. If you have already created some screens in Figma, you will need to clear the screens, regenerate the app design and recreate the screens.

How do I edit the data model?

Editing the data model works the same way as editing the brief. You can manually edit each data field by clicking on it or you can write a new prompt for the AI to do it for you. If you make changes to the data model, you will need to regenerate the app design and recreate the screens in Figma.

I got an error message, what can I do to resolve it?

All failures related to the AI assistant feature could be caused by any of the following:

• Timeout

• Token limit exceeded in the prompt

• Token rate limit exceeded in request

• OpenAI servers experiencing delays or failures

If you come across any of these issues, a general recommendation is to ensure that your input is not overly lengthy and give it another attempt.

Message	Meaning	Suggested solution
Error interpreting prompt	Something went wrong with your prompt. If you are using your own API key, this can mean that the key you have inputed is not enabled with GPT-4.	Check your GPT-4 API access (see here for more information).
Error updating app brief Error generating app brief	Something went wrong when you tried to create or edit your app brief.	Try a shorter prompt. Run the action again.
Error updating data model Error generating data model	Something went wrong when you tried to create or edit your data model.	Try a shorter prompt. Run the action again.
Error asking question on app brief Error asking question on data model	Your question could not be answered to by the AI assistant.	Buzzy AI is specifically designed to assist you in creating apps, which means its capabilities are focused on providing app development support. It will not be able to engage in conversations unrelated to this particular domain.
Error generating screen theme bundle. Error generating data theme bundle for table: [table.name]	Something went wrong when you tried to generate your app design.	Run the action again. Relaunch the plugin.
Screen creation timed out	The Figma plugin took too long to create the app screens. This may be due to your machine running slowly or Figma experiencing delays or failures.	Run the action again. Reload Figma.
Screen clear timed out	The Figma plugin took too long to clear screens from the canvas. This may be due to your machine running slowly or Figma experiencing delays or failures.	Run the action again. Reload Figma.
Error generating sample data	Something went wrong when you tried to generate sample data to populate your app.	Run the action again. Relaunch the plugin.
Error searching for sample images	The AI assistant failed to search for images on Unsplash. This may be due to a timeout issue or the Unsplash AI experiencing delays or failures.	Run the action again. Relaunch the plugin.

Can't find your answer here? Contact the Buzzy team for support.