1人でデスクトップとモバイル両方で動いて同期するアプリをどうやって作ったか

1人でデスクトップとモバイル両方で動いて同期するアプリをどうやって作ったか

1人でデスクトップとモバイル両対応でデータ同期するアプリをどうやって作ったか

5プラットフォームで動くSaaSを個人で開発するためにやったこと

こんにちは、個人アプリ作家のTAKUYAです。InkdropというクロスプラットフォームなMarkdownノートアプリを1人で開発しています。このアプリはmacOS、Linux、Windows、Android、iOSで動作します。ご存知かもしれませんが、この5プラットフォームにアプリを対応させるのは簡単ではありません。しかしながらパワフルなフレームワークを活用すれば、それも不可能ではありません。それらに頼るだけでなく、プロジェクトを持続可能に保つための開発戦略も必要となります。本記事では、僕がこれまでどのようにして開発して来たのかシェアしたいと思います。

あなたは1人で開発しているのではない

クロスプラットフォームなアプリの開発は、往々にして多くの予測不能かつ再現不能な問題を伴います。自分の環境では正しく動いていた機能が、他の環境では思うように動かない。例えば、最近僕もそういう問題を経験しましたが、それは起動直後にアプリの画面が空白になるというものでした。僕は事前に入念にベータ配信を重ねてテストをしていましたが、それでもこの問題は見つけられませんでした。しかし、ユーザさんの素早い報告とやりとりのおかげで、24時間以内に解決する事が出来ました。

個人開発者は、実際には1人で開発しているのではありません。なぜなら、いつでもこのようにユーザに助けを求めることが出来るからです。正直に誠実に、今何を取り組んでいて何に困っているのか述べましょう。あなたのアプリを楽しんでいるユーザは、基本的にあなたのアプリの成功を願っていますし、喜んで助けようとしてくれます。ユーザの助けに頼ることはとても重要です。あなたのリソースはとても限られているからです。Inkdropもユーザの皆さんの協力がなければ、ここまでの完成度には到底辿り着けませんでした。Inkdropはプログラマ向けなので、このフォーラムでのケースのように、ユーザ側から問題を解決するためのコード例まで示してくれることもあります。その上、僕の手元で再現できないバグを修正するために、数時間も付き合って下さることもしばしばあります。このようなユーザとの緊密で双方向なコミュニケーションは、大企業に対抗できる大きな優位性でしょう。

Inkdropのユーザフォーラム

CouchDB & PouchDB: シームレスなデータ同期とオフライン対応

Apache CouchDBドキュメント指向データベース(NoSQL)で、HTTPベースのJSON APIを備えていて、かつマルチマスタで同期出来ます。FauxtonというウェブGUIがあり、データベースやドキュメントを簡単に管理できます。PouchDBはこのCouchDBにインスパイアされたJavaScript製のデータベースで、同様にCouchDBと同期出来ます。まず僕はデスクトップ版に取り掛かり、モバイル版は特に気にかけませんでした。というのも、PouchDBはJavaScript製で既にいくつかの選択肢が用意されていたので、大丈夫だろうと想定していました。もしうまく動かなければ、自分でモジュールを組めばいいと考えていました。CouchDBのAPIがRESTfulでシンプルだからです。

なぜ僕が他のfirebaseなどのPaaS (Platform-as-a-Service)ではなくCouchDBを選んだかというと、クライアント側での柔軟なインデクシングを必要としていたからです。3年前、僕がこのプロジェクトを始めた当時、firestoreは要件を満たすほど柔軟ではありませんでした。PouchDBはクライアントでのMapReduceに対応しており、全文検索用のモジュールもあったので有望だと判断しました。更に、CloudantというCouchDB用のDBaaSがあったのも決め手になりました。Cloudantはスループットやストレージサイズを柔軟に変えられます。サーバ運用は出来るだけ避けたかったので、最初の頃はこれを採用しました。現在はAWS EC2上でCouchDBを運用しています。理由は、BtoCサービスほど負荷が不安定だったり大きくないという事が分かったのと、Cloudantは重くて、IBM Cloud上での管理が煩雑さったためです。

今のところ、CouchDBとPouchDBの組み合わせは総じて満足しています。

クロスプラットフォームなフレームワーク

