<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom" xmlns:dc="http://purl.org/dc/elements/1.1/">
  <channel>
    <title>DEV Community: Flowershow</title>
    <description>The latest articles on DEV Community by Flowershow (flowershow).</description>
    <link>https://dev.to/flowershow</link>
    <image>
      <url>https://media2.dev.to/dynamic/image/width=90,height=90,fit=cover,gravity=auto,format=auto/https:%2F%2Fdev-to-uploads.s3.us-east-2.amazonaws.com%2Fuploads%2Forganization%2Fprofile_image%2F6194%2Fd50bb5ad-af78-4dcb-bb0a-4fee41768dfc.png</url>
      <title>DEV Community: Flowershow</title>
      <link>https://dev.to/flowershow</link>
    </image>
    <atom:link rel="self" type="application/rss+xml" href="https://dev.to/feed/flowershow"/>
    <language>en</language>
    <item>
      <title>Notion vs Markdown: the honest comparison</title>
      <dc:creator>Asdra</dc:creator>
      <pubDate>Fri, 28 Aug 2026 22:16:16 +0000</pubDate>
      <link>https://dev.to/flowershow/notion-vs-markdown-the-honest-comparison-4hg4</link>
      <guid>https://dev.to/flowershow/notion-vs-markdown-the-honest-comparison-4hg4</guid>
      <description>&lt;p&gt;"Notion vs Obsidian" is the wrong framing — that's app vs app. The real comparison is app vs stack: can a markdown setup give you what Notion gives you, out of files you actually own? Mostly yes. Sometimes better. Occasionally, no.&lt;/p&gt;

&lt;p&gt;We ran the full comparison on &lt;a href="https://wayofmarkdown.com" rel="noopener noreferrer"&gt;The Way of Markdown&lt;/a&gt;. It's not a hit piece — Notion wins some of these outright. Here's the shape of it.&lt;/p&gt;

&lt;p&gt;Notion isn't competing against "markdown" — that's just a format — it's competing against a small stack: Obsidian for the editor, Bases for database-style views over your files, git for sync and history, a publisher for the "share to web" button, and AI tools that read your files directly.&lt;/p&gt;

