Web Front
Webフロントチームについて
CyberZのWebフロントチームは、開発・運用を行っている各Webアプリケーションに対して、ユーザーの使いやすいUI / UXを目指して日々改善を行なっております。
ここでは弊チームで大事にしている考え方をいくつかご紹介します。
1. 最新の技術を追い続ける
Webフロントは技術の進化が速く、日々新たな情報が発信されています。それら技術に対して、常にキャッチアップとアップデートを行い、ユーザー体験・サービスの安全性・開発効率の向上を目指しています。また、サービスを作って終わりにはせず、パフォーマンスや各種テスト、アクセシビリティにも意識を向けて実装を行っており、細かいところにも拘って日々業務を行なっております。
2. ユーザー体験向上を目指す
ユーザー体験を第一に考えて日々業務を行なっております。Webフロントエンドエンジニアという立場に拘らず、デザインや UI / UX に対しても意識を向け、デザイナーと連携して議論・改善に努めています。また、開発主導でデザインを行う機会も多くあり、チーム全員が技術を用いたユーザー体験の向上を図っております。
技術スタック
| ジャンル | |
|---|---|
| 言語 | React |
| Next.js | |
| TypeScript | |
| 状態管理 | MobX |
| Recoil | |
| UIライブラリ | Chakra UI |
| スタイル | styled-components |
| SCSS | |
| データフェッチ | axios |
| React Query | |
| テスト | Jest |
| React Testing Library | |
| その他 | Storybook |
| Zod | |
| React Hook Form |
React
TypeScript との親和性や hooks の使いやすさ、CyberZのWebチームには実装経験のあるメンバーが多かったことから複数のプロダクトで採用しています。アップデートの頻度が高いことも、導入において安心材料になっています。基本的には、functional component で実装を進めており、hooks など React の基本 API を全て活用して実装を進めています。
実装の中での工夫としては、各ページの機能的な実装をカスタムフックを用いて行なっていることです。ファイル構成を見た目の部分(view.tsx)と機能(hook.ts)と分けることで、コードの可読性の向上を測っています。
TypeScript
静的型チェックによる保守性と開発効率の向上を目的に採用しました。型定義をしなければならない分の実装量は増えますが、長期的にみてコードの補完やバグの発見などを考慮したところ、メリットの方が大きいと感じたため使用しています。また、中途半端に型を使うと TypeScript の良さを活かせないため、any は原則禁止にして実装を行なっております。
Next.js
ルーティング周りやホットリロードなど、環境構築を全て任せられることで初期コストが小さく済む点が魅力的です。Next.js の SSG / SSR や各種 API を積極的に利用しており、基本的には Next.js のバージョンアップに合わせて、アップデートと機能の追加を行なっております。
実装の中での工夫としては、Next.js の pages ディレクトリには Next.js 特有の処理しか記述しない点です。Next.js では、pages ディレクトリ配下がそのままページのパスとして利用できますが、pages 配下の各ページに対して各UI・各機能を実装するとコードが煩雑になるため、 pages ディレクトリと対になる形の命名で components ディレクトリを追加し、UIや機能を実装するような方針を取っております。
Recoil
Redux など他の状態管理ライブラリと比べて、複数の Atom(管理場所)を用意することができるので、役割毎にデータを保持できる点で採用しています。また、hooks の概念を踏襲して開発されているため、React との親和性が高く、コードの見通しの良さや、学習コストの低さも良さだと考えています。
具体的な使用方法としては、極力 Recoil に頼ることはせず、サービス全体で保持しておきたい状態に対してのみ Recoil で管理する方針で実装を進めています。
Chakra UI
開発スピードの向上と、アクセシビリティの担保を理由にUIライブラリを使用しました。Chakra UI の選定理由は、他のUIライブラリと比べて、拡張性や学習コストの部分が魅力に感じたためです。また、props の型や独自の hook を提供している点も良さの一つとしてあり、UI以外の細かな点にも配慮されているなという印象がありました。
具体的な使い方としては、直接 Chakra UI のコンポーネントを使用しているわけではなく、Chakra UI の各コンポーネントだけを提供する package として切り出し、その切り出されたコンポーネントを使い回す形で使用しています。
React Query
取得したデータのキャッシュと更新を内部的に行なってくれる点に魅力を感じたため、データフェッチライブラリとして採用しました。似たライブラリとしてSWRも検討しましたが、SWR はサイズが軽量な分機能として最低限という印象があり、多機能で無理の効く方が安心ということで、React Query を採用しました。
具体的な使い方としては、React Query を用いたデータ取得には全てカスタムフック内で管理・実装を行なっております。また、データの取得のみならず、データの追加・更新・削除に対しても React Query を利用しており、API周りの実装には基本的に全て React Query を使用して実装を行なっております。React Query の key の管理方法に関しては、React Query 公式で書かれているブログを元にして行っております。
React Hook Form
少ないコード量で安全なフォームの実装を行えるため、React Hook Formを採用しました。Form の基本的な機能が Hooks として提供されているため使いやすいのも良さの一つだと感じています。値の検証の際に少し複雑な書き方になる点がありましたが、その課題に対して Zod を用いることで解決を図っております。具体的な使用方法も以下の記事に記載しております。
Zod
API レスポンスの値の検証や React Hook Form との親和性が高かったため採用しております。また、値を検証するだけでなく、その検証を行なったスキーマから型の生成まで行なってくれるため、安全に構造を定義することができるのが魅力でした。
具体的な使い方としては、サーバー側から返されるレスポンスの値を元にした、フロント側で使いやすい形のスキーマを定義します。そして、そのスキーマを用いた検証と、そのスキーマから生成した型を利用して、実装を行っております。
Storybook
Components を GUI で一覧管理できる面に良さを感じたため採用しております。小さな単位からページ全体まで管理できるため、デザイナーとの連携に使用できる点も魅力でした。
具体的な使い方としては、基本的に全てのコンポーネントに対して、Storybook を使用して管理を行なっております。
