Skip to content
HuakiraPublic

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Latest commit

 

History

1 Commit

Folders and files

Repository files navigation

Linkbobo

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.

What this is

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 UITextView with 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.

Project layout

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

Build

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 build

If xcodegen generate fails on permission, clear the quarantine attribute:

xattr -dr com.apple.quarantine .

Configure

Launch the app → Settings sheet auto-presents on first run (no API token configured).

  1. Server URL — your self-hosted Blinko base URL.
  2. API Token — generate one in Blinko's web Settings.
  3. Test Connection — verifies the token can read tags.

Token is stored in the iOS Keychain. Server URL and UI preferences live in UserDefaults.

URL scheme quick-entry

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.

Documentation

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.

License

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.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages