🌟 Swizzle - Short Game Platform

5-30秒で完結するショートゲームプラットフォーム
TikTok・YouTubeショート動画のようなUXで「簡単に作って、簡単に遊ぶ」を実現

🎯 プロジェクト概要

コンセプト

• 作る側: 小学生でも作れるほど簡単
• 遊ぶ側: 次々と面白いゲームが流れてくる体験
• 差別化: インタラクティブ性による既存ショート動画との差別化

ターゲット

• プレイヤー: ショート動画を見る10-20歳層
• クリエイター: プログラミング経験不要の創作者
• プラットフォーム: 創作・キュレーション中心（競争より創造性重視）

🚀 現在の実装状況

✅ Phase 1: テンプレート実装（完了）

• 20種類のゲームテンプレート: 完全実装・動作確認済み
• PixiJS 7.x ゲームエンジン: 軽量・高パフォーマンス
• 自動連続プレイ: メイドイン俺風UX実現

✅ Phase 2: エラーハンドリング強化（完了）

• GameErrorManager: 8種類エラー分類・自動復旧
• EnhancedGameCanvas: ユーザーフレンドリーエラー表示
• パフォーマンス監視: FPS・メモリ使用量表示

✅ Phase 3: Supabase統合（完了）

• ✅ データベース: PostgreSQL + RLS設定完了
• ✅ 認証システム: ユーザー登録・ログイン実装完了
• ✅ データ保存: ゲーム作成・お気に入り機能実装完了

✅ Phase 4: 決済システム（完了）

• ✅ Stripe統合: Checkout・Customer Portal・Webhook実装
• ✅ サブスクリプション管理: Free/Premiumプラン対応
• ✅ 本番環境: セキュリティ強化・自動デプロイ設定完了

🎮 実装済みゲームテンプレート（20種類）

Action系（8種類）

1. CuteTapGame - キュートタップゲーム
2. QuickDodgeGame - 障害物回避ゲーム
3. CollectItemsGame - アイテム収集ゲーム
4. JumpAdventureGame - ジャンプアクションゲーム
5. FriendlyShootGame - 非暴力シューティング
6. AnimalChaseGame - 動物追跡ゲーム
7. DreamyJumpGame - 夢世界ジャンプゲーム
8. MagicalCollectGame - 魔法収集ゲーム

Puzzle系（6種類）

9. MemoryMatchGame - 記憶マッチングゲーム
10. PuzzlePrincessGame - お姫様パズルゲーム
11. SpotDifferenceGame - 間違い探しゲーム
12. CountStarGame - 星数えゲーム
13. NumberHuntGame - 数字探しゲーム
14. OrderMasterGame - 順序整理ゲーム

Reaction系（4種類）

15. RainbowMatchGame - 虹色マッチングゲーム
16. SpeedFriendGame - 早押し友達ゲーム
17. OppositeActionGame - 反対行動ゲーム
18. ReactionSpeedGame - 反応速度ゲーム

Timing系（2種類）

19. TimingPerfectGame - 完璧タイミングゲーム
20. BalanceGame - バランス調整ゲーム

💻 技術スタック

フロントエンド

• React 18 + TypeScript - 型安全な開発
• Vite - 高速ビルド・開発サーバー
• PixiJS 7.x - 軽量2Dゲームエンジン
• PWA - オフライン対応・インストール可能

バックエンド

• Supabase - PostgreSQL + 認証 + ストレージ
• Row Level Security - データ安全性確保
• Edge Functions - サーバーレス処理
• Stripe - 決済・サブスクリプション管理

デプロイメント

• Vercel - 自動デプロイ・CDN
• GitHub Actions - CI/CD
• GitHub Codespaces - クラウド開発環境

🌐 デモ・リンク

• 本番サイト: playswizzle.com
• リポジトリ: GitHub - DondokodonGames/swizzle

📚 開発者向けドキュメント

• CLAUDE.md - Claude Code / Codex 向けコードベース参照ドキュメント

  • コマンド一覧（開発・AI生成・テスト）
  • アーキテクチャルール（contract.ts が唯一の正解）
  • 重要ファイル表・AIパイプライン・環境変数

• Swizzle JSON仕様書 - AIでゲームJSONを生成する際の完全な仕様書（v1.1）

  • エディターにインポート可能なJSON形式の詳細説明
  • 型定義、サンプルコード、トラブルシューティング
  • v1.1 新機能: delay / cancelDelay・rule.execution・setAnimationFromCounter・InputZone

🚀 セットアップ・開発

開発環境構築

1. リポジトリクローン

   git clone https://github.com/DondokodonGames/swizzle.git
   cd swizzle
   

2. 依存関係インストール

   npm install
   

3. 環境変数設定

   cp .env.example .env.local
   # .env.local に Supabase接続情報を設定
   

4. 開発サーバー起動

   npm run dev
   

