Publish with Flowershow

by flowershow
5
4
3
2
1
Score: 54/100

Description

Publish your Obsidian vault as a website with Flowershow.

Reviews

No reviews yet.

Stats

76
stars
12,716
downloads
5
forks
171
days
1
days
2
days
22
total PRs
1
open PRs
8
closed PRs
13
merged PRs
29
total issues
1
open issues
28
closed issues
44
commits

Latest Version

2 days ago

Changelog

What's Changed

Fix publish status for vaults with more than 1,000 files. The status check sent the whole vault to the server in one request; above 1,000 files the server rejected it and the plugin silently listed every file as "New". Together with the server-side fix, large vaults now show the right Changed/New/Deleted files. Publishing and unpublishing more than 1,000 files (or more than 500 MB) at once now goes out in batches, and if the status check fails the plugin shows the error instead of guessing.

README file from

Github

💐 Publish with Flowershow (Obsidian Plugin)

Publish your Obsidian vault online easily, quickly and for free directly from your Obsidian vault using Flowershow.

Getting Started

Here is how you can publish your Obsidian vault with Flowershow:

STEP 1: Install the Flowershow Plugin

  1. Open Obsidian.
  2. Go to Settings > Community Plugins.
  3. Search for "Flowershow" and click Install.
  4. Enable the plugin once installed.

STEP 2: Sign Up and Create a Site

  1. Sign up for a free account at https://cloud.flowershow.app/login.
  2. In the dashboard, click New Site and pick a name, e.g. my-notes. The plugin publishes to an existing site; it does not create one.

STEP 3: Generate a Personal Access Token

  1. Go to your Flowershow dashboard at https://cloud.flowershow.app/tokens.
  2. Create a new Personal Access Token (PAT).
  3. Copy the token (it starts with fs_pat_).

STEP 4: Configure the Plugin & Publish

  1. Go back to Obsidian and open the Flowershow plugin settings.
  2. Enter your Flowershow PAT token, and set Site Name to your site's name exactly as it appears in the dashboard (e.g. my-notes, not its URL).
  3. Use "Flowershow" commands or click on the Flowershow icon in the ribbon and select the notes to publish — and that's it!

That's it! Your notes are now ready to be shared with the world! 💐

Full docs at https://flowershow.app/docs/

Publication Status Panel

The Flowershow icon in your ribbon opens the Publication Status panel, which shows:

  • Changed: Published files that have been edited locally.
  • New: New files in your Obsidian vault that have not yet been published.
  • Deleted: Files that have been deleted from your Obsidian vault but are still published on Flowershow.
  • Unchanged (select to unpublish): All unchanged and published files.

Plugin Settings

Flowershow Authentication
  • Personal Access Token: Your Flowershow PAT token (starts with fs_pat_). Generate one at https://cloud.flowershow.app/tokens.
  • Site Name: The name of an existing Flowershow site, exactly as shown in your dashboard (e.g. my-notes). Not the site's URL or custom domain.
Publishing Settings
  • Exclude Patterns: Regex patterns to exclude files and folders from being published.
    • Example: ^private/ excludes the private directory.
Configuration Files

Both custom.css and config.json files can be edited locally and published with the plugin:

Available Commands

  • Flowershow: Publish single note (with embeds) - Publishes the current note with its embeds. This will publish the current note and any embedded content, but generally won't publish linked notes.
  • Flowershow: Publish all - Publishes all files in your vault by comparing your local vault with your Flowershow site, taking into account exclude settings. Unlike single note publishing, this doesn't process embeds but rather synchronizes the entire vault content with Flowershow.

Excalidraw Support

To publish Excalidraw drawings with Flowershow, configure the Excalidraw plugin to:

  1. Export drawings as SVG/PNG files
  2. Use exported files in note links

In Excalidraw plugin settings:

  1. Go to "Embedding Excalidraw into your Notes and Exporting"
  2. Go to "Export settings"
  3. Go to "Auto-export settings"
  4. Enable "Auto-export SVG" or "Auto-export PNG"
  5. Enable "Keep the .SVG and/or .PNG filenames in sync..." (if you want)
  6. Go to the top of the main section and in "Type of file to insert into the document" select "SVG" or "PNG"

This ensures your drawings will be properly published and displayed on your Flowershow site.


Development

Setup

  1. Clone the repository and install dependencies:
git clone https://github.com/flowershow/obsidian-flowershow
cd obsidian-flowershow
npm install
  1. Symlink the plugin folder into your test vault's plugins directory:
mkdir -p /path/to/your-vault/.obsidian/plugins
ln -s /path/to/obsidian-flowershow /path/to/your-vault/.obsidian/plugins/flowershow
  1. Build the plugin:
npm run build
  1. In Obsidian, open your test vault, go to Settings → Community plugins, and enable Flowershow.

Dev mode (rebuild on save)

Run the dev server to automatically rebuild whenever you edit source files:

npm run dev

You'll still need to manually reload the plugin in Obsidian after each rebuild (Settings → Community plugins → disable then re-enable Flowershow), unless you set up hot reloading below.

Hot reloading (auto-reload in Obsidian)

The Hot Reload plugin detects when main.js changes and automatically reloads your plugin — no manual Obsidian restart needed.

  1. Install the Hot Reload plugin into your test vault:
mkdir -p /path/to/your-vault/.obsidian/plugins/hot-reload
curl -L https://github.com/pjeby/hot-reload/releases/latest/download/main.js \
  -o /path/to/your-vault/.obsidian/plugins/hot-reload/main.js
curl -L https://github.com/pjeby/hot-reload/releases/latest/download/manifest.json \
  -o /path/to/your-vault/.obsidian/plugins/hot-reload/manifest.json
  1. In Obsidian, go to Settings → Community plugins and enable Hot Reload.

  2. Create a .hotreload marker file in this plugin's folder so Hot Reload watches it:

touch /path/to/obsidian-flowershow/.hotreload

Now run npm run dev and any change you save will be rebuilt and reloaded in Obsidian automatically.

Shoutout

Big thanks to Ole Eskild Steensen for his obsidian-digital-garden plugin which inspired us and we got to build on.