samaraliwarsi16k downloadsA file browser that lets users add folders & tags as customizable tabs with icons, colors, and folder notes for easier navigation.
Portals enhances your Obsidian file navigation by letting you pin any folder or tag as a customisable tab, a Portal into your selected folder trees. Add icons to Tabs, background colours, gradients and rearrange them to suit your workflow.


data.json on Obsidian reload.Alt+Click or Swipe right. Use multi-select toolbar for actions. .trash folder at vault root. Settings.For a full featured guide, checkout Portals guide
[!Note]
- Please back up your data file after preferences setup, colour & icon choices. Copy the file
.obsidian/plugins/portals/data.jsonto a safe location. You can also export the same viaSettingsand later import it. Make sure to backup before any plugin updates.- Portals requires Obsidian 1.13.0 or later. If you're on an older version, update Obsidian please.
- For best results,
- On mobile: Works best with Baseline Theme as the theme renders vault on the top side. On other themes, turn off floating navigation in settings, i.e. Settings > Appearance > Floating Navigation.
- On desktop, you may need to turn off vault hiding if your theme hides the vault selector on the lower side.
- Auto backups – Enable in settings to save your configuration automatically on Obsidian reload.
https://github.com/samaraliwarsi/obsidian-portals..obsidian/plugins/portals/ folder.Right-click context menu on tabs.For detailed walkthroughs and tips, read the Portals Guide.
Clone the repository, install dependencies, and build:
git clone https://github.com/samaraliwarsi/obsidian-portals.git
cd obsidian-portals
npm install
npm run build
The built main.js and styles.css will be in the root folder. Copy them into your test vault’s .obsidian/plugins/portals/ directory.
This project is licensed under the MIT License. See the LICENSE file for details.