1. Next.jsフロントエンドプロジェクトのブートストラップ

Next.js App Router (TypeScript) + Tailwind CSS + Shadcn UI

Next.jsのPages/App RouterはフルスタックReactフレームワークです。柔軟性に優れ、小規模から大規模までのReactアプリケーション構築を支援します。新しいNext.jsプロジェクトの作成を開始するには、ターミナルで次のコマンドを実行します。

npx create-next-app@latest my-app --typescript --tailwind --eslint

ターミナルに次のようなプロンプトが表示されます:

プロジェクト名は何にしますか? my-app
TypeScriptを使用しますか? いいえ / はい
ESLintを使用しますか? いいえ / はい
Tailwind CSSを使用しますか? いいえ / はい
`src/` ディレクトリを使用しますか? いいえ / はい
App Routerを使用しますか?(推奨) いいえ / はい
デフォルトのインポートエイリアス(@/*)をカスタマイズしますか? いいえ / はい
設定するインポートエイリアスを入力してください: @/*

各プロンプトに対して、以下のオプションを選択します:

プロジェクト名は何にしますか? my-app
TypeScriptを使用しますか? はい # 現在TypeScriptが最も推奨される選択肢です
ESLintを使用しますか? はい # コードをリントするためのESLint
Tailwind CSSを使用しますか? はい # インターフェースを迅速に構築するためのTailwind CSS
`src/` ディレクトリを使用しますか? いいえ # 不要なためsrcディレクトリは使用しません
App Routerを使用しますか?(推奨) はい # 最新のNext.js機能を活用するためにApp Routerを使用します
デフォルトのインポートエイリアス(@/*)をカスタマイズしますか? いいえ # カスタマイズせずデフォルトを使用します

問題が発生した場合は、Next.jsのドキュメントを参照してください:https://nextjs.org/docs

cd ディレクトリに移動し(my-app または任意の名前)、次のコマンドを実行してShadcn UIをインストールします

npx shadcn-ui@latest init

セットアップのための次のプロンプトが表示されます components.json:

使用するスタイルを選択してください: › Default
ベースカラーとして使用する色を選択してください: › Slate
カラーにCSS変数を使用しますか? › いいえ / はい

お好みに合わせて選択できますが、このブートキャンプでは以下を選択します:

使用するスタイルを選択してください: › Default
ベースカラーとして使用する色を選択してください: › Slate
カラーにCSS変数を使用しますか? › はい

詳細については、Shadcn UIのチュートリアルをご覧ください:https://ui.shadcn.com/docs/installation/next

Shadcn UIの特別な機能として、ライブラリがプロジェクト内に直接 components フォルダを次のように作成します:

.
└── components
    ├── ui
    │   ├── button.tsx
    │   ├── input.tsx
    │   ├── card.tsx
    │   └── form.tsx  
    └── authentication-menu.tsx

以下のフォルダ内のコンポーネントを使用して ui 独自の カスタムコンポーネントを構築します。たとえば上記では、4つのコンポーネントを使用して button.tsx, input.tsx, card.tsx および form.tsx カスタムコンポーネントを作成しています。 authentication-menu.tsx.

2. WalletConnectでプロジェクトを作成する

https://cloud.walletconnect.com/sign-inにアクセスします。

アカウントを作成し、ダッシュボードの指示に従ってプロジェクトIDを設定します。

WalletConnectはプロジェクトIDを使用して接続リクエストを追跡します。

Wagmi + Rainbowkit + Tanstack React Query

Wagmiは、インターフェースをより迅速に構築するためのReact Hookライブラリです。特にWagmiは、ウォレットの接続、トランザクションの開始、ノードからの結果返待ちと処理、エラーハンドリング、トランザクションの成功ステータスに至るまで、トランザクションのライフサイクル全体を管理するための便利なReact Hookを提供します。トランザクションのライフサイクルを適切に管理することでユーザーエクスペリエンスが向上し、自身の活動内容を把握しやすくなります。

Rainbowkitと共通のwagmiライブラリをインストールします

npm install @rainbow-me/rainbowkit wagmi viem@2.x @tanstack/react-query

次に、 providers.tsx ファイルを app ディレクトリに作成します

'use client';

import * as React from 'react';
import {
  RainbowKitProvider,
  getDefaultWallets,
  getDefaultConfig,
} from '@rainbow-me/rainbowkit';
import {
  trustWallet,
  ledgerWallet,
} from '@rainbow-me/rainbowkit/wallets';
import {
  klaytn, // import klaytn mainnet
  klaytnBaobab, // import klaytn testnet
} from 'wagmi/chains';
import { QueryClient, QueryClientProvider } from '@tanstack/react-query';
import { WagmiProvider, http } from 'wagmi';
// import according to docs

const { wallets } = getDefaultWallets();
// initialize and destructure wallets object

const config = getDefaultConfig({
  appName: 'MY_APP', // Name your app
  projectId: "WALLETCONNECT_PROJECT_ID", // Enter your WalletConnect Project ID here
  wallets: [
    ...wallets,
    {
      groupName: 'Other',
      wallets: [trustWallet, ledgerWallet],
    },
  ],
  chains: [
    klaytn,
    klaytnBaobab
  ],
  transports: {
    [klaytn.id]: http('https://rpc.ankr.com/klaytn'), // Select RPC provider Ankr instead of the default
    [klaytnBaobab.id]: http('https://rpc.ankr.com/klaytn_testnet'), // Select RPC provider Ankr instead of the default
  },
  ssr: true, // Because it is Nextjs's App router, you need to declare ssr as true
});

const queryClient = new QueryClient();

export function Providers({ children }: { children: React.ReactNode }) {
  return (
    <WagmiProvider config={config}>
      <QueryClientProvider client={queryClient}>
        <RainbowKitProvider>
          {children}
        </RainbowKitProvider>
      </QueryClientProvider>
    </WagmiProvider>
  );
}

次に、次のコードを next.config.mjs ファイル:

/** @type {import('next').NextConfig} */
const nextConfig = {
  ...
  reactStrictMode: true,
  webpack: config => {
    config.externals.push('pino-pretty', 'lokijs', 'encoding');
    return config;
  },
};

export default nextConfig;

次に、 <Providers> を children の layout.tsx ファイル内で次のように囲みます。

import type { Metadata } from "next";
import { Inter } from "next/font/google";
import "./globals.css";
import '@rainbow-me/rainbowkit/styles.css';
import { Providers } from './providers';

const inter = Inter({ subsets: ["latin"] });

export const metadata: Metadata = {
  title: "Klaytn DApp Bootcamp Frontends",
  description: "Interactive frontend for Klaytn DApp bootcamp contracts",
};

export default function RootLayout({
  children,
}: Readonly<{
  children: React.ReactNode;
}>) {
  return (
    <html lang="en">
      <body className={inter.className}>
        <Providers>
          {children}
        </Providers>
      </body>
    </html>
  );
}

3. ウォレット接続ボタン

その後、アプリケーションにインポートできます <ConnectButton /> をアプリにインポートします

import { ConnectButton } from '@rainbow-me/rainbowkit';

export default function Home() {

  return (
    <div className="flex flex-col gap-8 items-center justify-center py-12 px-4 p-48:lg">
      <ConnectButton />
    </div>
  );
}

設定の詳細については、RainbowKitのドキュメントをご覧ください: https://www.rainbowkit.com/docs/installation

完全なソースコードへのリンク: Github