# AppFlowy | AppFlowy-IO | Knowledge Base | Instagit

Bring projects, wikis, and teams together with AI. AppFlowy is the AI collaborative workspace where you achieve more without losing control of your data. The leading open source Notion alternative.

GitHub Stars: 68.3k

Repository: https://github.com/AppFlowy-IO/AppFlowy

---

## Articles

### [How AppFlowy Handles Data Persistence and File Storage: Local-First CRDT Architecture](/AppFlowy-IO/AppFlowy/how-does-appflowy-handle-data-persistence-and-file-storage)

Discover how AppFlowy handles data persistence and file storage using a local-first CRDT architecture combining RocksDB and a dedicated file-storage service for efficient local caching and uploads.

- Tags: architecture
- Published: 2026-03-03

### [Troubleshooting AppFlowy Installation Issues: A Complete Guide to Common Fixes](/AppFlowy-IO/AppFlowy/what-are-common-troubleshooting-steps-for-appflowy-installation-issues)

Resolve AppFlowy installation issues with this guide. Fix missing prerequisites permission errors and architecture mismatches for a smooth setup.

- Tags: how-to-guide
- Published: 2026-03-03

### [How to Configure AppFlowy for Local Development and Testing: Complete Setup Guide](/AppFlowy-IO/AppFlowy/how-to-configure-appflowy-for-local-development-and-testing)

Set up AppFlowy for local development efficiently. Follow this guide to easily configure your environment and start testing the desktop application with platform-specific install scripts and dev commands from the AppFlowy IO re...

- Tags: how-to-guide
- Published: 2026-03-03

### [Core Architectural Components of the AppFlowy Project: A Deep Dive into the Flutter-Rust Stack](/AppFlowy-IO/AppFlowy/what-are-core-architectural-components-of-appflowy-project)

Explore AppFlowy's core architectural components. Discover how its Flutter UI interfaces with a Rust engine via an FFI bridge and event dispatcher for seamless functionality.

- Tags: architecture
- Published: 2026-03-03

### [AppFlowy Startup Initialization Flow: From entry_point.dart to SplashScreen](/AppFlowy-IO/AppFlowy/what-is-startup-initialization-flow-entry-point-dart-to-splashscreen-in-appflowy)

Explore the AppFlowy startup initialization flow from entry_point.dart to SplashScreen. Understand how dependency injection and backend setup lead to the initial UI render.

- Tags: internals
- Published: 2026-03-03

### [How AppFlowy Synchronizes Real-Time Collaborative Features Using CRDTs and WebSockets](/AppFlowy-IO/AppFlowy/how-are-real-time-collaborative-features-synchronized-in-appflowy)

Discover how AppFlowy synchronizes real-time collaborative features using CRDTs and WebSockets. Learn about its CRDT-based sync stack and live collaboration.

- Tags: internals
- Published: 2026-03-03

### [How AppFlowy Implements File Storage and Upload/Download: A Technical Deep Dive](/AppFlowy-IO/AppFlowy/how-is-file-storage-and-file-upload-download-implemented-in-appflowy)

Explore AppFlowy's file storage and upload download architecture. Learn how it handles temporary caching, cloud integration, and resumable multipart uploads with progress tracking.

- Tags: deep-dive
- Published: 2026-03-03

### [How the AppFlowy Billing and Subscription System Works: Technical Architecture](/AppFlowy-IO/AppFlowy/how-does-billing-and-subscription-check-system-work-in-appflowy)

Discover the AppFlowy billing and subscription system. Learn how its cloud-backed Rust backend polls AppFlowy Cloud for status changes with retries and confirmation for seamless plan management.

- Tags: architecture
- Published: 2026-03-03

### [How AppFlowy Handles Database Migrations for User Data: A Technical Deep Dive](/AppFlowy-IO/AppFlowy/how-are-database-migrations-handled-for-user-data-in-appflowy)

Learn how AppFlowy manages database migrations for user data. Explore its version-aware pipeline, automatic startup execution, and SQLite history tracking for data integrity.

- Tags: deep-dive
- Published: 2026-03-03

### [How AppFlowy Manages Workspace and View Hierarchy in Its UI: A Deep Dive into the Folder Architecture](/AppFlowy-IO/AppFlowy/how-is-workspace-and-view-hierarchy-managed-in-appflowy-ui)

Discover how AppFlowy manages its workspace and view hierarchy with its folder architecture. Learn about the tree-based structure and CRDT synchronization.

- Tags: deep-dive
- Published: 2026-03-03

### [AppFlowy Error Handling: How flowy-error Bridges Rust and Flutter](/AppFlowy-IO/AppFlowy/how-is-error-handling-and-error-codes-flowy-error-structured-in-appflowy)

