Polkadot Next.js Starter

This repository provides a landing (on main) and two full, cloneable templates for building Polkadot dApps:

• papi + reactive-dot (branch: papi)
• dedot + typink (branch: typink)

Deploy a template

Choose a branch to clone and deploy with one click:

Branch links:

• papi: https://github.com/niklasp/polkadot-nextjs-starter/tree/papi
• typink: https://github.com/niklasp/polkadot-nextjs-starter/tree/typink

Features

• Integration with Polkadot API for blockchain interactions. Using lightclients per default. Storage subscriptions, storage queries and transactions. Proper loading states for individual components that require a chain connection for best UX.
• Server rendered pages with client components where needed with**Next.js 15.x**
• Modern, full-control react components with shadcn ui
• Utility-first CSS with Tailwind CSS 4.0 Data-fetching library for managing server state.
• Light and dark modes / theme management with Next Themes

Project Structure

• app/: Main application files including layout and page components.
• components/: Contains UI components like PolkadotLogo, Footer, and Nav.
• providers/: Context providers for themes, Polkadot extensions, and blockchain connections.
• hooks/: Example hooks with subscriptions.
• lib/: utility functions

Installation

1. Clone the repository:

   git clone https://github.com/niklasp/polkadot-nextjs-starter.git

2. Install dependencies:

   cd polkadot-nextjs-starter
   pnpm install

3. Run the development server:

   pnpm dev

Contributing

Contributions are welcome! Please open an issue or submit a pull request for any improvements or bug fixes.

License

This project is open-source and available under the MIT License.