Holaplex Hub Starter

A template repository to help you build NFT based applications using the Holaplex Hub.

Includes:

• NextJS 13 web framework (app directory enabled)
• Postgres database management using Prisma ORM
• User management with social based login through next-auth
• Style application using Tailwind
• Holaplex Hub SDK

Folder Structure

/prisma
  schema.prisma # prisma schema file
  /migrations # prisma auto-generated migration files
/src
 /app # next js app directory
 /pages
   /api # next js api routes
 /modules # utility clients and functions
   db.ts # prisma db client
   holaplex.ts # configured holaplex client
 /queries # holaplex api queries
 /mutations # holaplex api mutations

Getting Started

Ensure you have nodejs and docker installed on your workstation.

# start postgres in a docker container
docker compose up -d

# install dependencies
npm install

# setup database
npm run reset

# setup prisma client
npm run generate

# boot up the app
npm run dev

See your app at http://localhost:3000

Environment

Create a .env file at the root of the project. Add the following environment variable.

NEXT_PUBLIC_FQDN=http://localhost:3000

# setup SSO with Google
GOOGLE_CLIENT_ID=
GOOGLE_CLIENT_SECRET=

# database
DATABASE_URL=postgres://postgres:holaplex@localhost:5432/hub-starter
POSTGRES_DB=hub-starter
POSTGRES_PASSWORD=holaplex

# holaplex
HOLAPLEX_API_ENDPOINT=
HOLAPLEX_AUTH_TOKEN=
HOLAPLEX_WEBHOOK_SECRET=
HOLAPLEX_PROJECT_ID=

Migrations

Follow the Prisma guide on adjusting the database through migrations. Once the Prisma schema has been adjusted run npm run migrate.

Release

# build and run the app
docker build . -t {org}/{app}:{tag}
docker run {org}/{app}-app:{tag}