Features

Bookmarks

A bookmark is the core item in the app. Each one stores:

| Field | Required | Notes | |-------|----------|-------| | Title | Yes | Up to 300 characters. Edit it to be descriptive — this is what you'll scan when searching. | | URL | Yes | Up to 2 000 characters. If you paste a bare domain, https:// is added automatically. | | Description | No | Up to 1 000 characters. Use this to note why you saved the link. | | Tags | No | Comma-separated string, e.g. design,tools,reference. Displayed inline with each bookmark. | | Folder | No | Assigns the bookmark to a folder. The bookmark inherits the folder's circle automatically. | | Favorite | No | Toggle on to pin the bookmark to the Favorites section. | | Circle | Yes | Determines which workspace the bookmark belongs to. Defaults to your default circle; overridden by the folder's circle when a folder is selected. |

Favicon display

Each bookmark shows a small favicon (the website's icon) next to its title throughout the app — in lists, folder views, and the Favorites page — making it easy to recognise sites at a glance without reading the URL.

Visit tracking

Every time you click a bookmark to open it, the app records the last visited date. You can sort the All Bookmarks list by Most Visited to bring your most-used links to the top.

Folders

Folders give your bookmarks a hierarchical home. A folder stores:

| Field | Required | Notes | |-------|----------|-------| | Name | Yes | Up to 200 characters. | | Description | No | Up to 500 characters. | | Parent Folder | No | Makes this folder a subfolder of another folder, creating a tree structure. | | Icon | No | Any emoji or short string displayed next to the folder name for quick visual identification. | | Color | No | A hex colour used for visual accents on the folder. | | Circle | Yes | The workspace this folder belongs to. All bookmarks placed inside this folder inherit this circle. |

Subfolder hierarchy

There is no enforced depth limit — you can nest folders as deeply as you need. The sidebar shows your root folders; clicking a folder opens its content including any immediate subfolders and the bookmarks it contains directly.

Circle inheritance

When a bookmark is placed inside a folder, its circle is locked to the folder's circle. The circle field in the bookmark form becomes read-only and shows an explanatory notice. To change the circle you must either move the bookmark to a folder in the target circle or remove it from its current folder.

Folder content view

Opening a folder shows:

• A search bar to filter the content by title or URL.
• Subfolders listed at the top with their own icons and colors.
• Bookmarks beneath the subfolders, sorted by creation date by default.
• A pagination bar so large folders stay fast and navigable (10, 20, or 50 items per page).
• Edit and Delete buttons on each item (shown only when you have the appropriate permission).
• A + New Subfolder shortcut to quickly nest a new folder.
• A + New Bookmark shortcut that pre-selects the current folder.

Favorites

Mark any bookmark as a Favorite using the checkbox in the save/edit form. All favorited bookmarks appear in one place — the Favorites section accessible from the sidebar. The Favorites page shows:

• Favicon, title (as a clickable link), and the favorite star icon.
• URL, description (when present), folder badge (click it to jump to the folder), and tags.
• Last visited and Updated timestamps.
• An Edit button (when you have write permission).

All Bookmarks list

The All Bookmarks view (/bookmarks/list) shows every bookmark across all your circles in a single searchable, sortable, paginated list.

Search

Type any term into the search bar and press Search. The query is matched against titles, URLs, and descriptions. A Clear button resets the search instantly.

Sort order

| Option | Behaviour | |--------|-----------| | Newest | Most recently created bookmarks first (default). | | Most Visited | Bookmarks you open most often rise to the top. |

Pagination

Choose how many items appear per page: 10, 20, 50, or 100. Page navigation buttons appear at the bottom when there are more results than fit on a single page.

All Folders list

The All Folders view shows every root-level folder (folders with no parent) across all your circles, listed alphabetically. You can search by folder name and paginate through large collections.

Dashboard home

The Bookmarks home page provides an at-a-glance overview:

| Widget | Content | |--------|---------| | Recent Bookmarks | The 8 most recently added bookmarks with quick-open links. | | Favorites | Up to 6 starred bookmarks. | | Top Folders | Up to 8 root-level folders. | | Counters | Total bookmarks and total folders across all your circles. |

The dashboard also surfaces three orientation tips for new users (Browse Folders, Add Bookmark, View Favorites) that disappear once you're familiar with the layout.

Import from JSON

You can bulk-create a folder and its bookmarks in one operation by uploading a JSON file.

File format

{ "folderName": "Developer Resources", "bookmarks": [ { "title": "MDN Web Docs", "url": "https://developer.mozilla.org", "description": "The definitive HTML/CSS/JS reference", "tags": "html,css,javascript", "favorite": true }, { "title": "Can I Use", "url": "https://caniuse.com", "tags": "browser-support,css" } ]
}

Rules and limits

| Constraint | Value | |------------|-------| | Maximum file size | 512 KB | | folderName | Required, 1–200 characters, must not be blank | | bookmarks | Required array, at least 1 item | | title | Required per bookmark, 1–300 characters | | url | Required per bookmark, 1–2 000 characters | | description | Optional, max 1 000 characters | | tags | Optional comma-separated string | | favorite | Optional boolean, defaults to false | | Unknown fields | Not allowed — the import is rejected if extra fields are present |

How it works

1. You pick a target circle from a dropdown (only circles you belong to are offered).
2. The file is validated in full before anything is written. All errors are shown at once.
3. If validation passes, a new folder is created with the name from folderName and all bookmarks are placed inside it.
4. Either the entire import succeeds or nothing is written — there are no partial imports.

Circle management

What is a circle?

A circle is a workspace that groups users and their content. Every bookmark and folder belongs to exactly one circle. You only see content from circles you are a member of. This keeps personal, team, and project content cleanly separated.

Changing a bookmark's or folder's circle

Moving an item to a different circle requires ADMIN permission on the item's current circle. If you only have READ or WRITE access, the circle field is locked and a notice explains what to do.

When you have ADMIN permission, a circle autocomplete search field appears in the edit form. Type a few characters to search and select the destination circle. Only circles where you have WRITE access are eligible destinations.

Circle locked by folder

A bookmark inside a folder cannot have its circle changed independently. The notice reads:

The circle is determined by the folder this bookmark belongs to. To change the circle, move the bookmark to a different folder or remove it from its current folder.

Permissions summary

| Action | Required permission | |--------|-------------------| | View bookmarks and folders | READ on the item's circle | | Create a bookmark or folder | WRITE on the target circle | | Edit a bookmark or folder | WRITE on the item's circle | | Delete a bookmark or folder | WRITE on the item's circle | | Move an item to a different circle | ADMIN on the current circle + WRITE on the destination circle | | Import from JSON | WRITE on the selected target circle |

Buttons and form fields that require a permission you don't have are either hidden or disabled with a tooltip explaining what's needed.