Skip to content

Visual Studio Code extension that displays a customizable project logo in the sidebar for instant context recognition.

License

Notifications You must be signed in to change notification settings

fractalcode-mx/project-identifier

Repository files navigation

Fractalcode Logo        Project Identifier Logo

Project Identifier by Fractalcode

Project Identifier demo

Project Identifier is a Visual Studio Code extension designed to visually anchor your workflow. It displays a customizable project logo directly in the Explorer and Source Control sidebars, helping you instantly recognize which project context you are currently working in.

Its primary purpose is to reduce cognitive load and prevent context-switching errors, especially for developers who frequently juggle multiple open windows or similar-looking projects.

Features

  • Visual Context Anchor: Displays a clear, prominent image in your sidebar that acts as a visual totem for your project.
  • Customizable Logo: Easily swap the default logo for your project's brand, a framework icon, or any visual identifier you prefer (supports PNG, JPG, SVG, GIF, WEBP).
  • Persistent Configuration: Your selected image is saved per workspace. Close VS Code, restart your machine, or switch projects—your identifier remains exactly where you left it.
  • Integrated Experience: Uses native VS Code dialogs and theming to feel like a built-in part of the editor, not an external add-on.
  • Zero Config Start: Works out of the box with a default placeholder, requiring no complex setup files to get started.

Usage

Setting a Custom Image

  1. Look for the "PROJECT IMAGE" (or "IMAGEN DEL PROYECTO") view in your Explorer sidebar.
  2. Hover over the view title bar to reveal the Edit (Pencil) icon.
  3. Click the pencil icon.
  4. Select your desired image file from the native file dialog.
  5. The view will instantly update to show your new project identifier.

Resetting

Currently, the image is persisted in the workspace state. To change it, simply repeat the selection process with a new image.

Requirements

  • Visual Studio Code v1.102.0 or higher.

Extension Settings

This extension contributes the following views:

  • project-identifier.view.explorer: The identifier panel in the File Explorer.
  • project-identifier.view.scm: The identifier panel in the Source Control (Git) view.

Known Issues


Built with ❤️ by Fractalcode
Engineering robust solutions, one commit at a time.

About

Visual Studio Code extension that displays a customizable project logo in the sidebar for instant context recognition.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published