Flowershow

Flowershow 💐

ドキュメント、ナレッジベース、ウェブサイトなどの Markdown をすばやく簡単に公開

今すぐお試しいただき、https://flowershow.app/ で登録してください

実際の動作を見てみませんか？🎉 https://flowershow.app 自体も Flowershow 💐 で構築・公開されています。

• 📝 ドキュメント：https://flowershow.app/docs
• 🤖 AI 向け：https://flowershow.app/cli
• 💎 Obsidian 向け：https://flowershow.app/uses/obsidian

Flowershow は誇りを持ってオープンソースとして公開されています。

Flowershow は Datopian の製品です。データと知識の力を民主化することに取り組んでいます。

公開

ウェブサイトにログインするだけで、ドラッグ＆ドロップ、Obsidian（プラグイン）、Github などから数秒で公開できます。

コマンドライン（AI 向け）

CLI は fl という単一のバイナリです。

# Install (macOS / Linux)
curl -fsSL https://raw.githubusercontent.com/flowershow/flowershow/main/apps/cli/install.sh | sh

# Log in and publish a folder or file
fl login
fl ./my-notes

Windows の場合は、最新のリリースから fl_windows_amd64.zip をダウンロードし、fl.exe を PATH に配置してください。詳しくはCLI リファレンスをご覧ください。

AI エージェント（Claude、ChatGPT、Codex、Cursor）を使っていますか？https://flowershow.app/publish-with-ai をご覧ください。

---

---

開発者向け（Flowershow 自体への貢献）

Flowershow を使うのに、以下の内容は必要ありません。 インストールして公開するには、上記のインストールと公開をご覧ください。このセクションは、ソースから Flowershow プラットフォームを開発する方向けです。

モノレポの構成

これは pnpm ワークスペースで管理される Turborepo モノレポです。

apps/
  flowershow/           # Next.js web application (flowershow.app)
  cli/                  # Go CLI (`fl`) — publish markdown files from the terminal or AI agents
packages/
  api-contract/         # @flowershow/api-contract — Zod schemas, TS types, OpenAPI 3.1 spec
  cloudflare-worker/    # Markdown processing Cloudflare worker
  remark-wiki-link/     # @flowershow/remark-wiki-link — remark plugin for wiki-style links
content/
  flowershow-app/       # Marketing site content (Obsidian vault, not a workspace package)

開発環境のセットアップ

前提条件（プラットフォームの開発専用）： Node.js 22+、pnpm、Docker。

# Clone (include the e2e test-site submodule)
git clone --recurse-submodules https://github.com/flowershow/flowershow.git
cd flowershow

# Install dependencies
pnpm install

# Copy env template (then edit apps/flowershow/.env with your secrets)
cp apps/flowershow/.env.example apps/flowershow/.env

# Start everything: Postgres, MinIO, Inngest, Cloudflare Worker, Next.js app
pnpm dev

起動したら、http://cloud.localhost:3000 にアクセスしてください。

--recurse-submodules を指定せずにすでにクローンしている場合は、 git submodule update --init を実行して E2E テスト用サイトを取得してください。

コマンド

pnpm dev --stripe              # Also start Stripe webhook forwarding
pnpm dev --github              # Also start Smee (GitHub webhook proxy)
pnpm dev --search              # Also start Typesense
pnpm dev:all                   # Start everything including all optional services

pnpm dev:local                 # Start dev servers only (no Docker infrastructure)
pnpm dev:local:all             # Start dev servers only + all optional services
pnpm dev:down                  # Stop Docker containers (keep data)
pnpm dev:nuke                  # Stop containers + delete all data volumes

pnpm build                     # Build all packages
pnpm test                      # Run tests across all packages
pnpm lint                      # Lint all packages (ESLint for app, Biome for packages)
pnpm format                    # Check formatting (Biome)
pnpm format:write              # Auto-fix formatting

ウェブアプリのセットアップ（データベース、ストレージ、認証など）については、apps/flowershow/README.md をご覧ください。

ツール

ツール	対象範囲	目的
Biome	リポジトリ全体	packages/ のフォーマット（シングルクォート、2 スペースのインデント）とリンティング
ESLint	apps/flowershow	eslint-config-next による Next.js 固有のリンティング
Vitest	packages/remark-wiki-link	単体テスト
Playwright	apps/flowershow	E2E テスト
Turborepo	ルート	タスクのオーケストレーションとキャッシュ
Changesets	packages/	バージョン管理と npm への公開
Husky	ルート	Git フック（コミット前に lint-staged を実行）

コミット前に、pre-commit フックが lint-staged を使ってステージ済みのファイルを自動的にフォーマットします。

パッケージのリリース

pnpm changeset                 # Create a changeset describing your change
pnpm version-packages          # Bump versions based on changesets
pnpm release                   # Build all packages and publish to npm

ドキュメント

• ウェブアプリ：apps/flowershow/README.md — アーキテクチャ、ローカル開発環境のセットアップ、環境設定、テスト、トラブルシューティング
• REST API コントラクト：packages/api-contract/README.md — Flowershow REST API の Zod スキーマ、TypeScript 型、OpenAPI 3.1 仕様。コントラクトは API の仕様を定義する唯一の情報源であり、Next.js API ルート、CLI、Obsidian プラグインはすべてこれを利用します。
• インタラクティブ API ドキュメント：開発サーバーの実行中に http://cloud.flowershow.local:3000/api/docs にアクセスすると Swagger UI を、/api/docs/openapi.json にアクセスすると仕様の生データを確認できます。本番環境では flowershow.app/api/docs をご覧ください。
• CLI：apps/cli/README.md — Markdown ファイルを公開するための Go CLI。AI エージェント連携用のインターフェースでもあります。Flowershow skill をご覧ください。
• ユーザードキュメント：flowershow.app/docs

コミュニティ

• 既存の Issueを確認するか、新しい Issue を登録してください。
• 質問やアイデアの共有、Flowershow サイトのお披露目には、ディスカッションをご利用ください。

コントリビューション

Flowershow の一部をコミュニティからのコントリビューションに開放する準備を進めています。まだ準備中ですが、近いうちにコントリビューターの皆さんをお迎えできることを楽しみにしています。

Flowershow の Markdown 機能のデモやテストに関するプルリクエストは、今すぐ作成してコントリビューションできます。

• デモ：demo.flowershow.me — github.com/flowershow/demo
• テスト：test.flowershow.me — github.com/flowershow/test

開発ワークフロー

1. staging から機能ブランチを作成します
2. 変更を実装します
3. staging に PR を提出します
4. 承認後、変更が main にマージされます

staging へのマージにはスカッシュマージを使用し、コミットメッセージには Conventional Commits の形式を採用しています。