Squarl Bookmarks

Bookmark important files and/or links for your projects.

Why Squarl Bookmarks

Every project has various dependencies, not only the onces we use to code, but also the once around the project. Like: task lists, project management, documentation, ...

In most cases, you share this information of which platforms and/or systems used with your team. What if you can bring it closer to the project?

This is the purpose of Squarl Bookmarks to allow you and your team to create and share these bookmarks. Instead of opening your browser, looking for the project bookmark, and navigating to it. You can now add the bookmark in your project and navigate instantly from within Visual Studio Code to it.

You can use Squarl Bookmarks to store bookmarks personally (in VS Code .vscode/settings.json or the global user settings) or with your team (via a squarl.json file).

Features

The extension comes with the following features:

Add files or links to your bookmarks list
Search through all the bookmarks in your list
Create groups
Deleted project files are shown in a seperate group

How to use it

The intention of the Squarl Bookmarks extension is to allow you to be able to quickly navigate to any of your important project files or links.

You can use the extension for personal or team purposes.

Personal

When you install the extension, and open the Squarl Bookmarks panel. You will see the welcome view with the ability to add a file or link.

Another way to add a file or link to your bookmarks list, is to use one of the commands:

Squarl: Bookmark link (squarl.bookmark.addLink)
Squarl: Bookmark file (squarl.bookmark.addFile)

Once you've added bookmarks, the view will be updated to the bookmarks list view.

Note: Global bookmarks are stored in the Visual Studio Code global user settings, the project bookmarks are stored in the .vscode/settings.json file of the current project.

Team

For team bookmarks, you'll need to create the team file, you can do this manually by creating a squarl.json file in the current project, or with the Squarl: Initialize team file (squarl.team.init) command.

Once the file is created, you can add your groups and bookmarks to it.

Initial file content:

{
  "name": "Team bookmarks",
  "groups": [],
  "bookmarks": []
}

The object structure of the group and bookmark items is the same as that of you personal bookmarks.

It is a manual process to add the groups and bookmarks to the file.

Once this file contains bookmarks, a team bookmarks view will appear.

Commands

The extension has the following commands for you to make use:

Command	Title
`squarl.bookmark.addFile`	Squarl: Bookmark file
`squarl.bookmark.addLink`	Squarl: Bookmark link
`squarl.bookmark.delete`	Squarl: Delete
`squarl.bookmark.demote`	Squarl: Demote
`squarl.bookmark.open`	Squarl: Open a bookmark
`squarl.bookmark.promote`	Squarl: Promote
`squarl.bookmark.search`	Squarl: Search for a bookmark
`squarl.group.assign`	Squarl: Assign group
`squarl.group.create`	Squarl: Create a bookmark group
`squarl.group.edit`	Squarl: Edit group
`squarl.group.delete`	Squarl: Delete group
`squarl.sort.down`	Squarl: Move down
`squarl.sort.up`	Squarl: Move up
`squarl.team.init`	Squarl: Initialize team file

Settings

The extension uses the following settings to manage the behavior:

Setting	Description	Default
`squarl.bookmarks`	The list of bookmarks	`[]`
`squarl.groups`	The list of groups you want to use	`[]`

Bookmark item

Bookmark items contain the following properties:

name: Name of the bookmark
path: Relative path to the file or URL
description: Description for your bookmark (optional)
type: file or link
groupId: ID of the group (optional)
iconName: Name of the icon to set for the link (optional)

Example:

{
  "name": "Bookmark title",
  "path": "<relative path to file> or <link>",
  "description": "Bookmark description",
  "type": "file|link",
  "groupId": "group",
  "iconName": "bookmark"
}

Group item

Group items contain the following properties:

id: ID of the group
name: Name of the group

Example:

{
  "id": "group",
  "name": "Group"
}

Contributors ✨

Contributing / Issues / feedback

If you want to contribute, you are more than welcome to do so. Feel free to start by opening an issue on the project repository in order to track the changes.

If you find a bug, or have some feedback, let us know by opening an issue in the project repository.

👉 Navigate to the issue list.

Changelog / Release notes

CHANGELOG

License

MIT

estruyf / vscode-squarl