Next.js 15 App Router and React 19, using TypeScript
Next.jsReactStarter
web3-app-template — Next.js Starter Template
By samueldanso
A Web3 application starter template based on Next.js App Router, Wagmi, and Privy, with built-in wallet connection, balance query, and chain switching examples.
Explore the design
Compare the page layouts and mobile experience. Open any screenshot for a closer look.
Desktop homepage1 / 2
Desktop captureTop of page
Actual screenshot captured by the server browser.
All pages & views 2
Screenshots show visual appearance; interactive behavior may differ.
Recorded 2026-10-14View source
What stands out
A quick read of the recorded project description.
Web3 integration via Wagmi v2 and Privy, with React Query handling data fetching
Supports Ethereum Mainnet and Sepolia, including chain switching and network detection examples
Tailwind CSS with Shadcn/ui, providing themes and dark mode
Built-in Error Boundaries and examples of error handling for Web3 operations
Provides bun scripts: dev, build, start, lint, format, check, type-check
Template Details
This template is used to build decentralized application frontends. The README states that it is based on Next.js 15 App Router and React 19, uses TypeScript and Tailwind CSS, and integrates Shadcn/ui components, themes, and dark mode, while also providing Error Boundaries for error handling. The Web3 part is connected through Wagmi v2 and Privy, supports Ethereum Mainnet and Sepolia, and uses React Query for data fetching. The README's Web3 integration section lists examples such as wallet connection, a custom hook for fetching balances, chain switching and network detection, and error handling for Web3 operations. Development scripts include dev, build, start, lint, format, check, and type-check, with bun used for package management. The deployment section gives a Vercel workflow: push code to GitHub, connect the repository in Vercel, add environment variables in the console, and then deploy. The README does not provide information about contract interaction, backend services, or testing.
Next.jsStarter
Is it right for your project?
Use Cases
- Building a DApp frontend from scratch that needs wallet connection and balance display
- Verifying chain switching and network detection logic on Ethereum Mainnet or Sepolia
- Customizing interface themes and dark mode based on Shadcn/ui and Tailwind
- Deploying a Web3 frontend with Privy environment variables via Vercel
Suitable For
- Frontend developers using Next.js App Router and TypeScript
- Web3 projects that need to integrate wallets using Wagmi and Privy together
- DApp prototype development that wants to start with ready-made components and themes
Getting started & customization
Use these recorded setup notes alongside the repository instructions for your chosen version.
- 1
After cloning the repository, run bun install to install dependencies
- 2
Copy .env-example to .env, and fill in NEXT_PUBLIC_PRIVY_APP_ID and NEXT_PUBLIC_CHAIN_ID (Sepolia is 11155111, Mainnet is 1)
- 3
Run bun dev to start the development server, and visit http://localhost:3000
- 4
When deploying to Vercel, the above environment variables need to be configured in the console
License & source material
Usage conditions & limitations
Free to use · keep license noticeThis entry covers the free version under the MIT license in a public repository; the free scope is the code of that version and does not mean that external services or third-party assets are free.
Must comply with when using
- The code of this version may be used, modified, used commercially, and distributed for free.
- When distributing copies or substantial portions of the code, retain the original author's copyright notice and the complete MIT license notice.
- The code is provided as is; warranties and limitations of liability are governed by the original license and applicable law.
Additional costs & items to verify
- Demo images, fonts, icons, and other third-party assets need to be checked against their respective licenses and cannot be judged solely by the code's MIT license.
- External services such as domains, hosting, databases, payments, or AI may incur separate charges.
- Using Privy wallet login requires applying for NEXT_PUBLIC_PRIVY_APP_ID in the Privy console yourself, which is an external service account requirement.
- The NEXT_PUBLIC_CHAIN_ID environment variable needs to be configured; use 11155111 for Sepolia and 1 for Mainnet.
- When deploying to Vercel, environment variables need to be added separately in the Vercel console.
View Original Text Basis
Permission is hereby granted, free of charge
Original License Text
- `NEXT_PUBLIC_PRIVY_APP_ID`: Get from [Privy](https://dashboard.privy.io/)
Original README
- `NEXT_PUBLIC_CHAIN_ID`: Use `11155111` for Sepolia or `1` for Mainnet
Original README
https://github.com/samueldanso/web3-app-template/blob/main/LICENSE.txthttps://github.com/samueldanso/web3-app-template/blob/main/README.md3. Add your environment variables in Vercel dashboard
Original README
Compiled by DeepSeek based on repository license and README ·2026-10-14. Results only cover the materials read; dependencies, images, fonts, and subsequent term changes are subject to their respective original texts.
Project checks & description sources
Template Information
- Source platforms
- GitHub
- Documentation and maintenance reference score
- Partly documented · 74 / 100
- Technologies
- Next.js · React
- Website type
- Starter
How this score is calculated
Our heuristic uses license records (up to 30), a demo link (12), a preview (10), stars (15), recorded maintenance (15), description completeness (8), feature records (5) and classification data (5). It is not a code, security or performance test, or a Google score. A link does not establish tested functionality.
What to verify for this project
- Repository update recorded
- 2025-09-16
- Screenshot last checked
- 2026-10-14
A demo link is listed. Check it with your own content and viewport sizes; its presence does not confirm that forms, authentication or payments work.
The catalog identifies Next.js as the primary stack. Check the actual dependency manifest and lockfile for versions and hosting requirements. These notes use recorded metadata, not a code audit or a deployment test.
Use a selection guide →How this description was prepared
AI-assisted description based on catalog records and repository material. Repository authors are not automatically the reviewers of this description.
Review declaration: codex-user-requested-batch-review-20261017 · 2026-10-16
Inspect the recorded source material
SHA-256: 02f6ac57ce1613fc9c2fea802be960bfe70eb0a51bc6eee8342ab6ec0fa96dd3
2026-10-14T12:43:48.930Z
Source file / repository# Web3 Starter Kit
A modern, production-ready starter template for building decentralized applications with sensible defaults.
See deployed website: [web3-app-template.vercel.app](https://web3-app-template.vercel.app/)
## ✨ Features
- **Next.js 15** with App Router and React 19
- **Web3 Integration** with Wagmi v2 and Privy
- **React Query** for data fetching
- **Ethereum Network** support (Mainnet & Sepolia)
- **TypeScript** for type safety
- **Tailwind CSS** with theming and dark mode support
- **Shadcn/ui** for a large range of fully customizable and themable components
- **Error Boundaries** for graceful error handling
## 🚀 Quick Start
1. **Clone or use as template**
```bash
git clone https://github.com/samueldanso/web3-app-template.git
cd web3-app-template
```
2. **Install dependencies**
```bash
bun install
```
3. **Set up environment variables**
```bash
cp .env-example .env
```
Fill in your environment variables:
- `NEXT_PUBLIC_PRIVY_APP_ID`: Get from [Privy](https://dashboard.privy.io/)
- `NEXT_PUBLIC_CHAIN_ID`: Use `11155111` for Sepolia or `1` for Mainnet
4. **Start development server**
```bash
bun dev
```
5. **Open your browser**
Navigate to [http://localhost:3000](http://localhost:3000)
## 🛠️ Development
### Available Scripts
- `bun dev` - Start development server with Turbopack
- `bun build` - Build for production
- `bun start` - Start production server
- `bun lint` - Run biome lint
- `bun format` - Run biome format
- `bun check` - Run biome format and lint
- `bun type-check` - Run TypeScript type checking
### Web3 Integration
The template includes examples of Web3 integration:
- Wallet connection with RainbowKit
- Balance fetching with custom hooks
- Chain switching and network detection
- Error handling for Web3 operations
## 🌐 Deployment
### Vercel (Recommended)
1. Push your code to GitHub
2. Connect your repository to [Vercel](https://vercel.com)
3. Add your environment variables in Vercel dashboard
4. Deploy!
## 📚 Documentation
- [Next.js Documentation](https://nextjs.org/docs)
- [Wagmi Documentation](https://wagmi.sh)
- [Privy Documentation](https://docs.privy.io/basics/react/installation)
- [Shadcn/ui Documentation](https://ui.shadcn.com)
Explore similar templates
Compare previews and descriptions within the same stack and category.
Next.js SaaS Starter
The official Next.js SaaS starter template, integrating email/password authentication, Stripe Checkout subscriptions, a dashboard with user/team CRUD, basic Owner/Member RBAC, and activity logging.
Next.js · SaaS
Next.js Commerce
Vercel's officially maintained Next.js App Router ecommerce starter with deep Shopify integration, offering a complete product catalog, cart, and checkout flow. Core logic is modular for swapping backends, and community provider versions exist for BigCommerce, Medusa, and Saleor.
Next.js · E-commerce
Next-js-Boilerplate
A developer-first Next.js 16 starter with Tailwind CSS 4 and TypeScript, supporting both App Router and Page Router.
Next.js · Starter
tailwind-nextjs-starter-blog
A Next.js and Tailwind CSS blog starter template using Contentlayer for Markdown/MDX, with built-in SEO, code highlighting, and tags. It targets personal technical blogs and migration from Jekyll/Hugo to React, and supports one-click Vercel deployment.
Next.js · Blog
next-forge
next-forge is a Turborepo-based Next.js template maintained by Vercel, positioned as a starting point for SaaS products.
Next.js · Starter
SaaS-Boilerplate
SaaS-Boilerplate is an open-source SaaS starter template built with Next.js App Router, React 19, TypeScript, Tailwind CSS, and Shadcn UI.
Next.js · SaaS