&lt;p&gt;A few categories go one way or the other with no real contest.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Markdown wins&lt;/strong&gt; wikis and linking (native, not bolted on), offline use (total — the files just sit on your disk), history (a full git log going back to day one), lock-in and exit (there's nothing to export, because nothing was trapped to begin with), and AI on your content (agents work directly in your vault, no API required).&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Notion wins&lt;/strong&gt; real-time co-editing — genuinely good, and git is asynchronous by design so this isn't close. It wins page-level permissions, since repo-level access is the ceiling on the markdown side. And it wins zero-setup polish: sign up versus assembling two or three tools yourself.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Databases are closer than people assume&lt;/strong&gt;. Notion's relational views are still ahead for heavy use, but Obsidian Bases closed most of the gap this year for lighter use — which covers most people's actual needs.&lt;/p&gt;

&lt;p&gt;The trend line matters more than the snapshot. The database gap has been closing from the markdown side, and AI closed the smart-features gap from the other side, almost overnight. Meanwhile Notion's real advantages — real-time editing, granular permissions — come from the same centralized database that creates the lock-in. You can't get one without the other, in either direction.&lt;/p&gt;

&lt;p&gt;Full scorecard (14 categories, feature by feature) and the honest "choose X if" breakdown: &lt;a href="https://wayofmarkdown.com/notion-vs-markdown?utm_source=devto&amp;amp;utm_medium=social&amp;amp;utm_campaign=devto-2" rel="noopener noreferrer"&gt;wayofmarkdown.com/notion-vs-markdown&lt;/a&gt;&lt;/p&gt;

</description>
      <category>markdown</category>
      <category>notion</category>
      <category>opensource</category>
      <category>productivity</category>
    </item>
    <item>
      <title>The Markdown Database Pattern</title>
      <dc:creator>Asdra</dc:creator>
      <pubDate>Fri, 28 Aug 2026 00:13:10 +0000</pubDate>
      <link>https://dev.to/flowershow/the-markdown-database-pattern-4n84</link>
      <guid>https://dev.to/flowershow/the-markdown-database-pattern-4n84</guid>
      <description>&lt;p&gt;Your filesystem is already a database. Most tools just don't treat it that way.&lt;/p&gt;

&lt;p&gt;That's the core idea behind the &lt;strong&gt;Markdown Database Pattern&lt;/strong&gt; — written up properly on &lt;a href="https://wayofmarkdown.com" rel="noopener noreferrer"&gt;The Way of Markdown&lt;/a&gt;, a site we've been contributing to that makes the case for building things on plain markdown instead of locked-in platforms. We think it's a pattern worth more attention, so here's the short version.&lt;/p&gt;

&lt;p&gt;Treat a folder of markdown files as a database. Each file is a record. Frontmatter fields are columns. Directories are tables. Tags, wikilinks, and tasks in the body become queryable relations.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;Filesystem              Database
──────────────────────────────────
markdown file      →    record
frontmatter field  →    column
directory          →    table
#tag               →    tag relation
[[wikilink]]       →    link relation
- [ ] task         →    task relation
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You get portability, version control (git works perfectly on plain text), no framework lock-in, and full queryability. You give up scale and real relational joins — this isn't for millions of records. It's a &lt;em&gt;lightweight&lt;/em&gt; database, honest about its limits.&lt;/p&gt;

&lt;p&gt;Once you name it, you start seeing it everywhere. Obsidian Bases and Dataview already do versions of this, half-consciously. A team wiki where every page has a &lt;code&gt;status&lt;/code&gt; and &lt;code&gt;owner&lt;/code&gt; field is one. A blog with &lt;code&gt;date&lt;/code&gt; and &lt;code&gt;tags&lt;/code&gt; in frontmatter is one — it just doesn't know it yet.&lt;/p&gt;

&lt;p&gt;Sweet spot: up to roughly 10k files. Past that, reach for a real database. Below it, this gets you almost everything a database gives you, at a fraction of the complexity, with none of the lock-in.&lt;/p&gt;

&lt;p&gt;The full writeup — the complete tradeoff analysis, a worked example with actual queries, how to implement it in a weekend, and the tool (&lt;a href="https://github.com/flowershow/markdowndb" rel="noopener noreferrer"&gt;MarkdownDB&lt;/a&gt;) that does it for you — is here: &lt;a href="https://wayofmarkdown.com/markdown-database?utm_source=devto&amp;amp;utm_medium=social&amp;amp;utm_campaign=devto-1" rel="noopener noreferrer"&gt;wayofmarkdown.com/markdown-database&lt;/a&gt;&lt;/p&gt;

</description>
      <category>productivity</category>
      <category>opensource</category>
      <category>obsidian</category>
      <category>markdown</category>
    </item>
    <item>
      <title>Turn your Obsidian Vault into a beautiful website with Flowershow!</title>
      <dc:creator>Theo Bertol</dc:creator>
      <pubDate>Fri, 06 Feb 2026 14:11:01 +0000</pubDate>
      <link>https://dev.to/flowershow/turn-your-obsidian-vault-into-a-beautiful-website-with-flowershow-14ee</link>
      <guid>https://dev.to/flowershow/turn-your-obsidian-vault-into-a-beautiful-website-with-flowershow-14ee</guid>
      <description>&lt;p&gt;Hey 👋&lt;/p&gt;

&lt;p&gt;If you use &lt;strong&gt;Obsidian&lt;/strong&gt; and have ever wanted to publish your notes as a website, we’ve built something that makes this easy.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Flowershow&lt;/strong&gt; lets you turn an Obsidian vault into a fast, clean website — perfect for blogs, notes, or digital gardens. And to make publishing simpler, we built an &lt;strong&gt;Obsidian plugin&lt;/strong&gt; that connects your vault directly to Flowershow.&lt;/p&gt;

&lt;h3&gt;
  
  
  Publish your vault to the web — directly from Obsidian
&lt;/h3&gt;

&lt;p&gt;With the Flowershow Obsidian plugin, you can publish your notes without setting up repositories or dealing with complex workflows.&lt;/p&gt;

&lt;p&gt;The idea is simple:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;Install the plugin&lt;/li&gt;
&lt;li&gt;Connect it to Flowershow&lt;/li&gt;
&lt;li&gt;Click &lt;strong&gt;Publish&lt;/strong&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;Your notes are uploaded, built, and published as a website — straight from Obsidian.&lt;/p&gt;

&lt;p&gt;No Git required.&lt;br&gt;
No command line.&lt;br&gt;
Just write, then publish.&lt;/p&gt;

&lt;p&gt;If that sounds useful, you can learn more here:&lt;br&gt;
👉 &lt;a href="https://flowershow.app/blog/announcing-obsidian-plugin-4" rel="noopener noreferrer"&gt;https://flowershow.app/blog/announcing-obsidian-plugin-4&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;We’d love to hear what you think 🌸&lt;/p&gt;

</description>
      <category>obsidian</category>
      <category>markdown</category>
      <category>opensource</category>
      <category>blogging</category>
    </item>
    <item>
      <title>Flowershow now supports HTML publishing!</title>
      <dc:creator>Theo Bertol</dc:creator>
      <pubDate>Thu, 29 Jan 2026 15:45:36 +0000</pubDate>
      <link>https://dev.to/flowershow/flowershow-now-supports-html-publishing-27mn</link>
      <guid>https://dev.to/flowershow/flowershow-now-supports-html-publishing-27mn</guid>
      <description>&lt;h1&gt;
  
  
  Flowershow now supports raw HTML publishing! 🚀
&lt;/h1&gt;

&lt;p&gt;Sometimes converting to Markdown just feels wrong—whether it’s a hand-coded portfolio, a data dashboard, or a custom landing page. You want the file exactly as it is.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The Old Way:&lt;/strong&gt; Piling HTML into Markdown blocks, fighting &lt;code&gt;layout: plain&lt;/code&gt; frontmatter, and hoping the parser didn't break your CSS. It was brittle and frustrating.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;The New Way:&lt;/strong&gt; Drop your &lt;code&gt;.html&lt;/code&gt; file into your content folder and publish.&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;flowershow publish index.html
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;

&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;No configuration needed.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;No formatting errors.&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;
&lt;strong&gt;Mix-and-match:&lt;/strong&gt; Keep your docs in Markdown, but use raw HTML for custom landing pages or HTML reports&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;&lt;strong&gt;It just works.&lt;/strong&gt;&lt;/p&gt;

&lt;p&gt;Check out the full announcement:&lt;a href="https://flowershow.app/blog/announcing-html-support" rel="noopener noreferrer"&gt;https://flowershow.app/blog/announcing-html-support&lt;/a&gt;&lt;/p&gt;

</description>
      <category>indiedev</category>
      <category>html</category>
      <category>publishing</category>
      <category>coding</category>
    </item>
    <item>
      <title>Turn your Obsidian vault into dynamic galleries with Obsidian Bases</title>
      <dc:creator>Theo Bertol</dc:creator>
      <pubDate>Mon, 26 Jan 2026 17:26:08 +0000</pubDate>
      <link>https://dev.to/flowershow/turn-your-obsidian-vault-into-dynamic-galleries-with-obsidian-bases-3ofj</link>
      <guid>https://dev.to/flowershow/turn-your-obsidian-vault-into-dynamic-galleries-with-obsidian-bases-3ofj</guid>
      <description>&lt;p&gt;If you use Obsidian, you probably have "collections" – a folder of books you've read, a directory of project notes, or a list of recipes.&lt;/p&gt;

&lt;p&gt;Usually, these notes have metadata (frontmatter) — covers, ratings, dates, tags.&lt;/p&gt;

&lt;p&gt;You often want to list them in a nice way, displaying those fields (like a gallery of book covers with ratings), instead of just a text list.&lt;/p&gt;

&lt;p&gt;But automatically generating these views on a static site is hard. You often end up manually maintaining a brittle Markdown list (&lt;code&gt;- [[Book A]]&lt;/code&gt;, &lt;code&gt;- [[Book B]]&lt;/code&gt;). It’s tedious, and it breaks the moment you add a file but forget to update the index.&lt;/p&gt;

&lt;p&gt;We added &lt;strong&gt;Obsidian Bases&lt;/strong&gt; support to Flowershow to fix this.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;filters:
  file.folder == "books"
views:
  - type: cards
    image: cover_image
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Flowershow takes that, scans your folder, and renders a beautiful, filterable grid of cards.&lt;br&gt;
It lets you define dynamic views — like Cards or Tables — directly in your Markdown.&lt;/p&gt;

&lt;p&gt;Instead of writing a list, you write a query:&lt;br&gt;
&lt;strong&gt;Check out our Announcement Blog here:&lt;/strong&gt; &lt;a href="https://flowershow.app/blog/announcing-obsidian-bases-beta" rel="noopener noreferrer"&gt;https://flowershow.app/blog/announcing-obsidian-bases-beta&lt;/a&gt;&lt;/p&gt;

</description>
      <category>markdown</category>
      <category>obsidian</category>
      <category>publishing</category>
      <category>indiedev</category>
    </item>
    <item>
      <title>I wanted to publish one Markdown file, not start a project</title>
      <dc:creator>Theo Bertol</dc:creator>
      <pubDate>Wed, 21 Jan 2026 22:46:58 +0000</pubDate>
      <link>https://dev.to/flowershow/i-wanted-to-publish-one-markdown-file-not-start-a-project-18o2</link>
      <guid>https://dev.to/flowershow/i-wanted-to-publish-one-markdown-file-not-start-a-project-18o2</guid>
      <description>&lt;p&gt;Most publishing tools assume you’re building something permanent.&lt;/p&gt;

&lt;p&gt;But a lot of writing doesn’t look like that.&lt;/p&gt;

&lt;p&gt;Sometimes it’s a single Markdown file sitting on your machine. You’ve finished writing, and all you want is a link you can share.&lt;/p&gt;

&lt;p&gt;We built a small &lt;strong&gt;CLI&lt;/strong&gt; for that moment.&lt;/p&gt;

&lt;p&gt;The &lt;em&gt;Flowershow CLI&lt;/em&gt; lets you publish directly from your terminal — without setting up a repo or clicking through a dashboard.&lt;/p&gt;

&lt;p&gt;&lt;strong&gt;Quick start&lt;/strong&gt;&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npm i &lt;span class="nt"&gt;-g&lt;/span&gt; @flowershow/publish
publish auth login
publish ./my-folder
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;&lt;strong&gt;Done!&lt;/strong&gt; You'll get a ready to share URL!&lt;/p&gt;

&lt;p&gt;If you make changes later:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;publish &lt;span class="nb"&gt;sync&lt;/span&gt; ./my-folder
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;This doesn’t replace UI-based workflows. It’s for people who already live in their editor and terminal and want publishing to feel like part of the same flow.&lt;/p&gt;

&lt;p&gt;&lt;em&gt;It’s currently in beta and requires Node.js.&lt;/em&gt;&lt;br&gt;
Docs cover the details, or you can explore via publish &lt;code&gt;--help&lt;/code&gt;.&lt;br&gt;
Docs here: &lt;a href="https://flowershow.app/docs/cli" rel="noopener noreferrer"&gt;https://flowershow.app/docs/cli&lt;/a&gt;&lt;br&gt;
Blog here: &lt;a href="https://flowershow.app/blog/announcing-flowershow-cli" rel="noopener noreferrer"&gt;https://flowershow.app/blog/announcing-flowershow-cli&lt;/a&gt;&lt;/p&gt;

</description>
      <category>markdown</category>
      <category>indiedev</category>
      <category>publishing</category>
      <category>cli</category>
    </item>
    <item>
      <title>Publishing Markdown shouldn’t be a side project</title>
      <dc:creator>Ola Rubaj</dc:creator>
      <pubDate>Mon, 19 Jan 2026 18:20:59 +0000</pubDate>
      <link>https://dev.to/flowershow/publishing-markdown-shouldnt-be-a-side-project-33ei</link>
      <guid>https://dev.to/flowershow/publishing-markdown-shouldnt-be-a-side-project-33ei</guid>
      <description>&lt;p&gt;A while back we shared a Next.js template - &lt;strong&gt;Flowershow&lt;/strong&gt; - for &lt;strong&gt;turning Markdown into a website&lt;/strong&gt;. It worked well—but it also came with the usual costs: setup, configuration, deployment, and ongoing maintenance.&lt;/p&gt;

&lt;p&gt;So we built a &lt;strong&gt;new version&lt;/strong&gt; of Flowershow: an &lt;strong&gt;open-source&lt;/strong&gt;, &lt;strong&gt;fully hosted&lt;/strong&gt; platform for publishing Markdown as a real website.&lt;/p&gt;

&lt;p&gt;The focus is simple: write in Markdown, publish, and move on.&lt;/p&gt;

&lt;p&gt;With hosted Flowershow you can:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;Publish docs, notes, blogs, or small product sites in minutes&lt;/li&gt;
&lt;li&gt;Use your own domain and customize the look without touching code&lt;/li&gt;
&lt;li&gt;Get built-in features like full-text search and comments out of the box&lt;/li&gt;
&lt;li&gt;Skip servers, CI pipelines, Docker, and framework decisions entirely&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;It works well for:&lt;/p&gt;

&lt;ul&gt;
&lt;li&gt;project documentation&lt;/li&gt;
&lt;li&gt;indie product websites&lt;/li&gt;
&lt;li&gt;“learning in public” blogs&lt;/li&gt;
&lt;li&gt;internal or public knowledge bases / wikis.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;Anywhere Markdown already fits, but hosting feels like unnecessary overhead.&lt;/p&gt;

&lt;p&gt;If you enjoy writing in Markdown but don’t want publishing to become another thing to maintain, this might be useful:&lt;/p&gt;

&lt;p&gt;👉 &lt;a href="https://flowershow.app" rel="noopener noreferrer"&gt;https://flowershow.app&lt;/a&gt;&lt;br&gt;
👀 &lt;a href="https://github.com/flowershow/flowershow" rel="noopener noreferrer"&gt;https://github.com/flowershow/flowershow&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;We’re building this in the open and will share updates as it evolves.&lt;br&gt;
Feedback, ideas, and rough edges are very welcome. 💐&lt;/p&gt;

</description>
      <category>markdown</category>
      <category>documentation</category>
      <category>devtools</category>
    </item>
    <item>
      <title>Publish your digital garden with Flowershow 🌷</title>
      <dc:creator>Ola Rubaj</dc:creator>
      <pubDate>Mon, 07 Nov 2022 00:51:12 +0000</pubDate>
      <link>https://dev.to/flowershow/publish-your-obsidian-vault-with-flowershow-48ip</link>
      <guid>https://dev.to/flowershow/publish-your-obsidian-vault-with-flowershow-48ip</guid>
      <description>&lt;h2&gt;
  
  
  What is Flowershow?
&lt;/h2&gt;

&lt;p&gt;Flowershow 🌷 is a &lt;strong&gt;free&lt;/strong&gt; and &lt;strong&gt;open-source&lt;/strong&gt; tool for easily converting your markdown files into an elegant website. It's built on a standard, modern web stack – &lt;strong&gt;React, Next.js, and Tailwind&lt;/strong&gt; and shipped with a basic default theme to get you started with just a few clicks🖱️.&lt;/p&gt;

&lt;p&gt;&lt;a href="https://flowershow.app/"&gt;https://flowershow.app/&lt;/a&gt;&lt;/p&gt;

&lt;p&gt;Following the steps below, or using our &lt;a href="https://flowershow.app/docs/publish-tutorial"&gt;tutorial&lt;/a&gt;, you can turn your markdown notes into an elegant website and tailor it to your needs.&lt;/p&gt;

&lt;h2&gt;
  
  
  1. Prepare the content
&lt;/h2&gt;

&lt;blockquote&gt;
&lt;p&gt;🚧 Flowershow CLI is not yet supported on Windows&lt;br&gt;
❕ Make sure you have &lt;a href="https://nodejs.org/en/"&gt;Node.js&lt;/a&gt; installed&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;First, you'll need a folder with some markdown files you'd like to publish. You can use an existing one, e.g. your Obsidian vault. This folder should include at least a single &lt;code&gt;index.md&lt;/code&gt; file at the root level, which will be used to generate the home page of your website. If it doesn't exist, Flowershow CLI will create it for you.&lt;/p&gt;

&lt;p&gt;To create this folder from scratch, you can do:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;mkdir &lt;/span&gt;my-digital-garden
&lt;span class="nb"&gt;cd &lt;/span&gt;my-digital-garden
&lt;span class="nb"&gt;echo&lt;/span&gt; &lt;span class="s1"&gt;'Hello, world!'&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt; index.md
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You can create as many subfolders within your content folder as you want. Its directory tree will be reflected in URL paths on the published website, e.g.: &lt;code&gt;my-digital-garden/blog/hello.md&lt;/code&gt; file content will be available under &lt;code&gt;&amp;lt;base-url-of-your-published-website&amp;gt;/blog/hello&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;Each folder can have its own &lt;code&gt;index.md&lt;/code&gt; file, which will be available under its parent directory path, e.g. &lt;code&gt;my-content/blog/index.md&lt;/code&gt; will be available under &lt;code&gt;&amp;lt;base-url-of-your-published-website&amp;gt;/blog&lt;/code&gt;.&lt;/p&gt;

&lt;p&gt;In order to embed files (e.g. images or pdfs) in your markdown files, you will also need to create a dedicated folder for them in your digital garden directory.&lt;/p&gt;

&lt;blockquote&gt;
&lt;p&gt;If you're an Obsidian user, you can set this folder as an attachments folder, by right-clicking on it in the sidebar on the left hand side. This way all embedded files will be saved to this folder automatically when you copy them to your notes.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;p&gt;You can create this folder by running:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;mkdir &lt;/span&gt;my-digital-garden/assets &lt;span class="c"&gt;#this can be any other name&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;blockquote&gt;
&lt;p&gt;If you don't use git version control system to track changes in your digital garden yet, we recommend setting it up. Check &lt;a href="https://docs.github.com/en/get-started/quickstart"&gt;GitHub quickstart&lt;/a&gt; to learn more.&lt;/p&gt;
&lt;/blockquote&gt;

&lt;h2&gt;
  
  
  2. Install Flowershow template
&lt;/h2&gt;

&lt;p&gt;In order to build your beautiful personal website out of your digital garden, you first need to install Flowershow template. This template will be linked to your digital garden after the installation process.&lt;/p&gt;

&lt;p&gt;So, let's imagine you have the following folder structure:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;some-parent-dir
├── my-digital-garden
│   ├── assets
│   └── index.md
└── ...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;If you want to install Flowershow in &lt;code&gt;some-parents-dir&lt;/code&gt; you can either:&lt;/p&gt;

&lt;ol&gt;
&lt;li&gt;go to that directory and run &lt;code&gt;npx flowershow@latest install&lt;/code&gt;
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;&lt;span class="nb"&gt;cd &lt;/span&gt;some-parent-dir
npx flowershow@latest &lt;span class="nb"&gt;install&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;You'll be asked to confirm if you want to install it in the current directory.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;? Create Flowershow project in current directory? Yes
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;ol&gt;
&lt;li&gt;...or you can pass this directory as an argument to the install command.
&lt;/li&gt;
&lt;/ol&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx flowershow@latest &lt;span class="nb"&gt;install &lt;/span&gt;some-parent-dir
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;After running the install command you'll be shown a set of prompts, that will allow you to properly set up Flowershow with your digital garden.&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight plaintext"&gt;&lt;code&gt;? Path to the folder with your content files
my-digital-garden

? Select a folder with your assets (attachments) (Use arrow keys)
❯ assets
  ──────────────
  I don't need assets folder
  Cancel

🌷 Installing Flowershow template in /home/me/some-parent-dir/.flowershow
⏳ Installing Flowershow dependencies...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;At the end you should see &lt;code&gt;.flowershow&lt;/code&gt; folder created in the target directory. In our example the folder structure will look like this:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;some-parent-dir
├── my-digital-garden
│   ├── assets
│   ├── config.js
│   └── index.md
├── .flowershow
└── ...
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;Note that &lt;code&gt;config.js&lt;/code&gt; and &lt;code&gt;index.md&lt;/code&gt; files will be created automatically if they didn't exist in your digital garden folder yet. The config file will allow you to do some basic configurations of your Flowershow app.&lt;/p&gt;

&lt;h2&gt;
  
  
  (Optional) customize your website
&lt;/h2&gt;

&lt;p&gt;You can now customize your website by wrapping your content in custom layouts, using custom components in you Markdown files, importing data from files and more.&lt;/p&gt;

&lt;h2&gt;
  
  
  Build your website
&lt;/h2&gt;

&lt;p&gt;You can preview your website locally by running the following command in the directory where &lt;code&gt;.flowershow&lt;/code&gt; has been installed:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx flowershow preview
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;...or by passing this directory as a command argument:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx flowershow preview some-parent-dir
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;After running this command, you will now be able to see your website on &lt;a href="http://localhost:3000/"&gt;http://localhost:3000/&lt;/a&gt; - it will reload every time you make some changes to your content.&lt;/p&gt;

&lt;p&gt;If you're ready to publish your site, you can now build it with the following command:&lt;br&gt;
&lt;/p&gt;

&lt;div class="highlight js-code-highlight"&gt;
&lt;pre class="highlight shell"&gt;&lt;code&gt;npx flowershow build-static
&lt;span class="c"&gt;# or npx flowershow build-static some-parent-dir&lt;/span&gt;
&lt;/code&gt;&lt;/pre&gt;

&lt;/div&gt;



&lt;p&gt;It will create a &lt;code&gt;.flowershow/out&lt;/code&gt; folder with all the resulting static files.&lt;/p&gt;

&lt;h2&gt;
  
  
  Feedback🙏
&lt;/h2&gt;

&lt;p&gt;Please take it for a spin and let us know your feedback in the &lt;a href="https://github.com/flowershow/flowershow/discussions"&gt;github discussion&lt;/a&gt; thread or our new &lt;a href="https://discord.gg/vQ5Y2uUzt6"&gt;discord chat&lt;/a&gt; forum.&lt;/p&gt;

</description>
    </item>
  </channel>
</rss>
