文档暂以英文提供 · docs are in English for now

DOCS / publishing

Posts

The Posts tab inside a space. A post is not a long message but a document: a title, blocks, a cover, comments, revisions.

A post’s atmosphere — sound and background — has its own page: atmosphere.


Creating a post

The ✍ New post button. The composer opens.

At the top is the post type. It does not change the mechanics; it tells the reader what they are looking at:

type what for
article an article
note a note
release a release
log a journal, a chronicle
space card a card for another space — catalogs are assembled out of these (navigator)

Then: the cover, the title, a short description — and blocks.


Blocks

The chip buttons at the bottom of the composer add a block at the end; each block has arrows for moving it and a cross for removing it.

block what it is
Text · Heading text and a heading
🖼 Image · ♫ Audio · 🎞 Video · 📄 File media; a file uploads straight into the block
❝ Quote · Callout · Code · Link · Credits · — quote, callout, code, link, credits, divider
📊 Poll · 📝 Form interactive — the reader answers right inside the post
🎧 Listening room shared listening inside the post (listening room)
🖼 Background not a block but a background change at this point of the post (atmosphere)

That last row is worth remembering: “Background” stands among the blocks because it marks a place in the post, but on the wire it travels not as a block but as part of the atmosphere. For an old client this means it will simply not show the picture, instead of drawing a mysterious card in the middle of the article.


Draft, publish, edit

  • Save draft — the draft stays with you. It goes nowhere.
  • Publish — the post becomes a space event: signed, visible, with a permanent address.
  • Edit on a published post — a new revision. The previous one does not disappear, the post’s link does not change, and comments and resonances stay attached to the post, not to a version of it.

If the post was changed somewhere else while you were editing, publishing will not silently overwrite someone else’s work — you will be told the post has changed, and your draft is intact.

Taking a post down is possible — then for everyone, including those you forwarded it to, it is honestly marked “withdrawn by its author” rather than disappearing without explanation. The web interface has no button for this yet; the action is available through the API:

POST /api/spaces/{id}/publications/{doc}/archive

✨ AI draft

The line at the bottom of the composer: describe the post in words, press Draft — and the model fills in the title, the description and the blocks.

Two properties that do not change:

  • AI proposes, you publish. No model writes into the space’s journal on its own.
  • Where the request text goes depends on the chosen provider — see assistant.

What the reader sees

The post feed is cards: cover, title, description, type and the number of comments. A post with an atmosphere shows a still frame on its card and two doors — “open quiet” and “open with sound”.

Inside the post: the article, resonances on the post itself, and comments. Comments are ordinary space events, which means they are visible to the same people the space is visible to.


What’s next

  • Sound and a changing background — atmosphere
  • Who can see a post — spaces
  • Forward a post to someone who is not in this space — navigator