From 34a76342ecd1ac07a8bc7599819dc21253d16655 Mon Sep 17 00:00:00 2001 From: Claude Code Date: Wed, 21 Jan 2026 17:43:58 +0000 Subject: [PATCH] docs: update for PR #35 Update documentation for community workflows migration to R2 storage: - Add changelog entry for community workflows storage migration - Document new COMMUNITY_WORKFLOWS_API_URL environment variable in installation guide - Add Community Workflows section to AI Quickstart guide explaining remote storage benefits - Update Template Explorer description to mention community workflows Co-Authored-By: Claude Sonnet 4.5 --- pages/changelog.mdx | 23 +++++++++++++++++++++++ pages/guides/ai-quickstart.mdx | 15 +++++++++++++++ pages/installation.mdx | 5 +++++ 3 files changed, 43 insertions(+) diff --git a/pages/changelog.mdx b/pages/changelog.mdx index ae0d119..a8584c9 100644 --- a/pages/changelog.mdx +++ b/pages/changelog.mdx @@ -6,6 +6,29 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). --- +## Unreleased + +### Changed + +- **Community Workflows Storage** — Migrated from Git LFS to R2 storage on node-banana-pro ([#35](https://github.com/shrimbly/node-banana/pull/35)) + - Community workflows now fetched from remote API instead of local files + - Repository size dramatically reduced (~424MB removed) + - No Git LFS dependency required + - API routes proxy to `nodebananapro.com` by default + - 5-minute cache for workflow listings, 10-minute cache for individual workflows + - New `COMMUNITY_WORKFLOWS_API_URL` environment variable for custom hosting + +### Removed + +- **Local Community Workflow Files** — Removed from repository in favor of remote storage ([#35](https://github.com/shrimbly/node-banana/pull/35)) + - Removed `examples/Fashion-image-to-video.json` (263MB) + - Removed `examples/contact-sheet-billsSupra.json` (79MB) + - Removed `examples/contact-sheet-ChrisWalkman.json` (82MB) + - Removed `src/lib/quickstart/communityWorkflows.ts` (metadata now server-side) + - Removed `.gitattributes` (Git LFS no longer needed) + +--- + ## 1.2.0 — 2026-01-20 ### Added diff --git a/pages/guides/ai-quickstart.mdx b/pages/guides/ai-quickstart.mdx index 4d7f2ec..0881f32 100644 --- a/pages/guides/ai-quickstart.mdx +++ b/pages/guides/ai-quickstart.mdx @@ -15,6 +15,7 @@ The Template Explorer provides a visual interface for browsing and selecting wor - **Provider Filtering** — See which providers each template requires - **Interactive Preview** — View workflow diagrams before loading - **Grid Layout** — Browse templates in an organized card layout with sidebar filters +- **Community Workflows** — Access community-contributed workflows stored remotely on node-banana-pro ## Preset Templates @@ -50,6 +51,20 @@ Combine multiple elements into a cohesive scene. - **Inputs needed**: Multiple source images - **Output**: Composite image +## Community Workflows + +Community workflows are user-contributed templates stored remotely on node-banana-pro. These workflows are: + +- **Automatically updated** — New community workflows appear without requiring Node Banana updates +- **Centrally managed** — Hosted on R2 storage for fast, reliable access +- **No repository bloat** — Workflows are fetched on-demand, keeping your local installation lean + +By default, Node Banana fetches community workflows from the hosted node-banana-pro service. If you're self-hosting or want to use a custom workflow source, you can set the `COMMUNITY_WORKFLOWS_API_URL` environment variable in your `.env.local` file. + + + Community workflows require the same API keys as any other workflow. Make sure you have the necessary provider API keys configured for the workflows you want to use. + + ## Custom Workflow Generation Don't see what you need? Describe your workflow in plain English. You can also describe video generation workflows — just mention "video" in your description and the AI will use Generate Video nodes. diff --git a/pages/installation.mdx b/pages/installation.mdx index dac0f27..07a584b 100644 --- a/pages/installation.mdx +++ b/pages/installation.mdx @@ -57,6 +57,11 @@ FAL_KEY=your_fal_api_key_here # Optional OPENAI_API_KEY=your_openai_api_key_here + +# Community Workflows (optional) +# Defaults to node-banana-pro hosted service +# Only set this if you're self-hosting community workflows +COMMUNITY_WORKFLOWS_API_URL=https://your-custom-host.com/api/public/community-workflows ``` import { Callout } from 'nextra/components'