README file from
GithubFlakepiles for Obsidian
An Obsidian plugin to put small notes, stickies, code snippets and more in a single file, and manage them in a masonry layout.
Check the Obsidian Community Page to see what the plugin looks like.
This is a refactor of the original Flakepiles (legacy) with a change to license. The original plugin will remain as open source, and is available via BRAT.
Prerequisite
Somewhat newer version of Obsidian. The plugin relies on CSS field-sizing property that is kind of new.
Why
I don't want 100 .md files with 1 sentence each, and I'm pretty picky about information density.
Features
- UI design that (tried my best to) align with Obsidian's design language.
- View and manage your Flakes (small pieces of notes) in masonry layout, vertical or horizontal.
- Edit Flakes in place instead of having to open another window or dialog.
- A simple label and coloring system to categorize and archive your Flakes.
- Handy tools including sorting, searching, pinning and toggleable text wrapping.
- Easy to copy and paste your Flakes from everywhere to everywhere.
Plugin side:
- Flakepile
- Masonry layout
- Masonry direction (vertical / horizontal)
- (Sort of) mobile-adaptive layout
- Flake size settings and elastic sizing
- Auto expand on single image or block of code
- Flake sorting (time created, time modified, content)
- Flake
- Markdown rendering of Flake content
- Copy Flake content to clipboard
- Pinning a Flake
- Search
- Simple search for content
- Simple search for labels
- Flake labels
- Attach / detach labels to Flake
- Label color (as Flake color)
- Collapse certain labels on Flakes (display as
+N) - Hide Flakes with certain labels
Obsidian side:
- Optional Obsidian commands
- "Flake count" status bar item [1]
- Preview other markdown files via
[[file link]]
[1] Due to the nature of this plugin, other status bar items are hidden in flakepile view. Please let me know if you think some other status bar items should be displayed.
Long term goals
These are something I want to achieve if I've completed the core features and still have some extra time. Most of them are desktop-only features.
- Embed a Flake into another markdown file
- Export a Flakepile as markdown
- Export as a single markdown file
- Export as a
.ziparchive, each Flake as a markdown file
- Import the
.ziparchive mentioned above to a Flakepile - Import multiple markdown files to a Flakepile
- Search keywords highlighting (sounds challenging, though)
Non-goals
- Freedom / manual layout and sorting (consider using Canvas)
- Very large Flakepile support (not impossible, but lots of work)
- Live editing of a Flake (consider copying it to an editor and then back)
- Cross-file searching / Obsidian-wise searching (restricted by API)
- Global search indexing (restricted by API)
This plugin is primarily to fulfill my own use cases. For this reason, I would prioritize maintainability over adding unplanned features. I'm open to suggestions, though feature requests might be considered only when it's aligned to my own use case.
Technical details
Tech stack
Vite + Vue 3 + TypeScript + Sass.
File format
The underlying file format (.flakes) is plain (i.e., unencrypted) JSON. You can open it in an external editor to see the content, or check the data schema (here) in this repository.
Though not in a more common .md file, your data is still and always on your local machine. This also means that file-based syncing is supported out of the box (though without the ability to merge conflicts).
Build from source
If you want to build the plugin from source, you can clone this repository and:
npm i
npm run dev // Watch mode, works with hot reload [1]
npm run build:dev // One-time dev build without minification
npm run build // Build for production
[1] Hot reload
When running npm run build, the output files will also be copied to the dist folder, so that you don't need to manually select 3 files one by one.
Cache storage
This plugin uses IndexedDB with idb-keyval to store cache data, which means (by default) the data is stored in database keyval-store and table keyval.
Overrides in package.json
chokidar: Resolves vulnerability invite-plugin-static-copy.moment: Resolves vulnerability inobsidian(package). As the plugin itself usesdayjsinstead and never touchesmoment, it's safe to have (possibly) inconsistent version with Obsidian.
Changelog
Changelog for pre-1.0 versions
License
PolyForm Internal Use (c) i'DLisT 2026
- This is not open-source, but a source-available plugin.
- In short, you can do pretty much anything to it except redistribution.