Web アプリ: https://fllooat.mfmf.moe (スマホで開き、ホーム画面に追加して使うのがおすすめ)
仲間内での位置情報共有や、チーム開発における進捗共有など、コミュニケーションやプロジェクト進行を円滑にするために各々の生活を共有することは有効な手段である。 チームメンバーが過去に経験した、チームプロジェクトにおいてタスクを抱えたメンバーに連絡するタイミングが見計らいづらいという課題を踏まえ、各々が今どの程度暇なのかを共有するサービスを開発することにした。
今回私たちのチームは、仲間内でのチームプロジェクト進行を円滑にするための、リアルタイムの「暇さ」を共有するためのサービス「Fllooat」を開発した。
暇さを共有するユーザー同士で一つのルームを作成し、同じルーム内のユーザーの暇さがそれぞれに対応する気球の高さで可視化される。暇であるほど気球は高く浮かび、忙しいほど低く沈む。気球が浮かぶ範囲は一画面の中で完結しており、一画面には最大3名まで表示される。ルームの人数が4名以上の場合は、画面外の右に追加されていく。人数が増えるほど右側に並んでいき、スクロールしていくと一周して自分に戻るため、どのメンバーの状況も続けて確認できる。
自分の抱えているタスクは、名前と重さを設定して気球に積み込んでいく。荷物が増えるほど気球は沈み、忙しさを表す。タスクが完了した時、あるいはタスクを中断するなどして暇になる時は、スマホを振ることで抱えたタスクを一度全て振り落とす。軽くなった気球は再び浮き上がり、暇な状態であることを表す。
新しいタスクは、まず「プール」にブロックとして置いておく。今は取りかかれないタスクもメモしておけて、取りかかるときにブロックを気球へドラッグして乗せる。また、しばらくアプリを開いていないメンバーの気球はグレーになり、今は見ていない人だとわかる。
また、ルーム内の他のメンバーの気球に触れると、その人が抱えているタスクと、それらが全体の重さのうちどのくらいの割合を占めているのかを確認できる。「忙しい」という事実だけでなく、「何で忙しいのか」まで把握できるため、連絡や相談のタイミングを見計らいやすくなる。
- Google か GitHub のアカウントでログインする。
- ルームを作るか、仲間から聞いた 6 桁のルーム ID を入れて入室する。
- 「タスク追加」で名前と重さ (%) を決めてブロックを作り、気球へドラッグして乗せる。
- 終わったタスクは × で消すか、スマホを振って全部振り落とす。
- 仲間の気球をタップすると、その人が抱えているタスクが見られる。
位置情報共有サービスや、写真、動画をリアルタイムで共有するサービスはすでに存在し広く普及しているが、「暇さ」を可視化し、共有するサービスは斬新と言える。 気球の高さという直感的な表現を用いることで、一画面に表示される最大3名の暇さをひと目で比べることができる。
タスクを終わらせて、あるいは区切りをつけて、タスクから解放される時には気球からタスクを振り落とすインタラクションを設けることで、より強い開放感や斬新な体験を提供する。
他のメンバーの気球に触れると、その人が抱えているタスクの名前と、全体の重さに対して各タスクが占める割合を確認できる。 単に「忙しそう」で終わらせず、何にどのくらい手を取られているのかまで共有できるため、相手の状況に配慮したコミュニケーションが可能になる。
- 「今、連絡しても大丈夫かな?」というタイミングの見計らいづらさを解消し、チームメンバーへの連絡や相談のハードルを下げる。
- タスクを抱え込んでいるメンバーに早めに気付くことができ、タスクの分担や手助けのきっかけになる。
- 忙しさを言葉にして伝えるのが苦手な人でも、気球の高さとタスクの内訳で、負担なく自分の状況を共有できる。
- タスクを振り落とす操作を通じて、区切りをつける・気持ちを切り替えるといった体験を提供する。
- 暇さの推移を履歴として残し、メンバーが暇になりやすい時間帯の可視化などに活用する。
- 暇になったタイミングや、重いタスクを抱えたタイミングでの通知機能を追加する。
- 仲間内でのチームプロジェクトだけでなく、ゼミ・サークル・職場など、さまざまなコミュニティでの活用を目指す。
- 気球の高さ、サイドの目盛り、メンバーごとのアイコンの縁取りカラーなど、誰が今どのくらい暇なのかをひと目で把握できる画面設計。
- スマホを振ってタスクを振り落とす、タスクが増えると気球が沈むなど、「暇さ」を感覚的に体験できるインタラクション。
- Google・GitHubアカウントでワンタップでログインでき、すぐに使い始められる手軽さ。
- ルームの切り替えに対応し、複数のコミュニティでの暇さの共有を可能にした点。
- Cloudflare Workers (API と画面の配信を 1 つの Worker で行う)
- Cloudflare D1 (ルーム、メンバー、タスクを保存するデータベース)
- Google OAuth、GitHub OAuth (ログイン)
- DeviceMotion API (スマホを振る動きの検知)
- Web App Manifest (ホーム画面に追加してアプリのように使う)
- フロントエンド: React 19、Vite、TanStack Router、TanStack Query、Tailwind CSS v4、shadcn/ui (Radix UI)、Motion、Embla Carousel
- バックエンド: Hono、@hono/zod-openapi、Zod、Drizzle ORM、Better Auth
- API クライアントの生成とモック: Orval、MSW、Faker
- 開発環境: TypeScript 7、pnpm workspaces、Biome、Vitest (@cloudflare/vitest-plugin)、Wrangler、GitHub Actions
- スマートフォン (iPhone、Android) と PC のブラウザー
- スマホを振る操作はモーションセンサーを使う。PC では気球をドラッグして揺らせば同じ操作になる
- スマホを振る動きと、指で気球を左右に揺らす動きを、同じ仕組みで「振った」と判定する処理。強い動きの向きが 1 秒以内に 4 回入れ替わったら振ったとみなすので、軽く触れたりスクロールしかけたりしただけではタスクが落ちない。センサーのない PC でも、気球をドラッグして揺らせば同じ操作ができる。(shake-detector.ts、use-device-shake.ts、4119ea6)
- 自分を真ん中に置き、右に次に入った人、左に前に入った人を並べて、端まで行くと最初に戻る気球の並び。画面の幅に合わせて列の数が増え、人数が少なくても途切れずにループする。(balloon-ring.ts、balloon-sky.tsx、d2b7ef4)
- 左右にスクロールできることに気付いてもらうための動き。ルームを開いて 1.5 秒たったら、気球の並びを左右に 1 回ずつ少しずらし、画面の外にいる両隣の人をちらっと見せる。全員が 1 画面に収まるときや、先に画面を触ったとき、端末で動きを減らす設定にしているときは動かさない。(balloon-sky.tsx、513360d)
- メンバーごとの気球の色を、ルームとユーザーから決める処理。どの端末で見ても同じ色になり、隣どうしは同じ系統の色にならない。後から人が入っても、先にいた人の色はほとんど変わらない。(balloon-colors.ts、399dae8)
- 気球に乗せるタスクの重さの合計を 100% までに抑える処理。D1 では読んでから書くまでを 1 つのトランザクションにできないので、合計の判定と書き込みを 1 つの SQL 文にまとめた。2 台の端末から同時に乗せても、合計が 100% を超えることはない。(my-status.ts、6574871)
- しばらく画面を開いていない人を見分け、気球をグレーにするための処理。画面は 3 秒ごとにルームの情報を取り直すので、そのたびに最後に開いた時刻を書くと、数人で D1 の無料枠 (1 日 10 万行の書き込み) を超えてしまう。前回から 1 分以上たったときだけ書くようにして、書き込みを 20 分の 1 に減らした。何分で離れたとみなすかは Cloudflare のダッシュボードで変えられるので、コードを変えずに調整できる。(rooms.ts、6574871、870eb64)
- 6 桁の ID で入れるルームの管理。ID は乱数で作り、使われている ID と重なったら作り直す。他人のルームの ID を総当たりで探されないよう、入室は 1 人 1 分に 10 回までにした。全員が抜けたルームは消して、その ID をほかのルームで使えるようにしている。(rooms.ts、a128054、f93c14b)
- API の型を zod のスキーマ 1 か所にまとめ、
pnpm genで OpenAPI の定義、TanStack Query の hooks、型、MSW のモックまで生成する仕組み。フロントエンド班は API の完成を待たずに、モックを相手に画面を作り進められる。生成し忘れたまま push しても、CI で気付ける。(gen-openapi.ts、orval.config.ts、ea2bf38) - GitHub Actions による CI と自動デプロイ。PR ごとに lint、型チェック、ビルド、テスト、生成物の差分を確認し、main にマージすると Cloudflare Workers へのデプロイと本番のデータベースの更新まで自動で行う。ドキュメントだけを変えた PR では CI を省く。(ci.yml、deploy.yml)
- 本番と同じ Workers の実行環境と D1 の上で動かすテスト。データベースをモックせず、HTTP リクエストを送って API の振る舞いを確かめる。テスト名は「ログインしていない人はルームから抜けられない」のように、要件をそのまま文にした。(apps/api/test)
- セキュリティへの配慮。ログインは Google と GitHub の OAuth だけにし、パスワードを預からない。他人のタスクの名前は同じルームのメンバーにしか返さず、プールのタスクは本人にしか見えない。入力はタイトル 30 文字、重さ 1〜100% を API の Zod とデータベースの制約の両方で確かめる。OAuth の秘密情報はリポジトリに置かず、本番と開発で別の OAuth アプリを使う。(rooms.ts、schemas.ts、schema.ts、development.md)
- AI エージェントにもメンバーと同じルールで開発させる仕組み。ブランチ、コミット、テストの決まりを AGENTS.md に書き、API や画面の追加といったよくある作業の手順を Agent Skills にまとめた。Claude Code や Codex に任せても、メンバーが書くのと同じ形のコードとコミットになる。(AGENTS.md、.claude/skills、skills-lock.json)
Node.js 24 以上と pnpm 10 が必要。API まで動かす手順 (.dev.vars とローカルのデータベースの準備) は docs/development.md にある。
pnpm install
pnpm dev:mock # API なしで、モックを相手に画面だけを動かす (http://localhost:5173)