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