Bases Navigator

Bases Navigator is an Obsidian plugin for moving through files from a Bases view with arrow keys.

Open a .base file, click a file from the Bases table, then use the configured arrow keys to move to the previous or next file in that same Bases result order.

Features

• Navigate previous and next files from the last active Bases view.
• Use Left/Right or Up/Down arrow keys.
• Keep navigation in the same tab, or open/reuse tabs.
• Wrap from the last file to the first file.
• Return to the source Bases view with a command.
• Show the current navigation position from a command or the status bar.

Settings

• Enable Bases Navigator: Turn keyboard navigation on or off.
• View modes: Reading mode is enabled by default. Live Preview and Source mode are opt-in because they can conflict with cursor movement.
• Key pair: Choose Left/Right or Up/Down.
• Wrap around: Loop at the start or end of the list.
• Open behavior: Replace the current tab or open/reuse another tab.
• Show navigation notice: Show a toast after successful navigation.
• DOM scan debounce: Delay before re-scanning the Bases view after DOM changes.
• Debug mode: Enable console logging for troubleshooting.

Privacy

Bases Navigator does not access the network, collect analytics, or write to notes in your vault. It reads the visible Obsidian Bases view DOM to learn the current file order and uses Obsidian's workspace APIs to open files.

Known Limitations

• Bases is still evolving, so changes to Obsidian's internal Bases DOM may require a plugin update.
• Mobile support has not been verified for the first community release, so the plugin is marked desktop-only.
• Live Preview and Source mode support is optional and may interfere with normal text cursor movement.

Troubleshooting

• Turn on Debug mode in the plugin settings.
• Open the Obsidian developer console with Cmd+Option+I on macOS or Ctrl+Shift+I on Windows/Linux.
• Run Bases Navigator: Show current navigation position (debug) from the command palette and check the console output.
• Make sure the .base file is open and the Bases table includes a visible file.name column.
• If navigation uses the wrong order, click a file from the Bases table again so the plugin can refresh the active Bases context.

Manual Installation

1. Download main.js, manifest.json, and styles.css from a release.
2. Create this folder in your vault: .obsidian/plugins/bases-navigator/.
3. Put the three files in that folder.
4. Reload Obsidian and enable Bases Navigator in Community plugins.

Development

npm install
npm run dev
npm test
npm run check
npm run build

npm run check verifies that package.json, manifest.json, and versions.json agree on the current version and that the release assets exist. The release assets are main.js, manifest.json, and styles.css.

Feedback

Please open an issue in the GitHub repository if navigation does not match a Bases view or if a future Obsidian update changes Bases behavior.