README file from
GithubSmart Folder View
Smart Folder View is an Obsidian plugin that turns a folder of notes into an interactive dashboard. It lets you build reusable pages with timeline and board layouts, metadata-based filters, stable color mapping, drag sorting, and saved presets.
Features
- Build saved dashboard pages from any folder in your vault.
- Switch between timeline view and board view.
- Filter notes by frontmatter fields with multi-select controls.
- Keep page state with saved profiles, presets, and last-opened page memory.
- Drag cards to reorder items in timeline and board layouts.
- Update ordering only, or update ordering together with a target field value.
- Undo the last drag action.
- Export a page definition back into your vault.
- Use Chinese or English UI.
- Configure generated card colors from a chosen metadata field.
Commands
- Create Smart Folder Page
- Manage Saved Pages
- Open Last Page
- Export Page
Command labels follow the plugin UI language and may appear in Chinese or English.
How It Works
Each saved page stores:
- a source folder
- an optional template file used to infer fields
- a color field
- a sort field and sort direction
- a set of display fields
- a preferred layout mode
- an optional board grouping field
The plugin opens a dedicated custom view and renders matching notes as cards. Filter state, presets, and manual ordering are persisted locally for each page.
Installation
Community Plugins
After approval and publication, install Smart Folder View from Obsidian's Community Plugins browser.
Manual Installation
- Open your vault's plugin folder:
.obsidian/plugins/. - Create a folder named
smart-folder-view. - Copy
main.js,manifest.json, andstyles.cssinto that folder. - Restart Obsidian or reload plugins.
- Enable Smart Folder View in Community Plugins.
Development Notes
- Source entry:
src/main.ts - Build output:
main.js - Release metadata:
manifest.json - Version compatibility map:
versions.json - Local state file:
data.json(not a release asset)
Build
npm install
npm run build
Watch mode
npm run dev
Release Checklist
- Update
manifest.jsonversion and minimum compatible Obsidian version. - Add the same version to
versions.json. - Create a GitHub release whose tag exactly matches the plugin version, for example
0.1.0. - Upload
main.js,manifest.json, andstyles.cssto the release assets. - Submit the repository to
obsidianmd/obsidian-releasesby adding an entry tocommunity-plugins.json.
License
MIT