Project Steward

Project Steward is a fork of Kruemelkatze/vscode-dashboard with additional support for remote project workflows, including SSH and Dev Container project records, a sidebar Project Steward panel, favorites, descriptions, and a command for saving the current project.

It keeps the original goal of Project Steward: organizing your projects in a speed-dial like manner. Pin your frequently visited folders, files, SSH remotes, and Dev Container projects onto a Project Steward panel to access them quickly.

Usage

The Project Steward panel is a dedicated UI that can be opened using a command or ctrl + F1 and configured to open automatically. Clicking a project opens it in the current window, while ctrl + click (cmd + click on Mac) opens it in a new window.

Projects are separated into groups and can be assigned a color to find them quickly. Managing the groups and projects is done directly on the Project Steward panel.

Good to know

• You can edit and reorder projects and groups directly on the Project Steward panel.
• Emojis may (or may not, depending on your preference) be good icons for projects. You can add them by pressing WIN + . (under Windows) while naming the project.
• You can use gradients as project color, via CSS Gradient functions like linear-gradient and radial-gradient.
• Only colors defined by the theme were used. So the Project Steward panel should always blend nicely into your VSCode design. If not, you can customize them in the settings.
• The extension automatically detects if a project is a Git repository. If so, this is indicated by an icon.
• The filter option can be toggled by ctrl + f or disabled via settings.

Configuration

The Project Steward panel can be configured and customized using the VSCode configuration:

• Projects are stored in the globalState by default (saved on the machine) but can be set to be saved in the settings (to be synced via Settings Sync) instead. Note that by doing so, you remove the possibility of having different Project Steward panels on your synced devices.
• Startup behavior (open always, on empty editor, or never)
• Placement of '+' buttons
• Visibility of project path
• Project tile size
• Filter option's default visibility
• Colors (see below)

By default, the Project Steward panel uses only colors defined by the theme, which was tested against all default themes. If you use a custom theme and see the Project Steward panel's colors unfit, you can change them in the settings (Settings > Project Steward). Following settings can be changed to any CSS color (name, hex, rgba, hsl, var) or left empty (for default):

• Project Card Background
• Project Name Color
• Project Path Color

Changelog

View Changelog

Acknowledgements

• Special thanks to Font Awesome (License) for the icons used in the Project Steward panel.
• The color names are generated using the Name that Color library.