5. AIゲーム生成

   npm run ai:v2:1          # 1本生成（ANTHROPIC_API_KEY 必須）
   npm run ai:neta:1        # netaリストから1本生成
   npm run ai:status        # 生成進捗・品質統計
   DRY_RUN=true npm run ai:v2:1   # LLM呼び出しなし（テスト用）
   

Supabase設定

-- ユーザープロフィール拡張
CREATE TABLE profiles (
  id UUID REFERENCES auth.users ON DELETE CASCADE PRIMARY KEY,
  username VARCHAR(50) UNIQUE,
  display_name VARCHAR(100),
  avatar_url TEXT,
  age INTEGER,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

-- ユーザー作成ゲーム
CREATE TABLE user_games (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  creator_id UUID REFERENCES profiles(id) ON DELETE CASCADE NOT NULL,
  title VARCHAR(200) NOT NULL,
  template_id VARCHAR(50) NOT NULL,
  game_data JSONB NOT NULL,
  is_published BOOLEAN DEFAULT false,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

-- お気に入り機能
CREATE TABLE game_favorites (
  user_id UUID REFERENCES profiles(id) ON DELETE CASCADE,
  game_id UUID REFERENCES user_games(id) ON DELETE CASCADE,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW(),
  PRIMARY KEY (user_id, game_id)
);

-- プレイリスト機能
CREATE TABLE playlists (
  id UUID DEFAULT gen_random_uuid() PRIMARY KEY,
  creator_id UUID REFERENCES profiles(id) ON DELETE CASCADE NOT NULL,
  title VARCHAR(200) NOT NULL,
  is_public BOOLEAN DEFAULT true,
  created_at TIMESTAMP WITH TIME ZONE DEFAULT NOW()
);

🎯 ロードマップ

✅ Phase 5: AI量産パイプライン（実装済み）

• 9ステップ自動生成: Concept → Design → AssetPlan → Spec → EditorMapper → LogicValidator → LogicRepairer → AssetGenerator → QualityScorer
• GitHub Actions 毎時自動生成: generate-games.yml で定期実行
• 新エンジン primitive: delay/cancelDelay・rule.execution・setAnimationFromCounter・InputZone

Phase 6 候補

• A. UI/UX完成: チュートリアル・設定画面・アニメーション強化
• B. マーケティング: SNS連携・自動投稿・ユーザー獲得
• C. 技術強化: パフォーマンス最適化・テストスイート強化

長期ビジョン

• 1000本ゲーム: AI自動生成によるコンテンツ大量準備
• グローバル展開: 多言語対応・地域別最適化
• エデュケーション: 教育機関向け機能・プログラミング学習支援
• メタバース連携: 仮想世界でのゲーム体験・ソーシャル機能強化

📊 プロジェクト統計

• 開発期間: 100日計画（進行中）
• 予算: 10万円
• 開発体制: 一人開発
• テンプレート数: 20種類 完成
• 技術負債: 最小限（型安全性・エラーハンドリング完備）
• パフォーマンス: モバイル60FPS・3秒以内ロード達成

🤖 GitHub Actions 自動生成の設定

GitHubリポジトリの Settings > Secrets and variables > Actions で 以下のシークレットを設定してください。

シークレット名	内容
ANTHROPIC_API_KEY	AnthropicのAPIキー
OPENAI_API_KEY	OpenAIのAPIキー（画像生成用、省略時はモック）
VITE_SUPABASE_URL	SupabaseのプロジェクトURL
VITE_SUPABASE_ANON_KEY	Supabaseの匿名キー
SUPABASE_SERVICE_ROLE_KEY	Supabaseのサービスロールキー
SUPABASE_MASTER_USER_ID	ゲーム投稿に使うマスターユーザーID

設定後、Actions タブ > Auto Game Generation > Run workflow から手動実行して動作確認してください。

デフォルトは毎時3件・1時間ごとに自動実行されます。
件数・頻度はワークフローファイル (.github/workflows/generate-games.yml) で変更できます。

---

🤝 コントリビューション

現在一人開発中ですが、将来的にはコントリビューション歓迎予定です。

興味のある分野

• 🎮 ゲームテンプレート: 新しいゲームアイデア・実装
• 🎨 UI/UX: デザイン改善・アクセシビリティ向上
• 🤖 AI活用: コンテンツ自動生成・品質向上
• 🌐 国際化: 多言語対応・地域別カスタマイズ

📄 ライセンス

MIT License - 詳細は LICENSE ファイルを参照

📞 連絡先

• GitHub: @DondokodonGames
• プロジェクト: Short Game Platform

---

🏆 達成状況

Phase 1: ████████████████████████████████ 100% (テンプレート実装)
Phase 2: ████████████████████████████████ 100% (エラーハンドリング)
Phase 3: ████████████████████████████████ 100% (Supabase統合)
Phase 4: ████████████████████████████████ 100% (決済システム)
Phase 5: ████████████████████████████████ 100% (AI量産パイプライン)

🚀 本番稼働中: playswizzle.com