KnowledgeApr 3, 2026·3 min read

AFFiNE — Open-Source Notion Alternative

Docs, whiteboards, and databases in one privacy-first workspace. Local-first with real-time collaboration. 66K+ GitHub stars.

TL;DR
Open-source Notion alternative combining docs, whiteboards, and databases. Local-first, privacy-focused, with real-time collaboration.
§01

What it is

AFFiNE is an open-source workspace that combines documents, whiteboards, and databases in a single application. It is designed as a privacy-first alternative to Notion, with local-first data storage and optional real-time collaboration.

AFFiNE supports rich text editing, infinite canvas whiteboards, Kanban boards, and database views. All data is stored locally by default, with optional cloud sync for team collaboration.

§02

How it saves time or tokens

AFFiNE eliminates the need for separate tools for notes, diagrams, and databases. A single workspace handles project planning (Kanban), documentation (rich text), brainstorming (whiteboard), and data tracking (database views).

The local-first architecture means AFFiNE works offline and loads instantly without server round-trips. For AI workflows, the block-based document model makes content programmatically accessible.

§03

How to use

  1. Download AFFiNE desktop app or use the web version:
# Self-host with Docker
docker run -d -p 3010:3010 ghcr.io/toeverything/affine:latest
  1. Create a workspace and start adding pages with docs, whiteboards, or databases.
  1. Switch between document mode and canvas mode for the same page:
Document mode: Rich text with blocks, headings, lists, code
Canvas mode: Infinite whiteboard with shapes, connectors, sticky notes
  1. Create database views for structured data: tables, Kanban boards, and calendars.
§04

Example

# Project Planning in AFFiNE
§05

Requirements (Document mode)

  • Feature A: User authentication
  • Feature B: Dashboard redesign
§06

Architecture (Canvas mode)

[Drag shapes and connectors to diagram the system]

§07

Sprint Board (Database mode)

TaskStatusAssignee
Auth APIIn ProgressAlice
Dashboard UITodoBob
§08

Related on TokRepo

§09

Common pitfalls

  • Expecting feature parity with Notion on day one. AFFiNE is actively developed and some Notion features (deep API integrations, formulas) may not be available yet.
  • Not setting up cloud sync for team use. Local-first means data stays on your device by default. Enable AFFiNE Cloud or self-host for team collaboration.
  • Overloading pages with mixed content types. While AFFiNE supports docs, canvas, and databases on one page, complex pages with all three can become hard to navigate. Use separate pages for distinct content types.
  • Failing to review community discussions and changelogs before upgrading. Breaking changes in major versions can disrupt existing workflows. Pin versions in production and test upgrades in staging first.

Frequently Asked Questions

How does AFFiNE compare to Notion?+

AFFiNE is open-source and local-first, while Notion is a proprietary cloud service. AFFiNE combines docs, whiteboards, and databases in one app. Notion requires separate tools for whiteboarding. AFFiNE prioritizes privacy and offline access; Notion prioritizes cloud-first collaboration.

Is AFFiNE truly local-first?+

Yes. AFFiNE stores all data locally on your device by default. No internet connection is required for reading or editing. Optional cloud sync is available for team collaboration and cross-device access.

Can I self-host AFFiNE?+

Yes. AFFiNE provides Docker images for self-hosting. This gives your team full data ownership and control. The self-hosted version includes real-time collaboration via WebSocket sync.

Does AFFiNE support real-time collaboration?+

Yes. When using AFFiNE Cloud or a self-hosted server, multiple users can edit the same page simultaneously with live cursor visibility and conflict resolution.

What is the difference between document and canvas mode?+

Document mode provides a traditional rich text editing experience with blocks, headings, and lists. Canvas mode provides an infinite whiteboard where you can freely arrange text, shapes, images, and connectors. You can switch between modes for the same page.

Citations (3)
🙏

Source & Thanks

Created by Toeverything. Licensed under MIT.

AFFiNE — ⭐ 66,900+

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets