feat(mobile): add forui UI library and upgrade Flutter to 3.38

- Add forui ^0.17.0 as UI component library (shadcn-ui style for Flutter)
- Upgrade Flutter SDK from 3.32 to 3.38, Dart SDK from 3.8 to 3.10
- Integrate FTheme with system brightness detection in main.dart
- Add FLocalizations delegates for i18n support
- Fix Riverpod dependencies (3.0.x) and retrofit_generator (10.x) versions
- Update README.md and README.ko.md with correct Flutter version
- Fix lint-format-guide.md with accurate Biome/Ruff configurations

Author: gracefullight

.agent/rules/lint-format-guide.md

@@ -50,7 +50,7 @@ See `biome.json` at project root.
 - Indent: 2 spaces
 - Quotes: double
 - Semicolons: required
-- Trailing commas: all
+- Trailing commas: ES5
 - Line width: 100
 
 ### Lint Categories
@@ -88,8 +88,8 @@ See `biome.json` at project root.
 See `ruff.toml` in `apps/api/` and `apps/worker/`.
 
 ### Key Rules
-- Line length: 100
-- Target: Python 3.13
+- Line length: 88
+- Target: Python 3.12
 - Indent: 4 spaces
 - Quotes: double
 
@@ -99,8 +99,10 @@ See `ruff.toml` in `apps/api/` and `apps/worker/`.
 - **I**: isort (import sorting)
 - **UP**: pyupgrade
 - **B**: flake8-bugbear
+- **S**: bandit (security)
 - **SIM**: flake8-simplify
 - **ASYNC**: flake8-async
+- **RUF**: Ruff-specific
 
 ### Editor Integration
 ```json
@@ -147,29 +149,30 @@ terraform validate
 
 ## Pre-commit Hooks
 
-Husky + lint-staged runs on every commit:
+mise runs tasks on every commit via git hooks:
 
-```json
-// package.json
-{
-  "lint-staged": {
-    "*.{js,jsx,ts,tsx,json,css,md}": [
-      "biome check --write"
-    ]
-  }
-}
+```bash
+# Setup git hooks (run once)
+git config core.hooksPath .git/hooks
+
+# Create pre-commit hook
+echo '#!/bin/sh
+mise git:pre-commit' > .git/hooks/pre-commit
+chmod +x .git/hooks/pre-commit
+
+# Create commit-msg hook  
+echo '#!/bin/sh
+mise git:commit-msg "$1"' > .git/hooks/commit-msg
+chmod +x .git/hooks/commit-msg
 ```
 
-For Python, add to `.pre-commit-config.yaml`:
-```yaml
-repos:
-  - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.8.0
-    hooks:
-      - id: ruff
-        args: [--fix]
-      - id: ruff-format
-```
+The pre-commit task runs lint for changed apps:
+- `apps/api/` changes → `mise //apps/api:lint`
+- `apps/web/` changes → `mise //apps/web:lint`
+- `apps/worker/` changes → `mise //apps/worker:lint`
+- `apps/mobile/` changes → `mise //apps/mobile:lint`
+
+The commit-msg task validates commit messages using commitlint.
 
 ## CI Integration
 

README.ko.md

@@ -10,7 +10,7 @@
 graph TB
     subgraph Client["클라이언트"]
         Web[Next.js 16<br/>React 19]
-        Mobile[Flutter 3.32<br/>Riverpod]
+        Mobile[Flutter 3.38<br/>Riverpod]
     end
 
     subgraph GCP["GCP Cloud Run"]
@@ -43,7 +43,7 @@ graph TB
 
 ## 주요 기능
 
-- **모던 스택**: Next.js 16 + React 19, FastAPI, Flutter 3.32, TailwindCSS v4
+- **모던 스택**: Next.js 16 + React 19, FastAPI, Flutter 3.38, TailwindCSS v4
 - **타입 안전성**: TypeScript, Pydantic, Dart 전체 타입 지원
 - **인증**: better-auth 기반 OAuth (Google, GitHub, Facebook)
 - **국제화**: next-intl (웹), Flutter ARB (모바일), 공용 i18n 패키지
@@ -59,7 +59,7 @@ graph TB
 |--------|------|
 | **프론트엔드** | Next.js 16, React 19, TailwindCSS v4, shadcn/ui, TanStack Query, Jotai |
 | **백엔드** | FastAPI, SQLAlchemy (async), PostgreSQL 16, Redis 7 |
-| **모바일** | Flutter 3.32, Riverpod 3, go_router 17, Firebase Crashlytics, Fastlane |
+| **모바일** | Flutter 3.38, Riverpod 3, go_router 17, Firebase Crashlytics, Fastlane |
 | **워커** | FastAPI + CloudTasks/PubSub |
 | **인프라** | Terraform, GCP (Cloud Run, Cloud SQL, Cloud Storage, CDN) |
 | **CI/CD** | GitHub Actions, Workload Identity Federation |
@@ -139,7 +139,8 @@ fullstack-starter/
 │   ├── mobile/        # Flutter 모바일 앱
 │   └── infra/         # Terraform 인프라
 ├── packages/
-│   └── i18n/          # 공용 다국어 패키지 (Source of Truth)
+│   ├── i18n/          # 공용 다국어 패키지 (Source of Truth)
+│   └── shared/        # 공용 유틸리티
 ├── .agent/rules/      # AI 에이전트 가이드라인
 ├── .serena/           # Serena MCP 설정
 └── .github/workflows/ # CI/CD
@@ -177,6 +178,7 @@ mise tasks --all
 | `mise //apps/api:test` | 테스트 실행 |
 | `mise //apps/api:lint` | 린터 실행 |
 | `mise //apps/api:format` | 코드 포맷 |
+| `mise //apps/api:typecheck` | 타입 체크 |
 | `mise //apps/api:migrate` | 마이그레이션 실행 |
 | `mise //apps/api:migrate:create` | 새 마이그레이션 생성 |
 | `mise //apps/api:gen:openapi` | OpenAPI 스키마 생성 |
@@ -194,6 +196,8 @@ mise tasks --all
 | `mise //apps/web:build` | 프로덕션 빌드 |
 | `mise //apps/web:test` | 테스트 실행 |
 | `mise //apps/web:lint` | 린터 실행 |
+| `mise //apps/web:format` | 코드 포맷 |
+| `mise //apps/web:typecheck` | 타입 체크 |
 | `mise //apps/web:gen:api` | API 클라이언트 생성 |
 
 </details>
@@ -207,6 +211,7 @@ mise tasks --all
 | `mise //apps/mobile:build` | 빌드 |
 | `mise //apps/mobile:test` | 테스트 실행 |
 | `mise //apps/mobile:lint` | 분석기 실행 |
+| `mise //apps/mobile:format` | 코드 포맷 |
 | `mise //apps/mobile:gen:l10n` | 다국어 파일 생성 |
 | `mise //apps/mobile:gen:api` | API 클라이언트 생성 |
 
@@ -220,6 +225,7 @@ mise tasks --all
 | `mise //apps/worker:dev` | 워커 시작 |
 | `mise //apps/worker:test` | 테스트 실행 |
 | `mise //apps/worker:lint` | 린터 실행 |
+| `mise //apps/worker:format` | 코드 포맷 |
 
 </details>
 
@@ -260,8 +266,8 @@ packages/i18n/source/ja.arb  # 일본어
 # 빌드하여 각 앱에 배포
 mise i18n:build
 # 생성되는 파일:
-# - apps/web/messages/*.json (Nested JSON)
-# - apps/mobile/lib/l10n/app_*.arb (Flutter ARB)
+# - apps/web/src/config/messages/*.json (Nested JSON)
+# - apps/mobile/lib/i18n/messages/app_*.arb (Flutter ARB)
 ```
 
 ## 환경 설정

README.md

@@ -10,7 +10,7 @@ Production-ready fullstack monorepo template with Next.js 16, FastAPI, Flutter,
 graph TB
     subgraph Client
         Web[Next.js 16<br/>React 19]
-        Mobile[Flutter 3.32<br/>Riverpod]
+        Mobile[Flutter 3.38<br/>Riverpod]
     end
 
     subgraph GCP["GCP Cloud Run"]
@@ -43,7 +43,7 @@ graph TB
 
 ## Key Features
 
-- **Modern Stack**: Next.js 16 + React 19, FastAPI, Flutter 3.32, TailwindCSS v4
+- **Modern Stack**: Next.js 16 + React 19, FastAPI, Flutter 3.38, TailwindCSS v4
 - **Type Safety**: Full type support with TypeScript, Pydantic, and Dart
 - **Authentication**: OAuth with better-auth (Google, GitHub, Facebook)
 - **Internationalization**: next-intl (web), Flutter ARB (mobile), shared i18n package
@@ -59,7 +59,7 @@ graph TB
 |-------|------------|
 | **Frontend** | Next.js 16, React 19, TailwindCSS v4, shadcn/ui, TanStack Query, Jotai |
 | **Backend** | FastAPI, SQLAlchemy (async), PostgreSQL 16, Redis 7 |
-| **Mobile** | Flutter 3.32, Riverpod 3, go_router 17, Firebase Crashlytics, Fastlane |
+| **Mobile** | Flutter 3.38, Riverpod 3, go_router 17, Firebase Crashlytics, Fastlane |
 | **Worker** | FastAPI + CloudTasks/PubSub |
 | **Infrastructure** | Terraform, GCP (Cloud Run, Cloud SQL, Cloud Storage, CDN) |
 | **CI/CD** | GitHub Actions, Workload Identity Federation |
@@ -139,7 +139,8 @@ fullstack-starter/
 │   ├── mobile/        # Flutter mobile app
 │   └── infra/         # Terraform infrastructure
 ├── packages/
-│   └── i18n/          # Shared i18n package (Source of Truth)
+│   ├── i18n/          # Shared i18n package (Source of Truth)
+│   └── shared/        # Shared utilities
 ├── .agent/rules/      # AI agent guidelines
 ├── .serena/           # Serena MCP config
 └── .github/workflows/ # CI/CD
@@ -177,6 +178,7 @@ mise tasks --all
 | `mise //apps/api:test` | Run tests |
 | `mise //apps/api:lint` | Run linter |
 | `mise //apps/api:format` | Format code |
