Skip to main content
AFFiNE’s mobile apps bring the power of collaborative editing, whiteboard, and knowledge management to your smartphone and tablet.
Mobile apps are currently in active development. Some features available on desktop may be limited on mobile.

​
Platform Support

iOS

iOS 14.0 and later

Android

Android 8.0 (API 26) and later

​
Installation

​
iOS

Download from the App Store:

Download on App Store

Get AFFiNE for iPhone and iPad
 Or install via TestFlight for beta versions.

​
Android

Download from Google Play:

Get it on Google Play

Get AFFiNE for Android devices

​
Features

​
Mobile Editor

Edit documents on the go:
  • Touch-optimized UI: Gestures for formatting, selection, and navigation
  • Markdown support: Full markdown editing with preview
  • Block editing: All block types supported (text, code, images, etc.)
  • Inline formatting: Bold, italic, links, and more
  • Media capture: Take photos directly into documents

​
Mobile Whiteboard

Create visual content:
  • Touch drawing: Pen, shapes, and text tools
  • Multi-touch: Pinch to zoom, two-finger pan
  • Sticky notes: Quick ideas on canvas
  • Image import: Add photos from gallery

​
Sync & Collaboration

  • Real-time sync: Changes sync across all devices
  • Offline support: Work offline, sync when connected
  • Conflict resolution: Automatic CRDT-based merging
  • Background sync: Updates in the background

​
Mobile-Specific Features

Secure your app with Face ID, Touch ID, or fingerprint:
  • Enable in Settings → Security
  • Works with device biometrics
  • Optional PIN fallback
Share content to AFFiNE from other apps:
  • Share web pages as bookmarks
  • Save images to documents
  • Capture text from other apps
  • Quick workspace selection
Capture content directly:
  • Take photos for documents
  • Scan documents (iOS)
  • Record videos
  • Annotate images
Quick access to recent documents:
  • iOS: Home screen and lock screen widgets
  • Android: Home screen widgets
  • Quick actions

​
Architecture

The mobile apps are built with:

​
Technology Stack

  • Capacitor: Native runtime for web apps
  • React: UI framework (shared with web)
  • TypeScript: Type-safe development
  • Native Plugins: Platform-specific features

​
Native Plugins

Custom Capacitor plugins provide native features:
plugins/
├── biometric/          # Face ID, Touch ID, Fingerprint
├── filesystem/         # Native file access
├── keyboard/           # Keyboard handling
├── share/              # Share extension
└── camera/             # Camera and photo library

​
Code Sharing

Mobile apps share 90%+ code with web: 
packages/frontend/
├── apps/
│   ├── mobile/         # Mobile-specific code
│   ├── mobile-shared/  # Shared mobile utilities
│   ├── ios/            # iOS Capacitor project
│   └── android/        # Android Capacitor project
└── core/               # Shared business logic

​
Platform Differences

​
iOS

Advantages:
  • Better performance on Apple Silicon
  • Native share sheet integration
  • Document scanner built-in
  • iCloud sync support (planned)
Limitations:
  • App Store review process for updates
  • Limited background processing
  • WebKit rendering only

​
Android

Advantages:
  • More flexible background sync
  • Custom file picker
  • Direct filesystem access
  • Multiple browser engines
Limitations:
  • Varied performance across devices
  • Fragmentation (OS versions, screen sizes)
  • Battery optimization can affect sync

​
Storage

​
Data Location

Library/Application Support/AFFiNE/

​
Storage Management

Manage storage in Settings:
  • View storage usage by workspace
  • Clear cache
  • Download workspaces for offline
  • Delete local data

​
Offline Mode

Mobile apps work fully offline:
  1. Download workspaces: Mark workspaces for offline access
  2. Edit offline: All changes saved locally
  3. Auto-sync: Changes sync when connection restored
  4. Conflict resolution: Automatic CRDT merging
Large workspaces may take time to download for offline use. Use WiFi for initial sync.

​
Keyboard Shortcuts

​
iOS with Keyboard

ShortcutAction
⌘ + NNew document
⌘ + KQuick search
⌘ + BBold
⌘ + IItalic
⌘ + ZUndo
⌘ + ⇧ + ZRedo

​
Android with Keyboard

ShortcutAction
Ctrl + NNew document
Ctrl + KQuick search
Ctrl + BBold
Ctrl + IItalic
Ctrl + ZUndo
Ctrl + YRedo

​
Troubleshooting

​
App Crashes

1

Update to latest version

Check App Store / Google Play for updates
2

Clear cache

Settings → Advanced → Clear cache
3

Reinstall app

Delete and reinstall (data synced to cloud)
4

Report issue

Help → Report a bug with crash logs

​
Sync Not Working

  • WiFi or cellular data enabled
  • Not in airplane mode
  • Server reachable
  • Sync enabled in settings
  • Workspace has cloud sync enabled
  • Not paused in background
  • Pull down to refresh
  • Or Settings → Sync → Force sync

​
Performance Issues

Mobile devices have limited resources. For best performance:
  • Keep fewer workspaces downloaded
  • Close unused documents
  • Clear cache regularly
  • Restart app periodically

​
Development

Build the mobile apps locally:
1

Install dependencies

yarn install
2

Build native modules

yarn affine @affine/native build
3

Sync Capacitor

yarn workspace @affine/mobile cap sync
4

Open in IDE

iOS:
yarn workspace @affine/mobile cap open ios
Android:
yarn workspace @affine/mobile cap open android

​
Roadmap

Upcoming mobile features:
  • Offline-first improvements
  • Widget enhancements
  • Siri shortcuts (iOS)
  • Apple Pencil support (iPad)
  • S Pen support (Samsung)
  • Tablet optimization
  • Split-screen multitasking

Desktop App

Learn about the desktop application

Web App

Use AFFiNE in your browser

Sync & Storage

How mobile sync works

Contributing

Build and contribute to mobile apps