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" means a small piece of note, and a "flakepile" is a pile of those flakes.

Can be used to store ideas, diaries, 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.

Status

The plugin is in early development, though basic features should now work properly. I've tested many cases I can think of, 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

Inside a 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 colors (theme)
  • Flake labels
    • Label creation, update, deletion
    • Add / remove label to flake
    • Label color
    • Hide some labels (display as +N)
    • Label filtering

Obsidian-wise:

  • "Create new flakepile" file menu option
  • "Flake count" status bar item [1]
  • Limited support to internal plugins
    • Preview other markdown file
    • 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 highlight
  • Copy flake across flakepiles (the "copy raw" botton is for this)
  • 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.

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