5プラットフォームで動かすために、デスクトップOS (Windows/Linux/macOS)ではElectronを、モバイルOS (iOS/Android)ではReact Nativeを採用しました。双方のバージョンでReactJSとReduxを使用しています。これらのフレームワークのおかげで、基本的にロジックは全部JavaScriptで組めましたし、デスクトップとモバイル間で多くのコードベースを共通化させる事が出来ました。

成功しているプロダクトから学ぶ

Kitematicの美しいUI

当時、ElectronとReactJSでアプリを組むのは初めてで知見がありませんでした。でも出来るだけ早くアプリを世に出してアイデアを検証したいと考えていました。そこで、美しいUIや拡張可能なアーキテクチャを組むための現時点でのベストプラクティスを手っ取り早く学ぶために、既存のオープンソースプロジェクトであるAtom EditorKitematicに着目しました。これらのプロジェクトはGPLライセンスではなかったので、コードベースを自分のアプリに再利用出来る事を知りました。ありがとう、GitHubとDocker。

Kitematicのリポジトリをフォークする所から始めました。この方法は多くの良い実践を学べて、多くの問題を事前に回避できましたが、1つだけ欠点がありました — それは、技術的負債も一緒について来るという事です。技術的負債は多くのプロジェクトに大体あるものなのでしょうがないです。例えば、Kitematicはfluxアーキテクチャの実装としてAltJSを採用していました。しかしAltJSは僕がInkdropに着手した後、程なくして更新が止まってしまいました。それによって、Reactを最新版の16にアップグレードできずにいました。最終的にはAltJSをReduxと完全に置き換える事で対処しました。しかしながら、こういう事態は予期できないものです。Kitematic自身にとっても予想外だったでしょう。こういったプロジェクトから学べることは沢山あります。なので、僕がもしまた似たような状況になったら、進んで同じアプローチを取るでしょう。

また、Atomのコードを沢山お借りして、プラグイン機構、キーマップのカスタマイズ機能、テーマ機能などを実装しました。彼らのコードは読む度に発見があり驚きに満ちていました。これらを1人でイチから実装するなんて事は、到底できなかったでしょう。

コードベースを共通化する

デスクトップとモバイル版は両方共PouchDB、ReactとReduxで組んであるので、データモデルやRedux Action, Reducerなどプラットフォームに依存しない多くの部分を共通化出来ました。そのお陰で、両方を同時に効率よくメンテできるようになりました。

UIコンポーネント群はプラットフォームごとに組む

UIはデスクトップとモバイル版で分けて組みました。そもそも、まず最初にデスクトップ版から開発していましたし、自分が将来モバイル版をどうやって組むのかすら考えていませんでした。これは個人的な意見ですが、UIコンポーネント群をデスクトップとモバイル版で共有するのはあまり良い戦略ではありません(とりわけInkdropでは)。なぜなら、react-native-webのようなライブラリは基本的にモバイルファーストで、デスクトップにはフォーカスしていません。なので、もしアプリのUIがとてもシンプルで、主なターゲットがモバイルユーザである場合に限り有効な戦略だと思います。

デスクトップ版はSemantic UI、モバイル版はNative Baseを使って美しいUIとテーマ対応を実現しました。React Nativeに関する開発の知見はこちらの記事に書きました:

React Native製アプリのクオリティを上げるために工夫した事
InkdropというMarkdownノートアプリを一人で作っているTAKUYAです。最近、React Nativeを使って、iOS版とAndroid版の新しいバージョンをリリースしました。React…

PouchDBをReact Nativeで動かすための四苦八苦

PouchDBはブラウザやElectron製アプリでは問題なく動作します。しかしReact Nativeとなるといくつか問題があります — pouchdb-react-nativeを使うと、AsyncStorageをアダプタにして動作するのでパフォーマンスが良くありませんでした。そこでreact-native-sqlite-2pouchdb-adapter-react-native-sqliteを作って、SQLiteをアダプタとして動作するようにしました。もう1つの問題は、attachmentsを上手く取り扱えないことです。これに関しては、PouchDBのコアモジュールを改造して対処しました:

