Artifacts

An artifact is something SupaNet saves for you so you can keep it, edit it, and share it. It might be a written document, a piece of code, or a small web page like a diagram or a one-pager.

Why artifacts are useful

Normally when an assistant writes something good, it is trapped in the chat. In SupaNet you can pull it out into an artifact. Once it is an artifact you can:

• Edit it in a dedicated editor.
• Preview it (for web pages, you see the rendered result).
• Copy the content with one click so you can use it elsewhere.
• Share it by setting its visibility and copying a link.
• Come back to it later - it is saved, not lost in chat history.

Two ways an artifact appears

1. The assistant makes one for you. When it produces something worth keeping, it saves it as an artifact and drops a share link right into the chat.
2. You make one yourself. On the Artifacts page you can create one from scratch and edit it.

Finding artifacts

On the Artifacts page, you can search across your entire collection by title or content. The search box finds matches anywhere in the database - not just in the visible grid - so you can locate an artifact even if it's many months old. As you type, results appear in real time.

Sharing and visibility

Each artifact has a visibility setting:

• Private - only you can see it.
• Unlisted - anyone with the link can see it, but it is not listed publicly.
• Public - openly viewable.

When something is unlisted or public, the link works for people who are not even signed in to SupaNet.

Optional password protection

When you share an artifact (unlisted or public), you can require viewers to enter a password before they can see it. This is useful for handing someone a link plus a password — like sharing a document with a customer or partner.

To set a password, open the artifact editor, go to the Sharing panel, and click Add password (or Change if one is already set). The password is stored securely with bcrypt hashing — viewers enter it once when they follow the link, and the artifact loads only if they get it right. Incorrect passwords are indistinguishable from a broken link, so there's no way to guess or brute-force it.

You can remove the password anytime, making the artifact accessible by link alone again.

Interactive HTML artifacts

HTML artifacts can be more than static pages. The assistant can create live, interactive trackers — checklists, kanban boards, scorecards, status dashboards — that you can click to update in real time.

When you toggle a checkbox, click a status pill, or edit a note in a tracker, the change is saved immediately. That state persists across reloads and syncs to your other devices, so a tracker you start on your laptop picks up where you left off on your phone.

The assistant can also edit a tracker in place instead of making a duplicate. Ask it to "add more items" or "change the layout" and it updates the existing artifact while keeping your saved state (your checked boxes, notes, choices) intact.

Images in artifacts

When you're editing an artifact, you can paste, drag-drop, or attach an image into the body. The image is uploaded to a secure public storage bucket and a markdown ![](url) link is inserted at your cursor. This works like GitHub-style image embedding.

Once an image is in an artifact, the URL is permanent and doesn't expire—so the image stays visible when you share the artifact publicly. The images are stored with a location-based path (your id + a unique identifier) so they cannot be guessed; the security model is the same as public artifact slugs.

To embed an image:

• Paste: Copy an image from your clipboard and paste it into the editor.
• Drag and drop: Drag an image file from your desktop onto the editor.
• Attach: Click the 📎 Image button in the toolbar and select file(s) to upload.

Non-image files are ignored if you paste or drop them by accident.

Standalone web pages

If an artifact is an HTML page, SupaNet can serve it as a clean, full-screen page with none of the app's chrome around it - just your content at its own link. This is perfect for sharing "a great diagram in HTML" or a simple landing page without deploying a whole website.

The page is served from your artifact and rendered in a secure sandbox. Editing the artifact updates the live page - fix a typo in the editor and the public link reflects it immediately. Private artifacts are never exposed this way - only unlisted or public ones.

For interactive trackers shared publicly, the live page shows your saved state (your checked items, notes, and choices) but visitors can only view it — they cannot make changes that stick.

Collections

You can group artifacts into collections - named groups you can use as a focused chat context. See Collections for the full guide. From the Artifacts page, multi-select artifacts and use Add to collection to file them into one or more collections.

When you click a collection to filter the grid, that filter is saved in the URL. This means you can use the browser's back button to return to the collection you were viewing, and you can share a filtered view by copying the URL with ?collection= in it.

Chat about an artifact

When you have an artifact open in the editor, a Chat button lets you talk to the assistant about it directly. Clicking it opens a conversation with the artifact pinned in a live panel beside the chat — so you can say "make it wider", "add a new row", or "change the colors" and the assistant updates it in place instead of creating a duplicate.

On desktop, you can drag the panel's left edge to resize it to your preference.

A nice side effect

Because artifacts live in the workspace, the assistant can also create and update them on your behalf as part of a larger task. Ask it to "write this up and share it" and you get back a link, not a wall of text to copy.