Flakepiles

by idlist
5
4
3
2
1
Score: 30/100

Description

Use a single file to collect small pieces of notes, stickies, code snippets and more. View and manage your notes in a horizontal or vertical masonry flow.

Reviews

No reviews yet.

Stats

3
stars
146
downloads
0
forks
35
days
2
days
2
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
2
total issues
2
open issues
0
closed issues
74
commits

Latest Version

2 days ago

Changelog

  • Fixed the issue where the "disable filtering" button under label panel is not working.

README file from

Github

Flakepiles 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 .zip archive, each Flake as a markdown file
  • Import the .zip archive 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 in vite-plugin-static-copy.
  • moment: Resolves vulnerability in obsidian (package). As the plugin itself uses dayjs instead and never touches moment, it's safe to have (possibly) inconsistent version with Obsidian.

Changelog

Changelog for 1.0 versions

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.