+| `mise //apps/api:typecheck` | Type check |
 | `mise //apps/api:migrate` | Run migrations |
 | `mise //apps/api:migrate:create` | Create new migration |
 | `mise //apps/api:gen:openapi` | Generate OpenAPI schema |
@@ -194,6 +196,8 @@ mise tasks --all
 | `mise //apps/web:build` | Production build |
 | `mise //apps/web:test` | Run tests |
 | `mise //apps/web:lint` | Run linter |
+| `mise //apps/web:format` | Format code |
+| `mise //apps/web:typecheck` | Type check |
 | `mise //apps/web:gen:api` | Generate API client |
 
 </details>
@@ -207,6 +211,7 @@ mise tasks --all
 | `mise //apps/mobile:build` | Build |
 | `mise //apps/mobile:test` | Run tests |
 | `mise //apps/mobile:lint` | Run analyzer |
+| `mise //apps/mobile:format` | Format code |
 | `mise //apps/mobile:gen:l10n` | Generate localizations |
 | `mise //apps/mobile:gen:api` | Generate API client |
 
@@ -220,6 +225,7 @@ mise tasks --all
 | `mise //apps/worker:dev` | Start worker |
 | `mise //apps/worker:test` | Run tests |
 | `mise //apps/worker:lint` | Run linter |
+| `mise //apps/worker:format` | Format code |
 
 </details>
 
@@ -260,8 +266,8 @@ packages/i18n/source/ja.arb  # Japanese
 # Build and deploy to each app
 mise i18n:build
 # Generated files:
-# - apps/web/messages/*.json (Nested JSON)
-# - apps/mobile/lib/l10n/app_*.arb (Flutter ARB)
+# - apps/web/src/config/messages/*.json (Nested JSON)
+# - apps/mobile/lib/i18n/messages/app_*.arb (Flutter ARB)
 ```
 
 ## Configuration

apps/mobile/lib/core/router/router.g.dart

@@ -6,6 +6,7 @@ import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:flutter_localizations/flutter_localizations.dart';
 import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:forui/forui.dart';
 
 import 'core/router/router.dart';
 import 'core/theme/app_theme.dart';
@@ -49,19 +50,26 @@ class MyApp extends ConsumerWidget {
   @override
   Widget build(BuildContext context, WidgetRef ref) {
     final router = ref.watch(routerProvider);
+    final brightness = MediaQuery.platformBrightnessOf(context);
+    final isDark = brightness == Brightness.dark;
+    final fTheme = isDark ? FThemes.zinc.dark : FThemes.zinc.light;
 
-    return MaterialApp.router(
-      title: 'Fullstack Starter',
-      theme: AppTheme.light,
-      darkTheme: AppTheme.dark,
-      themeMode: ThemeMode.system,
-      routerConfig: router,
-      localizationsDelegates: const [
-        GlobalMaterialLocalizations.delegate,
-        GlobalWidgetsLocalizations.delegate,
-        GlobalCupertinoLocalizations.delegate,
-      ],
-      supportedLocales: const [Locale('ko'), Locale('en'), Locale('ja')],
+    return FTheme(
+      data: fTheme,
+      child: MaterialApp.router(
+        title: 'Fullstack Starter',
+        theme: AppTheme.light,
+        darkTheme: AppTheme.dark,
+        themeMode: ThemeMode.system,
+        routerConfig: router,
+        localizationsDelegates: const [
+          GlobalMaterialLocalizations.delegate,
+          GlobalWidgetsLocalizations.delegate,
+          GlobalCupertinoLocalizations.delegate,
+          ...FLocalizations.localizationsDelegates,
+        ],
+        supportedLocales: const [Locale('ko'), Locale('en'), Locale('ja')],
+      ),
     );
   }
 }