> For the complete documentation index, see [llms.txt](https://learn.squirrel365.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.squirrel365.io/the-designer/tufty-ai/using-tufty-ai.md).

# Using Tufty AI

How to use Tufty AI in Squirrel365: open the panel, start and revisit chats, attach images and documents, and give feedback or report a bug.

Tufty AI works in a chat panel inside the Squirrel365 Designer. This guide covers what you need to work with it day to day: opening the panel, starting and revisiting chats, attaching images and documents, and sending feedback or reporting a problem.

{% hint style="info" %}
Tufty is currently in Early Access. Some features may still change while we gather feedback.
{% endhint %}

## Opening the Tufty AI panel

Open a project in the Designer. Along the top bar on the right you will see the buttons for the Component Tree, the spreadsheet and the property panel. Just to the right of those is the Tufty AI button, marked with two small stars. Click it to open the Tufty panel.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2Fie70C1fKekL92VwB7yGN%2FTufty%20AI%20panel%20toggle.png?alt=media&amp;token=40d6c014-3354-4722-84bb-749604671d07" alt="" width="375"><figcaption></figcaption></figure>

The panel opens on the right, on top of the property panel if you have it open, with the greeting "Hey, what are we building today?" and a text box where you type your requests.

The first time you open Squirrel365 after Tufty has been added, the panel opens on its own with a short introduction, so you may find it already waiting for you.

### Hiding and showing Tufty AI

Click the Tufty AI button (the two stars) again to hide the panel and go back to the property panel. Click it once more to bring Tufty back. Your current conversation is still there when you reopen it.

### Resizing the panel

To give Tufty AI more or less room, move your cursor to the inside edge of the panel until it changes to the resize icon. Click and drag to the left to make the panel wider, or to the right to make it narrower.

{% embed url="<https://youtu.be/KrxUy2FqufQ?autoplay=1&loop=1>" %}

## Starting a new chat

When you want to begin something new, start a new chat. This clears the panel and gives you a clean conversation to work in, which is handy when you move on to a different task.

At the top right of the Tufty AI panel you will see three buttons: an AI credits button, a history button shaped like a clock with an arrow, and a blue plus button. Click the blue plus button to start a new chat. The panel clears and shows the "Hey, what are we building today?" greeting again, ready for your first request.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FKW5gIsyN5FKLUHnTfA4c%2FTufty%20AI%20new%20chat.png?alt=media&amp;token=8c3f4a2b-ea96-4dc2-94b8-b15c7e92bd5e" alt="screenshot of Tufty AI panel with new chat button highlighted" width="358"><figcaption></figcaption></figure>

Starting a new chat does not delete your previous one. You can return to earlier conversations at any time from your chat history.

### Viewing your chat history

Tufty AI keeps the conversations you have had so you can look back at them and pick up where you left off.

Click the history button (the clock with an arrow, next to the blue plus button) to open a list of your conversations. Click any conversation in the list to reopen it, and the panel switches back to that chat. To close the list without changing anything, click the x.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2F2p9CpUj3TuMWQQMakCyO%2FTufty%20AI%20history%20open.png?alt=media&amp;token=91ae2059-0171-4145-b5bd-7383a6b66b56" alt="" width="356"><figcaption></figcaption></figure>

Your chat history belongs to the project you are working in. If you open a new project, you start with a fresh, empty chat list, and conversations from a different project are not carried across.

## Pointing at, or targeting, a specific component

Instead of describing which component you mean, you can select it. Tufty then knows exactly which component your request is about, so asking it to "make this blue" changes the one you picked, even when other components look the same.

### Selecting a component

Select a component on the canvas or in the Component Tree and its name appears in the text box, indicating that component is selected. By selecting a component you are influencing Tufty to try and apply the request to that component in the first instance. If it doesn't make sense then Tufty will fall back on looking at the whole app.&#x20;

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FDJFbDXzSG8WHTmKr7pxF%2Fimage.png?alt=media&amp;token=24700fd2-243e-4573-9d67-bf96beb2c6a2" alt="" width="375"><figcaption></figcaption></figure>

Component selection for Tufty AI works with one component at a time. A container or a group counts as one component, so selecting one points Tufty at the whole container or group. If you select several separate components, only the first one you selected appears in the chat. The others stay selected on the canvas.

### What Tufty AI does with the component you choose

* **Your request is about that component.** Tufty knows to change the component selected in the chat, not a similar one elsewhere in your app.
* **Related changes still happen.** If your request means something nearby needs to change too, such as the label beside a chart, Tufty can change that as well.
* **The rest of your app is still in view.** If your request is not about the component you chose, Tufty works across your app as normal rather than refusing.
* **It stays chosen.** When Tufty finishes, the same component is still selected and still in the chat box, so you can keep refining it without selecting it again.
* **Your messages keep a record.** Each message you send shows which component it was about, so you can look back at what each request worked on.

### Clearing the selected component

Click the **x** next to the component's name in the text input to de-select it. The name disappears from the chat, but the component stays selected on the canvas.&#x20;

The component is also cleared automatically if you delete it, start a new chat or open a different project.

## When Tufty AI needs to remove a component

Tufty checks with you before it removes components from your app. This happens when you ask it to remove something, and also when removing components is part of carrying out a bigger request.

When this happens, an **Allow Tufty to remove components?** message appears just above the chat box. It tells you how many components Tufty needs to remove and lists each one by name, so you can check exactly what will go.

* Click **Remove** to let Tufty remove them and carry on.
* Click **Don't allow** to keep them. Tufty leaves those components in place and carries on with the rest of your request.

If you would rather Tufty did not ask each time, tick **Don't ask again** before you choose. Tufty then removes components without asking for the rest of that chat. Start a new chat if you want it to ask again.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FJSqAkmk05MKUT2iFzZhn%2FTufty%20remove%20components%20dialog.png?alt=media&amp;token=3e7932ac-5c92-4194-addb-26af0293c90b" alt="Screenshot showing remove component confirmation dialog in Tufty AI panel of the Squirrel365 designer." width="352"><figcaption></figcaption></figure>

## Attaching images and documents

You can attach images and documents to your message so Tufty can see them and work from them. You might share a screenshot of a layout you like, a spreadsheet whose data you want to bring into your app, or a document that lists instructions for Tufty to follow.

You can attach up to five files at once, and each file must be 10MB or smaller.

### Supported file types

* Images: PNG, JPG, GIF, SVG and WEBP.
* Documents and spreadsheets: Word (DOCX), plain text (TXT), Markdown (MD), Excel (XLSX) and CSV.

{% hint style="warning" %}
PDFs cannot be attached at the moment. If you try to upload an unsupported file type, or one larger than 10MB, Tufty AI will display an error message.
{% endhint %}

### Adding a file

Open the Tufty AI panel if it is not already showing, then add your file in one of two ways.

Using the paperclip:

1. In the text box at the bottom of the panel, click the paperclip icon.
2. Find your file and click Open.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FHRHEzUMCjYgmh55MHuoh%2FTufty%20AI%20image%20upload.png?alt=media&amp;token=0188de92-33d1-44f0-bf72-625aa0d9853e" alt="" width="351"><figcaption></figcaption></figure>

By dragging and dropping:

Drag the file into the panel from a folder on your computer or from a web browser. The panel turns blue and shows a "drop file here" message. Release the file to add it.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FNsfklfa1Yuf7AmiIkN2R%2FTuftyPanel%20-%20Drag%20and%20drop.webp?alt=media&amp;token=aa2d8522-e9db-4b02-b2ca-e126cf96a7e1" alt="" width="375"><figcaption></figcaption></figure>

Attached files sit just above the text box, ready to send with your next message. To remove one before sending, click the small x on it. If you have added several, you can scroll through them.

### What Tufty AI can do with your files

What happens next depends on what you ask Tufty to do:

* See and use an image. Tufty can describe what is in an image or use it as a styling reference for your app.
* Follow instructions in a document. Put your instructions in a Word, text or Markdown file, then ask Tufty to follow them. This is useful for longer requests, or ones you want to reuse.
* Import spreadsheet data. Attach an Excel or CSV file and ask Tufty to import the data into your spreadsheet.
* Use several files together. Attach more than one file, for example a text file of instructions and an image for styling, and ask Tufty to work from both.

### Viewing and downloading files in the chat

After you send your message, the files you attached appear in the chat above your request. Click a file to open it. Images open in a preview with a download button in the top corner, and downloaded images are saved in WEBP format. Some files, such as text files, show a preview, while others, such as Word documents, cannot be previewed but can still be downloaded.

## Working with your custom components

Tufty can add and work with the custom components you have built, so you can use your own building blocks in a request just as you would standard components. To find out how to create custom components, see [Custom Components](https://learn.squirrel365.io/the-designer/custom-components.md).

### Adding a custom component

Ask for the custom component by name, for example "add my sales KPI card to the top of the page". You do not need its exact name: capitals, spaces, hyphens, and singular or plural forms all match. Tufty checks your custom components before its standard ones, and can add any of your custom components, even one this project has not used before.

When Tufty finds a match, it tells you which custom component it found and asks before adding it. If you make it clear you want a custom component, for example "add my custom component called ratings scale", Tufty adds it straight away and tells you what it did.

If more than one of your custom components could match, or yours shares a name with a standard component, Tufty asks which one you mean.

### Connecting data to a custom component

Tufty can bind spreadsheet data to a custom component's linked properties, which are the properties you chose to expose when you built it. You can ask Tufty to add a custom component and connect data to it in a single request.

### Keeping custom components up to date

Tufty always adds the latest version of a custom component. If your app already contains older versions of the same custom component, Tufty tells you in the chat and offers to update them. It never updates them without asking.

### What Tufty AI cannot do with custom components

* Create or edit a custom component, or change the components inside one.
* Rename, delete or upload your custom components. You can do this yourself in the Designer.
* Suggest one of your custom components when you have not mentioned it.
* Make an exact copy. If you ask Tufty to duplicate a custom component, it adds the latest version without the original's bindings, and tells you so.

## Giving feedback and reporting a bug

You can tell the team how Tufty AI is doing right from the chat, and report anything that is not working. Because Tufty is in Early Access, this feedback directly shapes what gets improved.

Underneath each of Tufty's responses you will see a thumbs up button, a thumbs down button and a copy button.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2FQis20hJh91HPM4Pt5I0m%2FTufty%20AI%20feedback.png?alt=media&amp;token=624fa891-4f9d-4542-a337-ccc3c8c986b9" alt="" width="354"><figcaption></figcaption></figure>

* Click thumbs up if the response was helpful. A short message confirms that your feedback has been logged.
* Click thumbs down if it was not. The Feedback on Tufty AI window opens, where you can tell the team more.

### Sending feedback

In the Feedback on Tufty AI window, type what did not meet your expectations in the feedback box, then click Submit feedback. When you submit feedback, a copy of your conversation is kept so the team can look into what happened, so bear this in mind if your chat included anything sensitive.

<figure><img src="https://911720298-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkLBGzn2hXrIMe50klQCv%2Fuploads%2Fi39CFav3qOWn6Oj4jzRn%2Fimage.png?alt=media&amp;token=fc5ab477-2d32-4df3-9038-de9a699c115b" alt="" width="563"><figcaption></figcaption></figure>

### Reporting a bug

The same window has a Found a bug? section for when something is broken. To raise a support ticket:

1. Click Generate Support Package. This creates a support package you can download, and copies the details of the error and your workflow to your clipboard.
2. Email <support@squirrel365.io> describing the problem, attach the support package, and paste in the copied details.

### Copying a message

You can also copy any single message out of the chat. Hover over one of your own questions, or look underneath a response, to find the copy button. Click it, and a short message confirms the text has been copied. You can then paste it wherever you need it, for example into the spreadsheet or another document.
