Code Islands 🚀

Code Islands is a 2D map of shortcuts to files and folders, similar to a desktop or a strategy game map. It helps you navigate large repositories faster, especially when one-dimensional sidebar navigation and heavy tab usage become slow and distracting.

Problem It Solves

Finding the exact file or folder in the project sidebar can be slow and mentally draining.

How It Works

Press Alt+Cmd+T (Alt+Ctrl+T on Windows/Linux) to open your 2D map of shortcuts to key navigation entry points, such as features, pages, controllers, and more. Click any shortcut to instantly focus the corresponding file or folder in the project sidebar.

Why It Is Efficient

1. Spatial memory adapts quickly to fixed shortcut positions on a 2D map, which is often faster than scanning a constantly changing tree of expanded folders.
2. Your map typically shows up to 10 top-level entry points instead of a mixed list of 50-100 items in the sidebar.

How To Set Up Your Map

1. After installing Code Islands, press Alt+Cmd+T to open it (Alt+Ctrl+T on Windows/Linux). Note: the hotkey only works when the editor has focus, so click anywhere in your code first.
2. An empty map window will open. Click the Create button in the top-right corner.
3. In the project sidebar, right-click the file or folder you want, choose Copy Relative Path, then paste it into the path field in the modal.
4. Click Create.

How Data Is Stored

After any action (moving the map or a shortcut, creating, deleting, or editing a shortcut), a .bookmarks.json file is created or updated in the repository root. We recommend committing this file so you do not lose your layout and have to recreate shortcuts.

This project is licensed under the MIT License.

Developed with ❤️ by BrateMoj