メインコンテンツへスキップ
見出し画像

Supabase × Next.jsアプリにZustandを導入する理由と実装例

    フロントエンドの状態管理ライブラリには色々ありますが、
    今回のSupabase × Next.js アプリでは、軽量でシンプルなZustandを導入することで、セッションやプロフィール情報の管理をグッと効率化できました。

    zustandとは?

    zustandは、Reactで使える軽量な状態管理ライブラリです。
    💡一言でいうと、
    どのコンポーネントからでも、共通のデータを扱える仕組み!

    なぜ使うのか?

    Supabaseなどの外部サービスから毎回データを取得すると、
    ページを移動するたびに通信が発生して表示が遅くなることがあります。

    そこでZustandを使えば…

    • ✅ 一度だけ取得したデータを保存できる
      (=グローバル状態管理)

    • ✅ どのコンポーネントからでも簡単にアクセスできる

    • ✅ Supabaseとの通信を最小限にできる
      → アプリが速くて軽くなる!

    たとえば「ユーザー情報」をzustandに保存すれば、
    ログイン後のナビゲーションバーやプロフィール画面でも再取得せずに使い回せるようになります。

    Zustand 導入ガイド(TypeScript対応)

    ①パッケージのインストール(npm)

    npm install zustand

    ②ストア(状態管理ファイル)の作成
    例)

    // store.ts
    import { create } from "zustand";
    import type { Database } from "@/app/lib/database.types"; // Supabaseの型がある場合
    
    type ProfileType = Database["public"]["Tables"]["profiles"]["Row"];
    
    type StateType = {
      user: ProfileType;
      setUser: (payload: ProfileType) => void;
    };
    
    const useStore = create<StateType>((set) => ({
      user: {
        id: "",
        email: "",
        name: "",
        introduce: "",
        avatar_url: "",
      },
      setUser: (payload) => set({ user: payload }),
    }));
    
    export default useStore;

    ③ 状態をセットするクライアントコンポーネントを作成

    // components/ClientUserSetter.tsx
    "use client";
    
    import { useEffect } from "react";
    import type { Session } from "@supabase/auth-helpers-nextjs";
    import type { Database } from "@/app/lib/database.types";
    import useStore from "../../store";
    
    type Profile = Database["public"]["Tables"]["profiles"]["Row"];
    
    export default function ClientUserSetter({
      session,
      profile,
    }: {
      session: Session | null;
      profile: Profile | null;
    }) {
      const { setUser } = useStore();
    
      useEffect(() => {
        if (!session || !profile) return;
    
        setUser({
          id: session.user.id,
          email: session.user.email ?? "",
          name: profile.name,
          introduce: profile.introduce,
          avatar_url: profile.avatar_url,
        });
      }, [session, profile, setUser]);
    
      return null;
    }

    ④ layout.tsx や page.tsx 内で ClientUserSetter を読み込む

    // app/layout.tsx
    import ClientUserSetter from "./components/ClientUserSetter";
    import { SupabaseLisner } from "./components/supabase-lisner"; // サーバー側でsession取得する関数
    
    export default async function RootLayout({ children }: { children: React.ReactNode }) {
      const { session, profile } = await SupabaseLisner();
    
      return (
        <html lang="jp">
          <body>
            <ClientUserSetter session={session} profile={profile} />
            <main>{children}</main>
          </body>
        </html>
      );
    }

    ⑤ どのコンポーネントでも useStore() で状態を取得!

    // 例:Navigation.tsx
    "use client";
    
    import useStore from "../../store";
    
    const Navigation = () => {
      const { user } = useStore();
    
      return <div>{user.name} さん、こんにちは!</div>;
    };

    Zustandを使うメリットまとめ

    • Supabaseから取得した情報を 一度で保持 → 再取得不要

    • useState や useContext よりも コードがシンプル

    • グローバルな状態管理が簡単にできる

    • アプリが高速・軽量化

    最後に

    Next.js × Supabase のアプリ開発では、状態管理の効率化がUX向上のカギ。
    Zustand を活用すれば、コードの保守性・アプリのパフォーマンスもグッと良くなります!

    「まずは小さなデータから Zustand 管理してみよう!」という感覚で、ぜひ導入してみてください 🙌


     
     

    Naoya

     
     
    現役商社マン。 転職に向けてReactやNext.jsを中心に学習中。 学んだことをアウトプットする場としてnoteを始めました!

    あなたへのおすすめ