appflowy-integration

What problem does it solve?

This Skill automates AppFlowy integration to streamline task and documentation syncing, reducing manual overhead and ensuring consistent alignment between repository changes and AppFlowy workspaces.

Core Features & Use Cases

• Git PushSync workflow: Push to GitHub and automatically sync tasks and documentation to AppFlowy in one command.
• Documentation automation: Delta-based content blocks (Markdown to AppFlowy) with optional database-backed storage and mapping to prevent duplicates.
• Workspace and project management: Automates setup of workspaces, folders, and documentation hierarchy across AI agents projects.
• Configurable, generic syncing: Works with any project via YAML/JSON configuration and auto-discovery modes.
• Incremental updates: Watches for changes and only pushes updated content, with support for dry-run and force-resync.
• Rich tooling integration: Supports mappings, environment-configured credentials, and Docker/hosted deployment workflows.

Quick Start

1. Set up AppFlowy credentials and workspace IDs in your environment or .env file.
2. Use the git pushsync workflow to push changes and automatically sync to AppFlowy.
3. If starting fresh, run a dry-run to preview what would be synced, then perform a real sync.
4. For documentation, consider a database-based approach and a mapping file to prevent duplicates.