Add References to a Project

References are materials that help Castaly understand what you want to build. They can be screenshots, documents, examples, notes, or saved Assets.

Add references before creating a Project so Castaly can read them together with your instructions and form the first Spec and Graph.

What counts as a reference

🖼️Screenshots

Visual examples, UI references, or product screenshots that show style, layout, or behavior.

📄Documents

Briefs, notes, requirements, product docs, or other files that describe what you want.

🔎Examples

Existing products, pages, or materials you want Castaly to learn from.

🗂️Saved Assets

Images and files you have already saved in your Assets library.

Add references from Home

Start from the Home composer. Add your written instruction first, then attach any references that help explain the Project.

1. 1

   Open the + menu

   Use the + menu at the bottom left of the Home composer.

2. 2

   Upload files

   Choose Upload files to add screenshots, images, or documents from your device.

3. 3

   Or add saved Assets

   Choose Assets to pick images or files you have used before.

4. 4

   Send when ready

   Press Send to create the Project with your text and references together.

You can also drag files onto the composer or paste a screenshot directly. These become temporary attachments before you send.

Use saved Assets

The Assets library is a lightweight place to reuse material you have already given Castaly.

Use saved Assets when:

• the same screenshot or document applies to more than one Project
• you uploaded material earlier and want to reference it again
• you want to avoid uploading the same file repeatedly

Open it from:

Home composer → + menu → Assets

Temporary attachments vs saved Assets

Not every reference starts as an Asset.

📎Temporary attachments

Files you drag, paste, or add with Upload files live only in the composer until you send.

🗂️Saved Assets

Files chosen from the Assets library are already saved, so sending references them.

What happens after you send

1. 1

   Castaly creates the Project

   Your message and references become the starting context for the new Project.

2. 2

   Temporary attachments are saved

   Files uploaded through the composer are saved to your Assets and linked to the Project.

3. 3

   Saved Assets are linked

   Files picked from the Assets library stay saved and are referenced by the new Project.

4. 4

   Castaly builds the first understanding

   Castaly reads your text and references together to draft the first Spec and Graph.

References help Castaly understand the Project. If a file contains requirements you want built, say that clearly in your message so Castaly knows how to use it.

Supported reference types

🖼️Images

PNG, JPG / JPEG, and WEBP.

📄Files

PDF, Markdown (.md), TXT, and HTML.

For the full input list and starting modes, see Supported Inputs.

When to use Manage Assets

Use this page when you want to add references to a new Project.

Use Manage Assets when you want to manage the library itself:

⬆️Upload to the library

Save material before adding it to a Project.

🗂️Download or delete

Manage existing images and files in your Assets library.

Next: Manage Assets covers the Assets library — uploading, downloading, and removing material.