ludiscan-webapp

分析ツールのwebapp

開発環境

• Node.js: 24.9.x
• Bun: 1.3.x

セットアップ

# Bunのインストール (Homebrew)
brew install bun

# 依存関係のインストール
bun install

# 開発サーバーの起動
bun run dev

API スキーマファイルの生成

• swagger.json を rootに配置し以下を実行する

bun run generate:api-schemes

Storybook 起動

bun run storybook

開発・運用方針

依存パッケージ

使用するライブラリやパッケージは十分に運用実績があり, 今後も継続的なメンテナンスが見込まれるものを導入する. 現時点では, 以下のフレームワーク・ライブラリを導入しています (主なものを以下に記載しています)

• Next.js
• React
• Redux Toolkit
• TanStack Query (旧 React Query)
• Emotion
• three.js

Emotion によるスタイリング

HTMLElement に対してスタイリングする実装は使用しません.
HTML タグがわかりづらい, 機能をもったコンポーネントと識別がしづらいなどがあげられます.

コンポーネントに対してスタイリングする実装を採用しています.

styled-components の使用ルールを定める | styled-componentsの採用と既存資産を捨てた理由

ブランチ戦略

• develop: デフォルトブランチ

  • 手動デプロイが可能
  • 開発環境として使用

• main: 本番環境用ブランチ

  • プッシュ時に自動デプロイ
  • 本番環境として使用

デプロイ

このプロジェクトはAWS Amplifyでデプロイを管理しています。

build設定はamplify.ymlに記載されてい流ものが実行されます.

デプロイフロー

1. 開発はdevelopブランチで行います
2. 本番or開発環境へのデプロイは以下のいずれかの方法で行います：
   • developブランチから手動デプロイ
   • mainブランチへのプッシュで自動デプロイ