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를 사용하시겠습니까? 아니요 / 예
ESLint를 사용하시겠습니까? 아니요 / 예
Tailwind CSS를 사용하시겠습니까? 아니요 / 예
다음 경로를 사용하시겠습니까? `src/` 디렉터리를 사용하시겠습니까? 아니요 / 예
App Router를 사용하시겠습니까? (권장) 아니요 / 예
다음 항목을 사용자 정의하시겠습니까? 기본 import 별칭 (@/*)를 사용자 정의하시겠습니까? 아니요 / 예
어떤 임포트 별칭을 설정하시겠습니까? @/*각 프롬프트에서 다음 옵션을 선택합니다.
프로젝트 이름은 무엇인가요? my-app
TypeScript를 사용하시겠습니까? 예 # 현재 TypeScript가 가장 많이 선택되는 언어입니다
ESLint를 사용하시겠습니까? 예 # 코드 검사를 위해 ESLint를 사용합니다
Tailwind CSS를 사용하시겠습니까? 예 # Tailwind CSS 를 사용하여 인터페이스를 빠르게 작성하기
`src/`를 `src/` 디렉터리를 사용하시겠습니까? 아니요 # src 디렉터리는 필요하지 않으므로 사용하지 마세요
App Router를 사용하시겠습니까? (권장) 예 # App Router를 사용하여 최신 Next.js 기능을 최신 Next.js 기능을 활용하세요
다음 설정을 사용자 정의하시겠습니까? 기본 import 별칭(@/*)를 사용자 정의하고 싶으신가요? 아니요 # 아니요, 기본값 사용문제가 발생할 경우 다음 Next.JS 문서를 참조하세요: https://nextjs.org/docs
cd 디렉토리로 이동하여 (my-app 또는 선택하신 디렉토리명) 다음 명령어를 실행하여 Shadcn UI를 설치합니다.
npx shadcn-ui@latest init설정을 위해 다음과 같은 프롬프트가 표시됩니다. components.json:
어떤 스타일을 사용하시겠습니까? › 기본
어떤 색상을 사용하시겠습니까 기본 기본 색상으로? › 슬레이트
CSS 변수를 색상에 사용하시겠습니까? › 아니요 / 예선호도에 따라 선택할 수 있지만, 본 부트캠프에서는 다음과 같이 선택합니다.
어떤 스타일을 사용하시겠습니까? › 기본
어떤 색상을 사용하시겠습니까 기본 기본 색상으로? › 슬레이트
CSS 변수를 색상에 사용하시겠습니까? › 예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를 설정하세요.
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