UZU Docs

Appearance

JavaScript 開発ガイド ​

サービス横断的な JavaScript/TypeScript 開発に関するドキュメント。

概要 ​

このセクションでは、UZU プロジェクト全体で共通する JavaScript/TypeScript の開発ガイドライン、ベストプラクティス、共通ツールについて説明します。

共通技術スタック ​

  • フレームワーク: Next.js 15
  • 言語: TypeScript
  • スタイリング: Tailwind CSS
  • 状態管理: Apollo Client (GraphQL)
  • テスト: Jest, Vitest
  • コード品質: ESLint, Prettier
  • パッケージ管理: npm, Turbo

開発環境 ​

bash
# JavaScript 開発環境のチェック
task js:doctor

# 初期化
task js:init

# 開発サーバー起動
task js:dev SERVICE=<service-name>

コーディング規約 ​

共通コマンド ​

bash
# リント実行
npm run lint

# フォーマット
npm run format

# GraphQL コード生成
npm run gen

# 型チェック
npx tsc --noEmit

パッケージ構成 ​

JavaScript プロジェクトは Turbo を使用したモノレポ構成：

  • javascript/apps/ - アプリケーション
  • javascript/packages/ - 共有パッケージ
  • javascript/configs/ - 設定ファイル

テスト戦略 ​

  1. 単体テスト: 個別のコンポーネント・関数
  2. 統合テスト: API エンドポイント
  3. E2E テスト: ユーザーフロー

パフォーマンス最適化 ​

  • Next.js の Image Optimization
  • Code Splitting
  • Lazy Loading
  • React.memo の適切な使用