PouchDBを改造してReact Nativeでも動くようにした - Qiita
gt; 本稿は[Hacking PouchDB to Use It on React Native](https://dev.to/craftzdog/hacking-pouchdb-to-use-on-react-native-1...

SQLite3を使ったローカル全文検索

初期の頃はpouchdb-quick-searchを使ってローカルでの全文検索を実装していましたが、特にAndroidでパフォーマンスが良くありませんでした。なのでpouchdb-quick-searchの実装を参考にして、SQLiteの全文検索機能を使ったFTSモジュールを自分で組みました。

Read more

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

Claude Codeをtmuxのポップアップウィンドウで継続的に走らせる方法

💡本記事は英語ブログの日本語訳です。 どうも、TAKUYAです。 AIコーディングでは専らClaude Codeを使っています。最初はtmuxでターミナルの右側にペインを分割して使っていたのですが、幅が狭すぎてメッセージやdiffがまともに表示できず、使いづらかったです。 <Prefix>+zでペインを最大化すればいいのですが、毎回やるのは面倒でした。 そこで、ポップアップウィンドウでClaude Codeを起動するようにしました。キーバインドを押せばセッションが開き、閉じてもバックグラウンドで動き続けるので、すぐに再開できます。 この記事では、それを実現するためのtmuxの設定方法を紹介します。 動画で見る(英語): ポップアップウィンドウはサブプロセスを維持できない tmuxのdisplay-popupコマンドを使うとポップアップウィンドウを表示でき、ちょっとしたツールにすぐアクセスするのに便利です。 僕はlazygitでgitの状態をサッと確認するのに使っています: bind -r g display-popup -d '#{pane_current_path}'

By Takuya Matsuyama
Keychron K2 HEを無刻印化する手順

Keychron K2 HEを無刻印化する手順

どうもTAKUYAです。KeychronさんにK2 HEをお願いしたら音速で送ってくれたので、無刻印化してみました。どうやったのか過程をシェアします。 Unboxing 上はKeychron Q1です。これは3年間ぐらい使ってきました。キーキャップが若干くたびれていますね。でも問題なく今まで使えていました。そろそろ飽きてきたので新しいキーボードを試したいと思い、前から気になっていたK2 HEを試すことにしました(写真下)。 Amazon | 【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、2.4GHz・Bluetooth無線対応、QMKプログラム可能、アルミ+ウッドフレーム、USレイアウト、RGBライト、Mac Windows Linux対応 (ブラック) | Keychron | パソコン用キーボード 通販【国内正規品】Keychron K2 HE ラピッドトリガー ワイヤレス カスタムキーボード、ホールエフェクトGateronダブルレール・マグネットスイッチ、

By Takuya Matsuyama
ノート駆動AIコーディング術の提案

ノート駆動AIコーディング術の提案

どうもTAKUYAです。みなさんはAIエージェントを普段のコーディングで活用されていますか。ちょっと面白いワークフローを思いついたのでシェアします。それは、ノート駆動のエージェンティック・コーディング・ワークフローです。最近Claude Codeのプランモードを使っていたら、ターミナル内で生成されたプランを読むのが辛かったんです。それで、じゃあMarkdownノートアプリであるInkdropをプランの保存先バックエンドとして使えば解決するんじゃないかと思って、 試してみました。こちらがそのデモです(英語): こちらがClaude Codeの設定ファイル群です: GitHub - inkdropapp/note-driven-agentic-coding-workflow at devas.lifeComplete Claude Code configuration collection - agents, skills, hooks, commands, rules, MCPs. Battle-tested configs from an Anthropic hackathon w

By Takuya Matsuyama
2025年個人開発活動の振り返り

2025年個人開発活動の振り返り

どうもTAKUYAです。もう1月も半ばに差し掛かっているけど、2025年の自分の活動の振り返りをしたい。去年を一言で言うなら、本厄を満喫した年だった。 厄年とは、人生の節目にあたって、体調不良や災難が起こりやすいと経験的に言われる年齢のこと。数え年で42歳、確かにもう若さに任せた事は出来ないなと痛感した年だった。(ところであなたの国ではこのような年はありますか?) 夏に体調を崩して2~3ヶ月動けなくなった 暖かくなり花粉が飛び出した頃に、持病のアトピーが悪化しだして、まともに生活出来なくなってしまった。酷さで言うと、2019年に脱ステした時と同じぐらい。 脱ステに無事成功したから、この地獄は二度と味わうことはないだろうと高を括っていたが、まさか7年後にまた味わうとは思わなかった。当時の独身時代と違い、妻も子供もいる中で、周りに多大な迷惑をかける事となった。夏の子供との思い出が全く無い。悲しい。 現在はQoLもほとんど元の状態まで復活できた。写真を撮って症状の変化を記録したので、機会があればシェアしたい。食事療法など色々試したが、結局歩くのが一番自分に効いた。それ以来、一日一万歩

By Takuya Matsuyama