# Lottie アニメーション 投入先

このディレクトリに `.json` を配置すると、`AnimatedBadge` の `asset` で参照できます。

## 仕組み

```
設定の「アニメーションモード」    Lottie ファイル    実際の見た目
─────────────────────────────────────────────────────────
OFF                            (関係なし)          静止アイコン
ON                             配置あり            Lottie アニメ
ON                             配置なし            Flutter Animation で動く (motion 種別による)
```

## 既に参照されているアセット

`AnimatedBadge` の `asset` パラメータで指定済みのファイル名:

| ファイル名 | 利用箇所 | 推奨 motion (fallback) |
|---|---|---|
| `congrats.json` | 目標達成オーバーレイのトロフィー | bounce |
| `teacher.json`  | 先生モード ウェルカム画面のヒーローアイコン | pulse |

新しい場所に追加する場合は、`AnimatedBadge` の呼び出し時に
`asset: 'assets/animations/<名前>.json'` を渡し、対応する JSON をここに置きます。

## 推奨ソース

- **LottieFiles** (https://lottiefiles.com/) — 子供向け楽しい無料素材多数
  - 検索キーワード例: "celebration", "trophy", "teacher", "stopwatch", "music notes"
- **IconScout / Lordicon** — 商用利用可能な素材あり (要ライセンス確認)
- **AfterEffects + Bodymovin** — オリジナル制作

## ファイルサイズの目安

`AnimatedBadge` 用は **1 ファイル ≤ 50 KB** を推奨。読み込み速度と APK/IPA サイズへの影響を抑えるため。

## 投入時の注意

1. JSON のバージョン (`v` フィールド) は **5.x 以上** を推奨 (lottie パッケージ 3.x が安定対応)
2. アセット参照 (画像など) を含む Lottie はモバイル動作不安定。**シェイプアニメのみ** が望ましい
3. 投入後は `flutter clean` → 再ビルドで反映確認
