ZEBEDEE Next.js Dev Playground

Developer Playground for testing the ZEBEDEE API


bitcoin ln payments

license PRs Welcome


Live Dev Playground · 1-Click Deploy · Developer Dashboard



This is a starter kit for building fullstack applications using Next.js react framework alongside ZEBEDEE for global instantaneous Bitcoin payments.

This starter kit also emcompasses a Dev Playground (see /pages/playground.js) where ZEBEDEE-enabled modules can be used / tested.

Deploy with Vercel

Installation & Setup

First you must install the project's dependencies:

npm run dev
# or
yarn dev

Then you must create a .env.local file in the root directory with your ZEBEDEE API key, like so:

ZEBEDEE_API_KEY=xxxxxxxxxxxxxxxx

You may also simply rename the .env.local.example file to .env.local.

That's it! You're all set.

Starting Dev Server

To start the dev server run:

npm run dev
# or
yarn dev

Open http://localhost:3000 with your browser to see the result.

File Structure

You can start editing the project page by modifying pages/index.js. There is additional comments throughout this file as well. The page should auto-update as you edit the file. Any JS page inside of pages are treated as React components that can be rendered on the application.

Specifically, check out /pages/index.js and /pages/playground.js as they are the two main pages available in this starter kit.

The pages/api directory is mapped to /api/*. Files in this directory are treated as API routes and effectively make up your project's backend APIs. The backend API is using the @zbd/node SDK library for Node.js to interact with the ZEBEDEE API.

The main goal for this starter kit is to provide ample resources around source code that can be used to speed up your development of ZEBEDEE-powered applications.

Learn More

To learn more about ZEBEDEE, take a look at the following resources:

  • ZEBEDEE Documentation Portal - documentation, guides, and walkthroughs
  • GitHub - ZEBEDEE's org GitHub account with lots of example source code and open source SDK libraries
  • Discord Dev Chat - join other developers discussing ZEBEDEE integration topics

To learn more about Next.js, take a look at the following resources:

Deploy on Vercel

To make the most out of this Playground, deploy the project to Vercel using the Deploy button below and pass your ZEBEDEE API Key in the settings. This will spin up an instance of the Dev Playground connected to YOUR ZEBEDEE account.

Deploy with Vercel