Collections and folders

The account is a consumer layer, and consuming means collecting. An account organises what it gathers into a few simple shapes: one bookmarks list, any number of typed folders, and routes. None of them nest. The flatness is the point.

Bookmarks: one list, always on top

Every account has exactly one bookmarks list — a single fixed place for things you want to keep. It holds references to pages (WebPage references), and it sits at the top of your collection, always. If you have used Spotify’s “Liked Songs”, you already know the pattern: not a folder you create and might lose among others, but the one list that is simply always there.

Typed folders: one type per folder

Beyond bookmarks you can make typed folders — curated lists where every item is the same type. A folder of places. A folder of articles. The folder’s type is fixed when you create it, and everything inside it shares that type.

Bookmarks            (WebPage refs, always first)
Folder: Places       (every item a Place)
Folder: Articles     (every item an Article)

Routes: the same shape, as a journey

A route uses the same underlying form as a folder, but it is presented as a journey rather than a list — an ordered path through its items, surfaced with a journey-style UI. Same data shape, different reading experience.

Flat and hand-ordered

Collections do not nest. There are no folders inside folders, no trees to navigate. Within a list you arrange items by hand, in the order you want them. This is a smaller toolkit than a full filesystem on purpose — flatness keeps the model legible, and a single type per folder keeps the contract strong: a consumer of a “Places” folder knows, without checking, that everything in it is a Place.

You can only bookmark what is reachable

You add something to a collection through a deeplink, not by hand-assembling an entry. Only a page that is actually reachable — one with a path — can be bookmarked. You point at a live, addressable page and the reference is captured from it. There is no way to fabricate a collection item for something that has no public address, which keeps every reference honest: it always pointed at a real, reachable page at the moment it was added.