Skip to content

An Obsidian plugin to put small stickies / cards in a single file, and manage them in masonry layout.

License

Notifications You must be signed in to change notification settings

idlist/flakepiles

Repository files navigation

Flakepiles for Obsidian

An Obsidian plugin to put small notes / stickies / cards in a dedicated file, and manage them in masonry layout.

A "flake" refers to a small piece of note, and a "flakepile" is a pile of those flakes. Forseeable use cases of the plugin includes collecting ideas, getting down short diaries, storing code snippets, and more.

The preview image is in horizontal layout. You can change this to vertical layout.

preview

Why

I don't want 100 .md files with 1 sentence each, and I'm picky about information density.

Status

The plugin is in early development, though basic functionalities should now work properly. I've tested it at my best, and I myself am using it currently, but please expect bug exists in corner cases.

Installation

The plugin is not published as Obsidian's community plugin yet.

Please use BRAT to install the plugin, or copy the files under the release tag to the plugin folder of your Obsidian application. You can also build it from source.

Tech Stack

Vite + Vue 3 + TypeScript + Sass

The underlying file format (.flakes) is JSON. See the non-goals section for explanation.

Roadmap

Flakepile:

  • Mount Vue into Obsidian
  • Flakepile
    • Masonry layout
    • Masonry direction (vertical / horizontal)
    • (Sort of) mobile-adaptive layout
    • Flake size
    • Flake elastic sizing
    • Flake sorting (name, time created, time modified)
  • Flake
    • Flake creation, update, deletion
    • Flake markdown rendering
    • Text flake
    • Image flake
    • Code flake
  • Search filter inside a flakepile
  • Flake labels
    • Label creation, update, deletion
    • Add / remove label to flake
    • Label color
    • Simple display of labels in flakes (display as +N)
    • Hide flake with labels
  • Flake colors

Obsidian:

  • "New flakepile" command & file menu option.
  • "Flake count" status bar item [1]
  • Limited support to internal plugins
    • Preview other markdown files via [[file link]]
    • Jump to global search when clicking on a tag

[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 status bar item should be displayed.

Long term goals

  • Search keywords highlighting
  • Move and copy one or multiple flakes across flakepiles
  • Embed a flake into a markdown file
  • Export files to markdown files
    • Export as a single markdown file
    • Export as a .zip archive, each flake as a markdown file
  • Import the .zip archive to a flakepile
  • Import multiple markdown files to Flakes

Non-goals

  • Freedom / manual layout (consider using Canvas)
  • Very large flakepile support (not the very intended way)
  • Live editing of a flake (too complex)
  • Cross-file searching / Obsidian-wise searching (restricted by API)
  • Global search indexing (restricted by API)
  • Unit testing (do not have enough time)

I recognize that this plugin is not so an Obsidian-style plugin, as it does not leverage markdown file like many other plugins do. On the other hand, this has the benefit of not having to juggle with black magics that makes a markdown file look like other layout (when the layout itself is quite complicated).

Also, this plugin is primarily to fulfill my specific need. 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. 🙏

Build from source

If you want to take a look inside the development of the plugin, or just want to ensure maximum safety, you can clone this repository and build from source:

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 be copied to dist folder.

Changelog

Changelog for pre-1.0 versions

License

MIT © i'DLisT 2026

About

An Obsidian plugin to put small stickies / cards in a single file, and manage them in masonry layout.

Topics

Resources

License

Stars

Watchers

Forks