Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
27 changes: 27 additions & 0 deletions content/docs/(reference)/changelog.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,33 @@ Each release of Marfa ships the server and its container image, the CLI for macO

**Marfa doesn't upgrade a database in place.** A build refuses a database whose schema differs from its own, or that holds retired tables or settings, and leaves the file unchanged; a version change alone doesn't cause a refusal. [Upgrade](/guides/upgrade) shows how to test an export and restore on fresh storage before switching builds.

## v0.0.35

Released October 24, 2026. [v0.0.35 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.35)

**Change anything that sends view layouts before you upgrade.** A view is a `title`, a `query`, an optional `sort` and an optional `group`. A request that sends `layouts` is refused `400 validation_error`, and a view saved with `layouts` drops them the next time it is changed. In the CLI, `marfa views create` and `marfa views change` take `--sort` and `--group` in place of `--layouts`, `marfa device items list --layout` and `marfa device views groups --layout` are gone, and so is a group's `sum`. The server's database and the working copy keep the shapes they had in v0.0.34, so an instance needs no export to upgrade. See [Save a list as a view](/guides/list-filter-search#save-a-list-as-a-view).

For apps and the API:

- **A view clears its grouping with `group: null`.** Send it on `PATCH /views/{id}`, or run `marfa views change <id> --version <n> --group null`. A view's `filter` takes an `edge` term, a `backref` term and a `source` term, and a working copy answers a `backref` condition where it holds that edge type whole. See [Read a view offline](/guides/read-a-view).
- **Notes, articles and messages no longer require a `body`.** A note can be only a title, and a message only a file. An existing instance stops requiring it the next time it starts, with no migration. See [Items and types](/items-and-types).
- **Every edge type names both of its ends.** `label` names the source end and the optional `reverse_label` names the target end. Without a `reverse_label`, the label names both ends; without a `label`, Marfa makes one from the ID. See [Edges](/catalog/edges).
- **Move every item of a type to another type in one step.** `POST /types/{id}/move`, or `marfa types move <from> <to>`, queues a bulk-action job that moves the items, the trash included. Once none is left, it changes the folders, views and webhooks that name the old type. `DELETE /types/{id}` now refuses while a folder, view or webhook names the type, and lists them in `details.settings`. See [Move items to another type](/guides/move-items-to-another-type).

For folders:

- **A folder writes every attached file beside its document**, whether or not the body embeds it, and lists the files no embed places under the document's `has-attachment` line. A file follows its document to another directory, and leaves with it. A second folder on the same Mac that holds the file keeps its own copy, and a folder pull no longer deletes and rewrites it on every pass. See [Files attached to a note](/guides/sync-a-folder#files-attached-to-a-note).

## v0.0.34

Released October 24, 2026. [v0.0.34 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.34)

**This release fixes the folder watch, which runs in the CLI, so upgrade the CLI to get the fix.** The server's database, the API and the working copy keep the shapes they had in v0.0.33, so an instance needs no export to upgrade.

For folders:

- **An idle folder watch no longer runs a pass every second.** A pass starts only while a change is waiting, and no later than five seconds after the last pass ended, even while changes keep arriving.

## v0.0.33

Released October 24, 2026. [v0.0.33 on GitHub](https://github.com/withmarfa/marfa/releases/tag/v0.0.33)
Expand Down
10 changes: 10 additions & 0 deletions src/lib/command-check-allowlist.json
Original file line number Diff line number Diff line change
Expand Up @@ -29,6 +29,16 @@
"text": "marfa blobs delete-location",
"reason": "The changelog names the old name of a command that a release renamed."
},
{
"page": "(reference)/changelog.mdx",
"text": "--layouts",
"reason": "The changelog names an option that a release removed."
},
{
"page": "(reference)/changelog.mdx",
"text": "--layout",
"reason": "The changelog names an option that a release removed."
},
{
"page": "guides/deploy.mdx",
"text": "--import",
Expand Down
Loading