Docs — publish, write, share

Ask your assistant to publish. For example: "publish this report to Profusia" or "put this dashboard in Profusia under the Client Work folder". Your assistant will write the file and send it over. You get back a link, and Profusia tells the assistant where the file landed so it can tell you the folder too. You can publish HTML pages, JSX (which Profusia compiles in the browser — no build step), Markdown, code files, images, PDFs, and Office documents. Anything Profusia can render becomes a live page; anything it can't becomes a clean download. Word, PowerPoint and Excel files are searchable by what they say, not just their name — Profusia reads the words inside them when they are published, so they show up in search and can be asked about like any other document. A PDF is still matched by name only; Profusia says so rather than pretending to have read one it hasn't.

You do not need an assistant for everything. On any site, the Add button (and the + beside any space in the navigation) offers "Write a document". It is a normal rich-text editor: headings look like headings, bold looks bold, and you never see Markdown syntax. Paste from Word or a web page and the formatting that Profusia can keep is kept. You can drop pictures straight in. What gets stored is Markdown, which is deliberate — it is what lets your assistant pick the document straight back up later and revise it. Occasionally a document opens showing Markdown source instead, with a line explaining why. That happens when it contains something the visual editor cannot hold without changing it — a table, or a nested list. Profusia checks each document before opening it and shows the source rather than risk quietly altering your content. There is a Markdown / Rich text switch in the toolbar either way. To edit a document that already exists, open it and use Edit.

If the file already exists — on your computer or phone, exported from another app, attached to a chat — don't make your assistant retype it. Ask for an upload link. Your assistant can call get_upload_link, which gives you a private drag-and-drop page. Drop the file in and it lands in your workspace like anything else. That works for any file type, and it is much faster than streaming a large file through a conversation. You can drop a whole folder in too, or choose one with the folder picker — its structure is kept, and every file inside lands in the matching place in your workspace rather than being flattened onto one level.

Every document is private by default. Nobody can see it until you create a share link. Ask your assistant for a share link (get_share_link) and you get a URL with a secret token in it. Anyone with that link can view the document — treat it like a key. Share links can be set to expire, and they can be revoked and reissued at any time. A share link can also ask for a password. It does not stop somebody forwarding the link and the password together — nothing can — but that is not what it is for. It protects against the accident: the reply-all, the wrong Sarah, the screenshot in a deck. Someone who forwards the link without the password has not leaked the document. Ask for one when you get the link, tell your assistant to send it by a different route than the link itself (a different message, a different channel), and that separation is the whole protection. Passwords are stored hashed and never shown again, even to you — if one is lost, mint a fresh link with a fresh password. If you want to look at your own document, you don't need a share link at all: sign in and open it from your site. Signing in shows you everything you have access to. There is also a sharing review (review_sharing) that lists every live link in your workspace, so you can see at a glance what is currently reachable from outside.

Every time a document is updated, Profusia keeps the previous version. Nothing is overwritten. To go back, ask your assistant to roll the file back (rollback_file) to an earlier version, or do it yourself: open the document in Docs, and its panel has a Version history section listing every version with its date, who made it and any note they left. Press Restore — it asks you to confirm with a second press, then makes that version current. Either way, restoring never deletes anything: the version you were on stays right there in the list, which is what makes the whole thing undoable. The share link never changes, so anyone holding it just sees the restored content.

These do different jobs, and it is worth getting the distinction: A FOLDER is where a file lives — the filing cabinet. One file, one folder. A PROJECT (some workspaces call them Initiatives, Campaigns, or something else — you choose the word) is what a file is FOR. Projects can nest, a file can be in one, and each project carries a description and a set of goals. The reason projects matter: those goals get read back to your assistant whenever it publishes into that project or lists what is in it. So a session next month picks up what the project is trying to achieve without you re-explaining it.