A personal-use iOS client for a self-hosted Blinko instance.
Personal-use only. This project is built for my own devices and my own Blinko instance. No support, no warranties, no acceptance of outside contributions. The repository is public for transparency and backup only.
All documentation in this repo was generated by AI assistants (Claude / Codex), then reviewed and adjusted by me. Treat the docs as a useful starting point, not authoritative.
A native SwiftUI + WKWebView hybrid app:
- Browse / search / AI / settings stay in Blinko's live web app inside
WKWebView. - Compose / edit / preview are native-owned and use Blinko's REST API for note list / upsert / upload / tag data.
- The editor is a native
UITextViewwith live markdown highlighting,#tag autocomplete, and/slash commands. - Full-screen image viewing is backed by JXPhotoBrowser.
This replaced an earlier Capacitor-wrapper approach, which itself replaced a TipTap-in-WKWebView editor. The decision trail is in docs/EDITOR.md.
linkbobo/
├── Linkbobo/ # XcodeGen project
│ ├── project.yml # Source of truth for the Xcode project
│ ├── Linkbobo/ # Swift sources
│ │ ├── App/ # Entry + RootView (web shell + floating buttons)
│ │ ├── WebView/ # WKWebView shell (LinkoWebView)
│ │ ├── Compose/ # Editor, preview, attachments
│ │ ├── API/ # REST client, models, config, keychain
│ │ └── Settings/ # Native settings
├── docs/ # AI-generated handoff docs (see below)
├── CLAUDE.md # AI agent entrypoint
└── README.md # This file
Requires Xcode 16+, iOS 17 deployment target. XcodeGen is used to generate the .xcodeproj from project.yml — do not hand-edit the project file.
cd Linkbobo
xcodegen generate
xcodebuild -project Linkbobo.xcodeproj -scheme Linkbobo \
-destination 'platform=iOS Simulator,name=iPhone 17' \
-derivedDataPath build CODE_SIGNING_ALLOWED=NO buildIf xcodegen generate fails on permission, clear the quarantine attribute:
xattr -dr com.apple.quarantine .Launch the app → Settings sheet auto-presents on first run (no API token configured).
- Server URL — your self-hosted Blinko base URL.
- API Token — generate one in Blinko's web Settings.
- Test Connection — verifies the token can read tags.
Token is stored in the iOS Keychain. Server URL and UI preferences live in UserDefaults.
The app registers the linkbobo URL scheme:
linkbobo://compose— open the native new-note page directly.linkbobo://compose/note— force笔记type.linkbobo://compose/todo— force待办type.
Settings → 快速写快捷方式 has a copy-button and a deep link into the Shortcuts app to wire this up to a Control Center / Lock Screen / Home Screen shortcut. See docs/PROJECT.md for the rationale.
All docs in docs/ are AI-generated and reflect the state of the code at the time of writing — read with that lens.
docs/NEXT.md— current status board: what's done, what's open, known issues.docs/PROJECT.md— project overview, architecture, API facts, roadmap.docs/EDITOR.md— editor decision trail (why native UITextView, not TipTap / CodeMirror).docs/DEV.md— build / simulator workflow, what the simulator can and cannot verify.
All rights reserved. Personal use only. This source is published for transparency and backup; it is not licensed for redistribution, derivative works, or commercial use. If you want to build your own Blinko iOS client, start from Blinko's upstream PWA or write your own — don't fork this.