# Files

> Bring files into your workspace, edit them safely, and share their context with Kin.

**Experimental · private access. Public signup is not open.**

<!-- SOURCE: src/lib/Files.svelte, src/lib/fileDrafts.ts, src/lib/ShareFile.svelte, internal/home/files.go, src/routes/+page.svelte -->

Choose the workspace, then **Files**. The folder path above the list steps
back to a parent folder; the Files breadcrumb returns to the workspace root.
Space remembers the folder and open file when you return from another page.

## Create or upload

Use the file toolbar to create a file or folder. To upload, drop files into the
open folder or use the upload control. Uploads never overwrite an existing
file. If a name conflicts, rename the incoming file or deliberately resolve
the existing one before retrying. Each uploaded file can be up to 64 MiB.

Attaching a file to a message also uploads it into the current workspace.
Removing the attachment from the draft leaves the uploaded original here.

## Save an edit

1. Open a text file from the list.
2. Make your changes in the editor.
3. Choose **Save changes**, or press Ctrl+S / ⌘S.
4. Check that the editor no longer reports unsaved changes.

[![Editing a fictional garden README in Files.](/docs-assets/space/files-desktop.png)](/docs-assets/space/files-desktop.png)

*The file list, open document, and save controls in a disposable workspace.*

Typing while a save is in progress can leave newer text unsaved. Save again
after that save finishes. File drafts stay in memory while you navigate;
**save before reloading or closing the browser**. Conversation draft recovery
is not a backup of an unsaved file edit.

### If the file changed elsewhere

A conflicting save keeps your draft and offers a choice inside the editor:

- **Use the newer text** accepts the current file from the machine.
- **Keep mine** writes your draft after you have reviewed the conflict.
- **Save it again** recreates a file that was removed behind the editor.

Copy anything you want to retain before choosing between competing edits.

## Discuss or preview with Kin

**Discuss with Kin** deliberately adds the file's context to your message.
Review the draft and send when ready.

**Preview with Kin** opens the file beside Kin in Chat. Closing the preview
returns you to the open file. This is different from downloading the original.
For an interactive result you want to revisit, see
[Artifacts and widgets](/docs/space/artifacts/).

## Download or share

The download control saves the original file to your device. Right-click a
file, press Shift+F10, or choose **…** for open, discuss, preview, download,
and path-copy actions.

On supported devices, **Share file…** first prepares the original. A second tap
on **Share** opens the system share menu. If sharing is unavailable, use
Download. This does not create a public file link.

Saving a file writes it to your machine. Use [Source](/docs/space/projects/#keep-local-git-history)
or [Depot](/docs/space/depot/) to keep a project checkpoint separately.

_Source authority: Kinra Site (src/content/docs/space/files.md)._