Discover how AppFlowy handles errors across Rust and Flutter using flowy-error. Learn about the unified error model, ErrorCode enum, and GlobalErrorCodeNotifier for seamless communication.

- Tags: internals
- Published: 2026-03-03

### [How AppFlowy Implements Localization and Internationalization with JSON Translation Files](/AppFlowy-IO/AppFlowy/how-is-localization-internationalization-implemented-with-json-translation-files-in-appflowy)

Learn how AppFlowy implements localization and internationalization using JSON translation files. Discover runtime translation, type-safe constants, and dynamic locale switching.

- Tags: internals
- Published: 2026-03-03

### [How the Notification System and User Awareness Work in AppFlowy: A Deep Dive](/AppFlowy-IO/AppFlowy/how-does-notification-system-and-user-awareness-work-in-appflowy)

Explore AppFlowy's notification system and user awareness. Learn how state changes sync from Rust to Flutter and how remote user data is managed within this deep dive.

- Tags: deep-dive
- Published: 2026-03-03

### [How AppFlowy Handles User Authentication and User Profile Management: Rust Core and Flutter Architecture](/AppFlowy-IO/AppFlowy/how-is-user-authentication-and-user-profile-management-handled-in-appflowy)

Discover how AppFlowy handles user authentication and profile management with its Rust core and Flutter frontend. Learn about its offline-first local mode and cloud-backed capabilities.

- Tags: internals
- Published: 2026-03-03

### [How the AppFlowy SQLite Database (flowy-sqlite) Stores and Manages Data](/AppFlowy-IO/AppFlowy/how-does-sqlite-database-flowy-sqlite-store-and-manage-data-in-appflowy)

Discover how AppFlowy uses its flowy-sqlite crate, powered by Diesel, to store and manage all application data including user preferences and file metadata through connection pooling and schema migrations.

- Tags: internals
- Published: 2026-03-03

### [How AppFlowy Handles Deep Links for Login, Payment, and Invitation Callbacks](/AppFlowy-IO/AppFlowy/how-are-deep-links-login-payment-invitation-handled-in-appflowy-app)

Learn how AppFlowy integrates a flexible deep link framework for login, payment, and invitation callbacks. Discover its plug-in architecture and handler registry.

- Tags: internals
- Published: 2026-03-03

### [How the AppFlowy Plugin System Architecture Works in the Flutter Frontend](/AppFlowy-IO/AppFlowy/how-does-plugin-system-architecture-work-in-frontend-appflowy-flutter)

Discover the AppFlowy plugin system architecture. Learn how runtime extensions are discovered compiled and managed reactively within the Flutter frontend for seamless integration.

- Tags: architecture
- Published: 2026-03-03

### [How the AI Assistant Is Integrated into the AppFlowy Editor: A Technical Deep Dive](/AppFlowy-IO/AppFlowy/how-is-ai-assistant-prompt-system-integrated-into-appflowy-editor)

Discover how the AppFlowy editor integrates its AI assistant with a three-layer architecture. Learn about Flutter UI, Dart services, and Rust backend for AI inference.

- Tags: deep-dive
- Published: 2026-03-03

### [How AppFlowy Implements Data Import from Notion, Todoist, and Other Tools](/AppFlowy-IO/AppFlowy/how-is-data-import-from-notion-todoist-and-other-tools-implemented-in-appflowy)

Discover how AppFlowy seamlessly imports data from Notion, Todoist, and more. Explore the cross-layer pipeline connecting Flutter UI to a powerful Rust backend for efficient data transformation and workspace creation.

- Tags: how-to-guide
- Published: 2026-03-03

### [How AppFlowy Cloud Sync and Server Integration Works: Architecture and Implementation](/AppFlowy-IO/AppFlowy/how-does-appflowy-cloud-sync-and-server-integration-work)

Discover how AppFlowy Cloud sync and server integration works with its provider-based abstraction layer, enabling seamless two-way sync between local SQLite and the cloud.

- Tags: architecture
- Published: 2026-03-03

### [How AppFlowy Implements the Collaborative Editing (Collab) Module: Architecture and Code](/AppFlowy-IO/AppFlowy/how-is-collaborative-editing-collab-module-implemented-in-appflowy)

Discover AppFlowy's collaborative editing architecture built on Rust CRDTs. Learn how the collab module uses AppFlowyCollabBuilder for document creation, persistence, and cloud sync.

- Tags: architecture
- Published: 2026-03-03

### [How Flutter-Rust FFI Communication Works in AppFlowy: A Deep Dive into the Bridge Architecture](/AppFlowy-IO/AppFlowy/how-does-flutter-rust-ffi-communication-work-in-appflowy)

Explore AppFlowy's Flutter-Rust FFI communication. Learn how Dart loads Rust shared objects, uses zero-copy protobufs, and handles async responses for efficient cross-language interaction.

- Tags: deep-dive
- Published: 2026-03-03