Souzoh Match — 要件定義書(再現用フルスペック)
このドキュメント 1枚だけ を別の Claude Code セッションに渡せば、ここに書かれたクオリティのアプリが再現できることを目的とした完全仕様書です。 プロダクト:ソウゾウ合同会社「爆速アプリ開発」LP に掲載するデモアプリ。 種別:共創マッチング(スキルの「できること ↔ 力を借りたいこと」でつなぐ)。恋愛・出会い系ではない。
実装者への最初の指示(そのまま使ってよい):
このMDだけを唯一の仕様として、記載どおりのデザイン品質・機能・データで実装してください。まず「作成/変更するファイル一覧」を提示 → 承認後に実装。色・余白・角丸は §3 のトークン/ユーティリティのみを使い、JSXに生の色コードを書かないこと。実装後は §13 の受け入れ基準を自己チェックしてください。
1. プロダクト概要
| 項目 | 内容 |
|---|---|
| コンセプト | 「できること」と「力を借りたいこと」で人をつなぐ共創マッチング。対等なスキル交換。恋愛でも求人でもない |
| 目的 | LPの目玉デモ。触った瞬間「最新の高級アプリ」と感じさせ、"仕組み(なぜマッチするか)"が一目で伝わること |
| 成功条件 | カードを数枚めくった時点で「これ自社の◯◯に使えるな」と読者が思う。細部まで作り込まれ、破綻や間延びが無い |
| 非ゴール | 本番のユーザーマッチング/推薦アルゴリズムの精度/バックエンド・DB・認証・課金 |
| シグネチャー | 重なりリング:自分の wantTo と相手の canDo の一致数を、弧の長さ+数字で表示(§6) |
| トーン | 明るいライト地+淡いオーロラ背景+グラス+アンバー×エメラルドのグラデーション。派手さは一点に集中し、他は静かに |
デザインの重要方針(過去のフィードバック反映):
- コーラル/ピンクは使わない(恋愛アプリの記号になるため)。暖色はアンバー〜オレンジまで。
- 余白を作りすぎない。各画面は情報密度で「作り込まれている」印象に。特にカードの中央に大きな空きを作らない。
- "変な部分"を残さない。半端な余白、文字のはみ出し、コントラスト不足、崩れは潰す。
2. 技術構成
- Vite + React 18(JSX) / Tailwind CSS v4(
@tailwindcss/vite)/ lucide-react(アイコン) - 状態管理:React の
useReducer+ Context(外部ライブラリ不使用) - バックエンド無し。全データはインメモリ(端末内のみ、永続化しない)
- スワイプは Pointer Events のみで実装(ライブラリ追加禁止)
- 単一ページ(ルーターなし。タブ切替は状態で管理)
package.json(依存の目安):
{
"type": "module",
"scripts": { "dev": "vite", "build": "vite build", "preview": "vite preview" },
"dependencies": { "lucide-react": "^0.474.0", "react": "^18.3.1", "react-dom": "^18.3.1" },
"devDependencies": { "@tailwindcss/vite": "^4.1.4", "@vitejs/plugin-react": "^4.3.4", "tailwindcss": "^4.1.4", "vite": "^6.3.5" }
}
index.html の <head> に Google Fonts を読み込む:
<link rel="preconnect" href="https://fonts.googleapis.com" />
<link rel="preconnect" href="https://fonts.gstatic.com" crossorigin />
<link href="https://fonts.googleapis.com/css2?family=Noto+Sans+JP:wght@400;500;700;900&family=Zen+Kaku+Gothic+New:wght@700;900&family=Space+Grotesk:wght@500;700&display=swap" rel="stylesheet" />
<body> は #root のみ、src/main.jsx を module 読み込み。viewport に viewport-fit=cover。
3. デザイン仕様(src/theme.css)
先頭で @import "tailwindcss";。以下を @theme に定義(Tailwind v4 のトークン)。JSXでは必ずこのトークン由来のクラス(bg-surface, text-ink, border-line 等)と、後述のユーティリティのみ使用。
3.1 カラートークン
--color-bg: #f5f6fc /* アプリ背景(冷たい極淡グレー=オーロラの下地) */
--color-surface: #ffffff /* カード面 */
--color-surface-2: #f1f3fb /* カード内の薄いパネル・入力欄 */
--color-ink: #14151f /* 本文(近黒) */
--color-ink-sub: #5b6478 /* 補助テキスト */
--color-ink-faint: #98a1b4 /* さらに薄い補助 */
--color-ink-inv: #ffffff /* 濃色/写真上の白文字 */
--color-line: #e7e9f2 /* ボーダー */
--color-accent: #ffb020 /* アンバー:気になる・CTA */
--color-accent-2: #ff8f1f /* グラデ用の深オレンジ極 */
--color-accent-deep: #9a5511 /* アンバー地の上で読む濃色 */
--color-accent-soft: #fff2d6 /* アンバー淡地 */
--color-accent-bubble: #ffe6a8 /* (旧チャット自分バブル。現在は grad-amber を使用) */
--color-match: #2ed3a0 /* エメラルド:マッチ・一致タグ */
--color-match-2: #17b8c9 /* グラデ用ティール極 */
--color-match-deep: #0a8f6e /* エメラルド系テキスト */
--color-match-soft: #dcf7ef /* エメラルド淡地 */
--color-sky: #46b6f5 /* シグネチャーグラデ第3極・オーロラ */
--color-iris: #7b74f2 /* オーロラのみに使う寒色ブルーム */
--color-skip: #8b93a6 /* 見送る(拒絶の赤にしない) */
--color-scrim: rgba(17,20,33,0.58)
3.2 タイポグラフィ
--font-display: "Zen Kaku Gothic New","Noto Sans JP",sans-serif /* 見出し・数字・ロゴ(700/900) */
--font-body: "Noto Sans JP",sans-serif /* 本文(400/500/700) */
--font-num: "Space Grotesk","Noto Sans JP",monospace /* 数字・時刻・稼働 */
スケール(目安):display 30/1.25、title 19/1.45、body 15/1.75、meta 12/1.4。見出しは font-black(900)を多用。
3.3 形・影
--radius-card: 26px
--radius-input: 15px
--radius-pill: 999px
--shadow-card: 0 18px 44px -12px rgba(21,24,46,.22), 0 2px 8px rgba(21,24,46,.05)
--shadow-pop: 0 36px 72px -16px rgba(21,24,46,.32)
--shadow-float: 0 8px 22px -8px rgba(21,24,46,.14)
3.4 グラデーション/グロー(:root に定義)
--grad-signature: linear-gradient(120deg,#ffb020 0%,#2ed3a0 52%,#46b6f5 100%) /* リング・ロゴ・見出し・帯 */
--grad-amber: linear-gradient(135deg,#ffc24b 0%,#ff8f1f 100%) /* 気になる・主CTA */
--grad-emerald: linear-gradient(135deg,#34e0ad 0%,#12b3c4 100%) /* 興味を送る・送信 */
--glow-amber: 0 10px 28px -8px rgba(255,143,31,.6)
--glow-emerald: 0 10px 28px -8px rgba(46,211,160,.55)
3.5 ユーティリティ(素のCSSクラスとして定義)
.aurora-bg…position:fixed; inset:0; z-index:0; pointer-events:none;4つの radial-gradient ブルーム(emerald @12% 8% / amber @92% 6% / sky @82% 88% / iris @8% 92%、いずれも ~0.2 前後の低透明度)+filter:saturate(1.05)。.aurora-drift… 20s のaurora-driftアニメで背景をゆったり移動(拡大1.06/微translate)。.glass…background: color-mix(in srgb, var(--color-surface) 72%, transparent); backdrop-filter: blur(18px) saturate(1.4);(-webkit- も)。.grad-amber/.grad-emerald/.grad-signature… 各グラデをbackground-imageに。.glow-amber/.glow-emerald… 各グローをbox-shadowに。.text-grad… signatureグラデを文字クリップ(background-clip:text; color:transparent)。.text-grad-anim… 上記に横スクロールのシマー(grad-shift3.2s linear infinite、background-size:200%)。ハレの一点(マッチ演出タイトル等)のみ。.chip-match…linear-gradient(135deg,#e6faf3,#d5f3ef)地 +color:match-deep+1pxの match/38% ボーダー。.chip-accent…linear-gradient(135deg,#fff3d6,#ffe9c6)地 +color:accent-deep+ accent/40% ボーダー。.avatar-ring…padding:2.5px; background-image:var(--grad-signature);(丸くして内側に白面を重ね、グラデ縁のアバターを作る)。.avatar-g0〜.avatar-g7… 生成アバターのグラデ地(写真もイラストも無い時のフォールバック。8色、linear-gradient(135deg,…))。body…background:var(--color-bg); font-family:var(--font-body); overscroll-behavior-y:none; -webkit-font-smoothing:antialiased;。.swipe-surface…touch-action:none; user-select:none;(スワイプでのスクロール暴発防止)。.thin-scroll::-webkit-scrollbar{width:0;height:0}。
3.6 アニメーション(keyframes とクラス)
すべて theme.css に定義。名前と用途:
| クラス | keyframes | 用途 |
|---|---|---|
.anim-fade |
fade-in 200ms | オーバーレイのフェードイン |
.anim-toast |
toast-in 220ms | トースト出現 |
.anim-sheet |
sheet-up 260ms | ボトムシート上昇 |
.anim-pop |
overlay-pop 320ms(0.82→1.04→1) | マッチ演出カード出現 |
.anim-screen |
screen-in 320ms | タブ切替時の画面入場(App で key={tab} により再生) |
.anim-rise |
rise 460ms、animation-delay: calc(var(--i,0)*55ms) |
リスト/グリッドの stagger 入場 |
.anim-tap |
tap-in 200ms | 押下の沈み込み(任意) |
.anim-ring-bump |
ring-bump 420ms(1→1.28→1、弾む) | 一致数が変化した瞬間だけ数字を弾ませる |
.anim-glow |
soft-glow 2.4s infinite | 新着マッチのリング枠が呼吸 |
.anim-bubble |
bubble-in 260ms | チャット吹き出しの入場 |
.typing-dot |
typing-bounce 1200ms infinite | 相手の入力中3点(:nth-child(2)160ms/(3)320ms 遅延) |
.anim-float |
float-y 4.5s infinite | スプラッシュの周回チップが浮遊 |
.anim-shine::after |
shine 3.6s infinite | CTAを走る光沢 |
.text-grad-anim |
grad-shift 3.2s infinite | 見出しグラデのシマー |
prefers-reduced-motion: reduce:anim-pop/sheet/toast/fade/rise/screen/tap/ring-bump/bubble は animation-duration:1ms に、anim-heart/confetti/anim-glow/typing-dot/text-grad-anim/anim-float/aurora-drift/anim-shine::after は animation:none。.text-grad-anim は静的な signature グラデに戻す。.stack-motion(スタック/リングのtransition)は transition:none。※ドラッグ追従だけは残す。
4. 情報設計・ナビゲーション
src/app.config.js:
export default {
appName: "Souzoh Match",
tagline: "「できること」と「力を借りたいこと」で人をつなぐ、共創マッチング",
nav: [
{ key:"swipe", label:"探す", icon:"Search" },
{ key:"browse", label:"一覧", icon:"LayoutList" },
{ key:"matches", label:"マッチ", icon:"Heart" },
{ key:"me", label:"プロフィール", icon:"User" },
],
};
- モバイル:下部タブバー(グラス、
fixed bottom)。アクティブは match-deep、アイコン下にラベル。matchesに未読合計バッジ(未読メッセージ数+届いた興味数、グラデ)。 - PC(md〜):左に幅248pxの縦ナビ(グラス、ロゴ+tagline+各項目)。アクティブ項目は左端に signature グラデの縦バー+淡いグラデ地。
- 起動フロー:
state.entered === falseの間は スプラッシュを全画面表示。「はじめる」で本体へ。 - オーバーレイの重なり順(z-index):プロフィール詳細(44) < チャット(45) < 各シート/設定(50) < マッチ演出(50, 後勝ち) < トースト(60)。
5. 画面仕様
5.0 共通
- 全画面の最背面に
.aurora-bg.aurora-driftを敷く(AppShell)。 - カードは
bg-surface rounded-card shadow-card/float。淡いborder-line。 - 主CTA=アンバー(
grad-amber+glow-amber)、副次/送信・マッチ系=エメラルド(grad-emerald+glow-emerald)。文字はtext-ink-inv。
5.1 スプラッシュ(スターティング画面)★重要
狙い:文字は最小限、主役は重なりリング。開いた瞬間に"仕組み"を体感させる。
- 縦中央寄せ、
max-w-sm、余白は詰めめ(間延びさせない)。要素はanim-riseを--i0→5 でstagger。 - 構成(上から):
- ロゴ(
Logo、size 28) - エンブレム(
relative h-[224px] w-[256px]):中央にOverlapRing(size 112,valueを 0→2 にカウントアップ,max=2, ラベル"一致")をガラス丸地に。周囲に4つのスキルチップを.anim-floatで浮遊配置:上=「UIデザイン」(一致/emerald+glow)、下=「LPコピー」(一致)、左=「動画編集」(候補)、右=「React」(候補)。背後に signature グラデのblur-2xl opacity-20の光。 - 見出し:小さな導入
「できる」と「借りたい」が(16px, ink-sub) + 大きな重なる。(38px,font-black,.text-grad-anim)。 - サブ:
対等につながる、共創マッチング。(13px, ink-sub) - CTA:
はじめる →(grad-amber+glow-amber+.anim-shine、押下active:scale-[0.98])→onEnter © 2026 Souzoh Match(10px, faint)
- ロゴ(
- カウントアップ:
setInterval460ms で 0→2(一致チップ数)。
5.2 探す(スワイプ)★固有画面
ヘッダー:中央「探す」、右に絞り込みアイコン(SlidersHorizontal)→ 一覧へ。
カードステージ:モバイル h-[min(68dvh,560px)] max-w-[400px]、PC 560×400px。CardStack を配置。
カード(写真主役レイアウト=SwipeCard):カード中央に空きを作らないための構成。
- 上部=人物写真(
PersonPhoto、残り高さいっぱいflex-1)。下側に暗転スクリム(bg-gradient-to-t from-black/70 via-black/25 to-transparent)。- 右上:
OverlapRing(size 52)をガラス丸地に。 - 左上:オンライン可バッジ(
person.online時、ガラス pill、emerald ドット)。 - 写真下部にオーバーレイ:氏名(24px black)+年齢(num)/肩書き+エリア(MapPin)/一言
intro(1行省略)。文字は白。
- 右上:
- 下部=白の情報エリア:
できること(見出し左に emerald の小バー)→ チップ群(size="sm"、一致はchip-match)力を借りたいこと(見出し左に amber の小バー)→ チップ群(相互一致はchip-match)- フッター:
稼働(Clock+num)と、相互一致があれば相互に補える(grad-amberpill)。上にborder-line区切り。
操作:
| 操作 | 結果 |
|---|---|
| 右ドラッグ / ♡ | 気になる(LIKE)。右上へ回転退場 |
| 左ドラッグ / × | 見送る(SKIP)。左下へ退場 |
| 上ドラッグ / ✉ | 興味を送るモーダル(M6)を開く |
| カードをタップ | プロフィール詳細へ |
| ↩ | 直前の1枚だけ戻す(連続不可) |
| キーボード ← → ↑ | 上記に対応(詳細/チャット/シート/演出が開いている間は無効) |
ドラッグ挙動の数値(厳守):判定 THRESHOLD=80px / 傾き MAX_TILT=12deg(drag.x/16 をclamp)/ 復帰 RETURN_MS=180ms / 退場 EXIT_MS=220ms / タップ判定 TAP_SLOP=8px。
- 方向ラベル:移動量が閾値を超えると
気になる(emerald)/見送る(skip)/興味を送る(accent) のラベルがフェードイン。 - 方向グロー:60px超で、進行方向に応じカード縁が発光(右=emerald
drag-glow-like/ 左=slatedrag-glow-skip/ 上=amberdrag-glow-up)。 - スタック:
renderIdsは先頭3枚(退場中は4枚で1つ繰り上げ)。2枚目scale(.95) translateY(12px)、3枚目scale(.90) translateY(24px)、透明度も段階(0.75 / 0.45)。退場:右translate(130%,-18%) rotate(12deg)、左translate(-130%,22%) rotate(-12deg)。 - ボタン操作は
CardStack内のcommit(dir)/openInterest()を module 変数controlRef経由でSwipeScreenのボタンから呼ぶ。
アクションボタン(3つ+戻す):見送る(白・skip、X)/気になる(grad-amber+glow-amber、Heart 塗り白、68px と大きめ)/興味を送る(grad-emerald+glow-emerald、Send)。下に「直前の1枚に戻す」(undoable が無い時は disabled)。
マッチ成立演出:u01 / u05 / u09 を右スワイプすると必ず発火。届いた興味の承諾でも再利用。→ §5.4末尾。
デッキが尽きたら:中央に空状態(Compass+「今日はここまでです」)+ もう一度めくる(refillDeck:マッチ/送信済みを除いて再構成)+ テキストリンク「条件を変えて探す」(一覧へ)。
5.3 一覧・絞り込み(browse)
- 検索バー(キーワード:氏名/肩書き/エリア/タグを対象)
- フィルタ3つ(select):
分野(すべて/開発/デザイン/映像/士業/その他)・エリア(すべて/オンライン可/東京/関西/その他エリア)・稼働時間帯(すべて/平日夜/平日昼/土日/早朝) - クイックトグル:
オンライン可(chip-match風のトグル)・キープ(chip-accent、キープ数バッジ)。フィルタが1つ以上効いていれば右に× クリア。 - 件数表示:
N 人が見つかりました(N は num 太字)。 - 並び替えタブ:
一致数が多い順(overlap降順)/新着順(id降順)。アクティブに match の下線。 - グリッド:2列(
lg:3列)。各カードは縮小版(アバター+小リング+氏名/年齢/肯書き/エリア+canDoチップ3つ)。anim-rise+--i(i%10)で stagger、ホバーで-translate-y-0.5 shadow-card。タップで詳細へ。 - 空状態:
FilterX+「条件に合う人が見つかりません」+「フィルタを1つ外す」(1つずつ緩めるrelaxFilter)。 - エリア判定:オンライン可=
online || area含"オンライン"、東京=area.startsWith("東京")、関西=大阪/京都/神戸、その他=上記以外。
5.4 マッチ/届いた興味/送った興味(matches)
- 上部タブ3つ(各件数バッジ):
マッチ/届いた興味/送った興味。アクティブは match-soft 地。 - マッチ:
isNewの新着を横スクロールのアバター列(グラデ縁+anim-glow)。下に会話一覧(アバター/氏名/最新メッセージ/時刻/未読数)。未読がある行は左端に3pxのアンバーバー+未読バッジ(grad-emerald)。タップでチャット。 - 届いた興味:相手カード+添えられた一言+一致タグ。
ありがとう、話したい(grad-amber)で承諾→マッチ成立演出+メッセージ(相手の一言をチャット冒頭に流用)/今回は見送る(declineInterest)。左端アンバーバー。anim-rise。 - 送った興味:
sentInterestsを一覧(アバター/氏名/送った一言/承認待ちpill=Clock3)。空なら「まだ送っていません」+「探しにいく」。
マッチ成立演出(MatchOverlay):暗転(scrim)+ anim-pop のカード。上部に signature グラデ帯 opacity-20。中央に自分と相手のアバター(avatar-ring グラデ縁、82px)が寄り、間に grad-amber の丸+Heart(anim-heart 鼓動)+glow-amber。紙吹雪(confetti、amber/match交互6粒)。タイトル マッチしました!(26px, .text-grad-anim)+「一緒にやりたいことが見つかりました」+一致タグ。CTA:メッセージを送る(grad-amber+glow → チャット)/ 続けて探す(dismissCelebration)。
5.5 プロフィール詳細(person-detail)
- 上に重ねるグラス戻る/キープ(
Bookmark、押下でトグル=toggleKeep、キープ中は accent 塗り)ボタン。 - ヒーロー帯:
h-24の signature グラデ帯。その上にアバター(avatar-ringグラデ縁, 78px)が帯をまたいで配置、氏名は帯の下(無地)に置いて可読性確保。右にOverlapRing(56)。 - 一致タグのサマリー(
Sparkles+一致したタグ、chip-match)。 - 自己紹介
bio+ 一言intro(イタリック faint)。 - できること/力を借りたいこと(一致は
chip-match)。 - これまでの共創(
worksを箇条書きカード、先頭に amber ドット)。※評価スコア・星・レビューは入れない(実体のない信頼を作らない)。 - 稼働(Clock+num)。
- 下部固定:
見送る(デッキ内の相手のみ)/興味を送る(grad-emerald+glow)。
5.6 興味を送るモーダル(interest)
- ボトムシート(PCは中央モーダル、
Sheetコンポーネント、Escで閉じる、背面scrim)。 - 上部に相手の縮小カード(アバター/氏名/年齢/肩書き/エリア)+
OverlapRing(52)。 - 一言入力(
textarea、120字カウンター、プレースホルダ「メッセージを入力してください」、見出し「一緒にやりたいことを一言で」)。 - 定型文チップ3つ:
話を聞いてみたいです/お互いに補い合えそうです/具体的な相談があります(タップで本文に挿入、120字でclamp)。 - 送信(
grad-amber+glow)→sendInterest→ シート下降+トースト「興味を送りました」。デッキ先頭相手なら1枚進める。
5.7 チャット(chat)
- ヘッダー(グラス):戻る/アバター(グラデ縁)+氏名+状態(
入力中…orオンライン、emerald ドット)/その他。 - メッセージ領域:日付チップ「今日」。
- 空のとき=アイスブレイク:中央にアバター(グラデ縁)+「◯◯ さんとマッチ!」+一致タグの一言+候補3つ(タップで送信):
はじめまして!プロフィール拝見しました/一緒にやれそうなこと、相談させてください/まずは軽くお話しできませんか?。 - 自分=右・
grad-amber地に白文字、anim-bubble。既読/送信済み表示:自分の最後の発言より後に相手発言があれば「CheckCheck既読」、なければ「Check送信済み」。 - 相手=左・白地、アバター28px。
- 送信の約1.4秒後、
typing(3点インジケータ)→autoReplyから定型返信(RECEIVE_REPLYはmsg.autoの数で巡回)。
- 空のとき=アイスブレイク:中央にアバター(グラデ縁)+「◯◯ さんとマッチ!」+一致タグの一言+候補3つ(タップで送信):
- クイック返信(会話が1件以上あるとき、入力上に横スクロール):
ありがとうございます!/ぜひお願いします/日程を決めましょう/詳細を教えてください(タップで即送信)。 - 入力バー(グラス):添付(
Paperclip、押下でトースト「デモでは添付は省略しています」=正直に)/テキスト入力(Enterで送信、IME変換中は無視)/送信(grad-emerald+glow、空なら disabled)。 - 送受信時は最下部へスムーススクロール。
5.8 マイプロフィール(my-profile)★"仕組み"の実演
- 左カラム(PC)/上(モバイル):
- 自分カード(アバターグラデ縁/「自分」/肩書き/エリア)+右に歯車(
openSettings)。 - プロフィール完成度メーター:
profileCompleteness(me)を % 表示+signatureグラデのバー。100%未満なら「タグや自己紹介を足すと、届きやすくなります」。 - オンライン可トグル(
me.onlineとsettings.showOnlineを連動)。
- 自分カード(アバターグラデ縁/「自分」/肩書き/エリア)+右に歯車(
- 右カラム:
- できること(
chip-match)/力を借りたいこと(chip-accent)を追加・削除(TagEditor。+追加でインライン入力、Enter確定、Escで取消、×で削除)。見出し右に小ヒント。 - 自己紹介(
bio)を編集(鉛筆で編集モード→textarea、完了で戻す)。 - 分野(select、FIELD_OPTIONS)/稼働時間帯(select、現在値を先頭に)。
- 一致数のライブプレビュー:デッキ先頭相手に対し「初期の一致数 → 現在の一致数」を2つのリングで表示(
ArrowRight挟む)。タグを編集すると探す画面のリング数字が即座に変わることの説明+「探す画面で確認する」ボタン。※初期値は canDo が {UIデザイン,LPコピー,商品撮影} に一致する数(=自分の初期wantTo基準の見せ玉)。
- できること(
5.9 設定(settings)
Sheet で表示。トグル3つ(grad-emerald の ON):通知 / オンライン表示(me.online 連動)/ 効果音。「このデモについて」の説明カード(データは端末内のみ・サーバー送信なし)。デモを最初から(reset → entered:true の初期状態+トースト、タブは swipe に)。
6. シグネチャー機構:重なりリング(OverlapRing)
- 入力:
value(一致数),max,size,label="一致",onClick?。 - 表示:SVG 円。背景円(line)+ グラデ弧(
stroke=url(#grad)=amber→match→sky の linearGradient、stroke-linecap:round)。strokeDasharrayをvalue/maxの比で描く(最低 0.045 は見せる)。 value>0のとき弧に ドロップシャドウのグロー(feDropShadow, match色)+中央数字を.text-grad。0 はtext-ink。- 一致数が変化した瞬間だけ数字を
.anim-ring-bumpで弾ませる(マウント時は弾ませない。useRefで前値比較)。 idはuseId()で一意化(複数配置の衝突回避)。
一致数の算出(store.js、ブラックボックスにしない):
overlapTags(me, person) = person.canDo.filter(t => me.wantTo.includes(t)) // リングに表示
mutualTags(me, person) = person.wantTo.filter(t => me.canDo.includes(t)) // 「相互に補える」
profileCompleteness(me) = 次の8条件の充足率:
canDo>=1, canDo>=3, wantTo>=1, wantTo>=3, bio(20字以上), intro有, availability有, field有
7. データモデル & デモデータ
7.1 型
// person / me
{ id, name, age, role, area, online, field, intro, bio, canDo:[], wantTo:[], availability, works:[] }
// match
{ personId, matchedAt, unread, lastAt, isNew, messages:[{from:"me"|"them", body, at, auto?}], autoReply:[] }
// interest(届いた) { personId, message, receivedAt, status:"pending" }
// sentInterest(送った) { personId, message, at, status:"pending" }
7.2 自分(u00・me.js)
name あなた / age 30 / role ノーコード開発 / area 東京・中央区 / online true / field 開発
intro 業務の面倒を仕組みで消すのが好きです
bio ノーコードと業務自動化で、社内の手作業を仕組みに置き換えるのが得意です。作るところまでは走れるので、見た目と言葉の力を貸してくれる人と組みたいです。
canDo ノーコード開発 / 業務自動化 / Claude Code
wantTo UIデザイン / LPコピー / 商品撮影
availability 週3〜5時間 / 平日夜・土日午前
AVAILABILITY_OPTIONS: 週1〜2時間 / 平日夜|週2〜3時間 / 平日夜|週3〜5時間 / 平日夜・土日午前|週5〜8時間 / いつでも|週2時間 / 早朝
FIELD_OPTIONS: 開発|デザイン|映像|士業|その他
7.3 人物14名(people.js)
できること/力を借りたいことが噛み合うペアを意図的に配置(及川↔早瀬、桜庭↔富永、宮下↔千葉)。
| id | 氏名 | 年齢 | 肩書き | エリア | online | field | できること | 力を借りたいこと | 稼働 |
|---|---|---|---|---|---|---|---|---|---|
| u01 | 及川 涼 | 29 | プロダクトデザイナー | 東京・渋谷 | ✓ | デザイン | UIデザイン / Figma / プロトタイピング | フロントエンド実装 / 個人開発の壁打ち | 週2〜3時間 / 平日夜 |
| u02 | 楢崎 健吾 | 34 | 管理栄養士 | 大阪 | – | その他 | 献立設計 / 栄養計算 / 監修 | 動画編集 / SNS運用 | 週1〜2時間 / 土日 |
| u03 | 三雲 あさひ | 31 | バックエンドエンジニア | オンライン | ✓ | 開発 | API設計 / Python / インフラ | ロゴ制作 / LPコピー | 週4〜6時間 |
| u04 | 白鳥 恵理 | 42 | 中小企業診断士 | 名古屋 | – | 士業 | 事業計画 / 補助金申請 / 資金繰り | 業務自動化 / 自社サイト制作 | 週2時間 / 平日昼 |
| u05 | 桜庭 拓真 | 33 | 映像ディレクター | 福岡 | – | 映像 | 撮影 / 動画編集 / カラーグレーディング | 音楽制作 / 見積りの相談 | 週3〜4時間 |
| u06 | 泉 みちる | 38 | 社会保険労務士 | 札幌 | – | 士業 | 就業規則 / 労務相談 / 助成金 | 業務自動化 / 資料デザイン | 週1〜2時間 / 平日夜 |
| u07 | 神谷 拓海 | 30 | データアナリスト | 横浜 | ✓ | 開発 | SQL / ダッシュボード構築 / 分析設計 | 英語の壁打ち / プレゼン構成 | 週2〜3時間 |
| u08 | 宮下 かなえ | 36 | 陶芸家 | 岐阜 | – | その他 | 器の制作 / ワークショップ企画 | ECサイト構築 / 商品撮影 | 週2時間 / 不定 |
| u09 | 早瀬 蓮 | 27 | フロントエンドエンジニア | オンライン | ✓ | 開発 | React / アニメーション実装 / 保守 | UIデザイン / 企画のネタ出し | 週5〜8時間 |
| u10 | 一之瀬 由紀 | 32 | コピーライター | 京都 | – | その他 | LPコピー / ネーミング / 取材記事 | SEO設計 / 表計算の自動化 | 週3時間 / 平日昼 |
| u11 | 富永 廉 | 35 | 音楽プロデューサー | 東京・世田谷 | – | 映像 | 作編曲 / MA / 音源制作 | 動画編集 / 権利まわりの相談 | 週2〜4時間 / 夜 |
| u12 | 黒木 沙羅 | 28 | パーソナルトレーナー | 神戸 | – | その他 | 運動指導 / オンライン指導設計 | 予約システム / 動画撮影 | 週2時間 / 早朝 |
| u13 | 千葉 智也 | 41 | 農家(6次産業化) | 長野 | – | その他 | 農作物 / 加工品開発 / 産地の知見 | ブランディング / 商品撮影 / 販路開拓 | 週1〜2時間 |
| u14 | 舞原 詩織 | 33 | 通訳・翻訳(英日) | オンライン | ✓ | その他 | 同時通訳 / 技術翻訳 / 字幕 | 音声編集 / 名刺デザイン | 週3〜4時間 |
一言(intro):
u01 作ったものが動いているところが見たいだけの人です
u02 「体にいい」で終わらせず、続けられる形にするのが仕事です
u03 裏側は得意ですが、表側が壊滅的なので助けてください
u04 数字の話をやわらかい言葉に翻訳します
u05 撮る・切る・整えるまで一人で完結できます
u06 制度は使えるものを使ったほうがいい、という立場です
u07 データを見て終わりにせず、次の一手まで一緒に考えます
u08 土日は窯の前にいます。器を全国に届けたい
u09 動くものを最短で作るのが好きです。設計は苦手
u10 一行で説明できないものは、たぶんまだ整理されていません
u11 映像に音が付くと世界が変わるので、その瞬間が好きです
u12 続かない運動に意味はないと思っています
u13 畑はあるのに売り方がわからない、を7年やっています
u14 訳すというより、伝わる形に置き換える仕事です
自己紹介(bio)・これまでの共創(works)は各人3件、上表の職種に沿って自然な内容で(例:u01 works = ECサイトのUI × 商品撮影 / 予約システムのUI設計 × バックエンド開発 / LPデザイン × ライティング)。※文面は §7.5 参照。
7.4 デッキ順・確定マッチ
DECK_ORDER = [u09, u01, u10, u05, u13, u03, u08, u11, u07, u04, u12, u14]
GUARANTEED_MATCH = [u01, u05, u09] // 右スワイプで必ずマッチ演出
意図:1枚目 u09(自分のwantTo:UIデザインと重なり一致1)、2枚目 u01(一致2)で、最初の2枚で"リングの数字が変わる"のを体感させる。
7.5 既存マッチ4件(matches.js)
u10 一之瀬 由紀 / matchedAt 3日前 / unread 2 / lastAt 14:32 / isNew true
me はじめまして!LPのコピー、ぜひ相談させてください。 (13:58)
them こちらこそ!サービスの概要だけ先に教えてもらえますか? (14:10)
them LPの構成案、ざっくり作ってみました (14:32)
autoReply: 見出しだけ先に決めちゃいましょう / 今週中なら動けます
u08 宮下 かなえ / 4日前 / unread 1 / 11:07 / isNew true
me 器の写真、ぜひ撮らせてください。ECまわりもお手伝いできます。 (10:41)
them 撮影、来週の火曜はいかがですか? (11:07)
autoReply: 岐阜まで来ていただく形でも大丈夫ですか? / 器は15点ほど用意します
u03 三雲 あさひ / 先週 / unread 0 / 昨日 / isNew false
them LPの実装、裏側はこちらで巻き取ります! (昨日)
me 助かります。デザインはFigmaで共有しますね。 (昨日)
them APIの叩き方、こちらで用意しておきます (昨日)
autoReply: 認証まわりだけ先に共有しますね / 詰まったらいつでも
u13 千葉 智也 / 先週 / unread 0 / 月曜 / isNew false
them 加工品のラベル、意見もらえますか (月曜)
autoReply: 写真だけ先に送ります / トマトの加工品です。名前がまだ決まっていません
DEFAULT_AUTO_REPLY = [ありがとうございます!, 来週あたりどうですか?] // 新規マッチ用
7.6 届いた興味3件(interests.js、status pending)
u06 泉 みちる 10:15 顧問先の労務手続きを自動化したくて、相談だけでもできませんか
u12 黒木 沙羅 昨日 オンライン指導の予約まわりを整えたいです。お互いに補い合えそうです
u04 白鳥 恵理 月曜 補助金の申請支援と交換で、業務まわりのご相談ができればと思っています
8. 状態管理(store.js)
useReducer + Context。初期状態は freshState() を返す関数(RESET で再利用)。
state 形状:
entered:false, me, deck:[...DECK_ORDER], undoable:null,
matches:[...初期4], interests:[...初期3], sentInterests:[], keep:[],
settings:{ notifications:true, showOnline:true, sound:false },
tab:"swipe", detailId:null, chatId:null, interestFor:null,
celebration:null, settingsOpen:false, toast:null
アクション(reducer の type)と挙動:
ENTER→ entered true。RESET→ freshState()(entered:true, toast "デモをリセットしました")。LIKE→ 先頭を捨てる。GUARANTEED_MATCHかつ未マッチなら matches 先頭に newMatch 追加+celebrationセット。undoable={personId, kind:"like"}。SKIP→ 先頭を捨てる。undoable={…,"skip"}。UNDO→undoableを deck 先頭に戻し、undoable=null(連続不可)。REFILL_DECK→ DECK_ORDER から「マッチ済み/送信済み」を除いて再構成+トースト。SEND_INTEREST{personId,message}→ sentInterests 先頭に追加(status pending)。デッキ先頭ならデッキも進める。interestFor/detailId を閉じ、トースト「興味を送りました」。TOGGLE_KEEP{personId}→ keep をトグル+トースト。ACCEPT_INTEREST{personId}→ interests から除去、未マッチなら newMatch(相手の一言を冒頭 them メッセージに)+celebration。DECLINE_INTEREST→ interests から除去+トースト「今回は見送りました」。ADD_TAG{kind,tag}/REMOVE_TAG{kind,tag}→ me.canDo|wantTo を編集(重複無視)。SET_ME{key,value}→ me の任意フィールド更新(bio/field/online/availability 等)。SET_SETTING{key,value}/OPEN_SETTINGS/CLOSE_SETTINGS。SEND_MESSAGE{personId,body,at}→ 該当 match に me メッセージ追加、lastAt 更新。RECEIVE_REPLY{personId,at}→ autoReply をmsg.autoの数で巡回して them メッセージ追加(auto:true)。MARK_READ{personId}→ unread 0, isNew false。- ナビ系:
SET_TAB(detail/chat も閉じる),OPEN_DETAIL/CLOSE_DETAIL,OPEN_CHAT(celebration閉じ+既読化),CLOSE_CHAT,OPEN_INTEREST/CLOSE_INTEREST,DISMISS_CELEBRATION,SET_TOAST。
newMatch(personId, note?) … matchedAt "たった今", unread 0, isNew true, messages(note があれば them の1件), autoReply=DEFAULT_AUTO_REPLY。
Provider は actions(上記を dispatch する薄いラッパ群)と state を useMemo で提供。overlapTags/mutualTags/profileCompleteness/personById も store.js から export。
9. コンポーネント一覧(契約)
components/ui/
Avatar.jsx 丸アバター。jpg → 同梱SVG(dataURI) → グラデ頭文字 の順にフォールバック。props: person,size,ring,className
PersonPhoto.jsx 矩形カバーの人物写真。同じフォールバック順。カード用。props: person,className
Chip.jsx タグチップ。variant: neutral|matched|accent|outline、size sm|md、glow、onRemove、onClick
OverlapRing.jsx §6
Sheet.jsx ボトムシート/中央モーダル(Esc・背面scrim・グラバー)
Toast.jsx state.toast を 2.4s 表示(CheckCircle2+文言、下中央、grad不使用の ink 地)
components/shell/
AppShell.jsx オーロラ背景+PC縦ナビ+モバイル下部タブ(グラス、未読バッジ)
Logo.jsx 2弧のSVGマーク+"Souzoh Match"(Match は .text-grad)
features/
splash/Splash.jsx §5.1(onEnter を受ける)
swipe/CardStack.jsx Pointer Events・スタック・退場・ドラッググロー・キーボード
swipe/SwipeCard.jsx 写真主役カード(§5.2)
swipe/MatchOverlay.jsx マッチ演出(§5.4末尾)
swipe/SwipeScreen.jsx ヘッダー+ステージ+アクションボタン+空状態
browse/Browse.jsx §5.3
matches/Matches.jsx §5.4(3タブ)
person-detail/PersonDetail.jsx §5.5
interest/InterestSheet.jsx §5.6
chat/Chat.jsx §5.7
my-profile/MyProfile.jsx §5.8
settings/Settings.jsx §5.9
App.jsx entered で Splash 分岐、タブで画面切替(key で anim-screen)、各オーバーレイを常設
main.jsx StoreProvider で App を包む
data/ people.js / me.js / matches.js / interests.js / avatars.js(アバターSVGを dataURI で同梱)
アバターのフォールバック実装:Avatar/PersonPhoto は sources=[ '/images/{id}.jpg', avatarData[id] ] を順に試し、両方失敗で .avatar-gN(id ハッシュで8色)+頭文字。avatars.js はプレースホルダの人物イラスト(例:DiceBear notionists を dataURI 化)を各 id 分持つ。本番は public/images/{id}.jpg を置けば実写優先。
10. インタラクション定数(再掲・厳守)
判定 80px / 傾き最大 12deg / 復帰 180ms / 退場 220ms / タップ 8px / 方向グロー閾 60px / 自動返信 1.4s / トースト 2.4s / stagger 55ms×index。
11. 画像仕様(用意するのは人物写真15枚だけ)
- 置き場所
public/images/、ファイル名u00.jpg〜u14.jpg(u00=自分)。 - 縦3:4(推奨900×1200)、バストアップ、顔は上寄り中央(丸抜きで切れないよう頭上に余白)、無地の淡い背景、15枚すべて同じ光・背景トーンに統一。
- GPT等での生成は、細部を縛らず"狙い"を伝えて最適化させる(ふんわり指示)。共通文の例:
共創マッチングアプリのプロフィール写真。日本のはたらく人の、自然でやわらかいポートレート。かしこまりすぎず信頼感のある雰囲気で。15人ぶんを並べても「同じシリーズ」に見えるよう背景・光・トリミングのトーンを揃える(背景は無地〜淡い一色、やわらかい自然光がおすすめ)。縦3:4のバストアップ、顔は上寄り中央、頭上に少し余白。細部は魅力的に見えるようお任せ。 今回は「{各人物の一言:例 カジュアルで少し若い、パーカーが似合う27歳}」で。
- 未配置でもフォールバックで成立するが、写真主役カードは実写で本領。
12. ディレクトリ構成
souzoh-match/
├── index.html (Google Fonts 読込・#root)
├── package.json / vite.config.js(react + tailwindcss プラグイン)
├── public/images/ u00.jpg〜u14.jpg(任意・実写差し替え)
├── src/
│ ├── theme.css §3 全部
│ ├── app.config.js §4
│ ├── main.jsx / App.jsx
│ ├── store.js §8
│ ├── data/ people / me / matches / interests / avatars
│ ├── components/ui/ , components/shell/
│ └── features/ §9 の各ディレクトリ
└── IMAGES.md §11 の詳細
13. 受け入れ基準(実装後に自己チェック)
- 起動時にスプラッシュ→「はじめる」で本体。スプラッシュのリングが 0→2 にカウントアップ。
- スワイプがドラッグ/ボタン/キーボード(←→↑)の3経路で動く。
- ドラッグ量に応じてカードが傾き(最大12度)、方向ラベルとカラーグロー縁が出る。閾値80px。
-
u01 / u05 / u09の右スワイプでマッチ演出。↩で直前1枚のみ戻せる(連続不可)。 - スワイプカードに大きな空きが無い(写真主役+情報エリアで埋まる)。
- マイプロフィールでタグを足す/消すと、探す&一覧のリング数字が即座に変わり、変化時だけ数字が弾む。
- マッチ/届いた興味/送った興味の3タブが機能。興味の承諾→演出→チャットが開ける。送信で送った興味に承認待ちが並ぶ。
- チャット:アイスブレイク→送信→入力中→自動返信→既読、クイック返信が動く。
- 一覧:件数表示、オンライン可/キープのトグル、クリア、空状態と緩和導線。
- 詳細:ヒーロー帯+帯またぎアバター、キープのトグルが一覧のキープ絞り込みと連動。評価スコアは無い。
- 設定:3トグルとリセットが動く。
- 375px幅と1440px幅で崩れない。JSX内に生の色コードが1つも無い(トークン/ユーティリティのみ)。
-
prefers-reduced-motion: reduceで演出アニメが止まる(ドラッグ追従は残る)。 -
npm run buildが通り、dist/を配信して表示できる。
14. ビルド・デプロイ
npm install
npm run dev # 開発
npm run build # dist/ 生成
npm run preview # dist をローカル配信
静的サイト。Cloudflare Pages / Netlify / Vercel に「ビルド npm run build / 出力 dist」で連携、またはドラッグ&ドロップ。単一ページのため特別な rewrite 不要。
15. 実装順序(推奨)
- 雛形(Vite+React+Tailwind v4)→
theme.css(§3)→app.config.js/data/(§7)を入れてビルドを通す。 store.js(§8)+components/ui(Avatar/PersonPhoto/Chip/OverlapRing/Sheet/Toast)。AppShell+Splash+SwipeScreen/CardStack/SwipeCard/MatchOverlay(§5.1/5.2/5.4)。ここでスワイプの数値を厳守。Browse/PersonDetail/Matches(3タブ)。MyProfile(完成度・タグ編集・ライブプレビュー)/InterestSheet/Chat/Settings。- 余白の詰め・"変な部分"潰し・レスポンシブ確認 → §13 で自己チェック。
付記:デザインの効かせどころ(品質の勘所)
- 派手さ(グラデ・グロー・シマー)は リング/主CTA/マッチ演出 に集中。一覧やチャットの地は静かに。
- 写真は必ずスクリムを敷いて白文字の可読性を担保(写真が明るくても破綻しない)。
- 余白は「意図した余白」だけ残す。半端な空白・間延び・中央の空きは埋める。
- 数字・時刻・稼働は
font-num(Space Grotesk)。見出しはfont-display(Zen Kaku Gothic New 900)。 - 非恋愛コンセプト厳守:コーラル/ピンク不使用、評価スコア/星なし。


▶