1. 初始化 Next.js 前端项目
NextJS App Router (Typescript) + TailwindCSS + Shadcn UI
Next.js Pages/App Router 是一个全栈 React 框架。该框架具有极高的灵活性,可助你构建规模不一的 React 应用。要开始创建新的 Next.js 项目,请在终端中运行以下命令:
npx create-next-app@latest my-app --typescript --tailwind --eslint你将在终端中看到以下提示:
项目名称是什么?my-app
是否使用 TypeScript?No / Yes
是否使用 ESLint?No / Yes
是否使用 Tailwind CSS?No / Yes
是否使用 `src/` 目录?No / Yes
是否使用 App Router?(推荐)No / Yes
是否自定义 默认的 import 别名(@/*)?No / Yes
希望配置什么导入别名?@/*对于每个提示,请选择以下选项:
项目名称是什么?my-app
是否使用 TypeScript?Yes # 目前 TypeScript 是首选
是否使用 ESLint?Yes # 使用 ESLint 规范代码
是否使用 Tailwind CSS?Yes # 使用 Tailwind CSS 快速编写界面
是否使用 `src/` 目录?No # 不使用 src 目录,因为没有必要
是否使用 App Router?(推荐)Yes # 使用 App Router 以充分利用最新的 Next.js 功能
是否自定义 默认的 import 别名(@/*)?No # 否,使用默认如果遇到问题,请访问 Next.JS Docs:https://nextjs.org/docs
cd 进入你的目录(my-app 或你所选的其他名称)并运行以下命令以安装 Shadcn UI
npx shadcn-ui@latest init你将看到以下用于设置 components.json:
希望使用哪种样式?› Default
希望将哪种颜色用作基础色?› Slate
是否希望将 CSS 变量用于颜色?› no / yes你可以根据个人喜好进行选择,不过在本训练营中,你将选择:
希望使用哪种样式?› Default
希望将哪种颜色用作基础色?› Slate
是否希望将 CSS 变量用于颜色?› yes通过 ShadcnUI 的教程了解更多信息: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(Project ID)。
WalletConnect 将使用你的项目 ID 来跟踪连接请求。
Wagmi + Rainbowkit + Tanstack React Query
Wagmi 是一个用于快速构建界面的 React Hook 库。特别是,Wagmi 还提供了便捷的 React Hook,能够管理交易的整个生命周期,基本上从连接钱包、发起交易,到等待节点返回结果并处理错误或交易成功状态。妥善管理交易的整个生命周期有助于提升用户体验,让他们清晰了解自己的操作。
你将把 wagmi 库与 Rainbowkit 一起安装
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 上的完整源代码