Polkadot Next.js Starter

August 28, 2025 ยท View on GitHub

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)

Polkadot Next.js Starter

Deploy a template

Choose a branch to clone and deploy with one click:

Deploy papi (reactive-dot)

Deploy typink (dedot)

Branch links:

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.