PubKey Program Sandbox

Getting Started

Prerequisites

• Node v18 or higher
• PNPM
• Docker

Installation

Clone the repo and install dependencies:

git clone git@github.com:pubkeyapp/pubkey-program-sandbox.git
cd pubkey-program-sandbox
pnpm

Automatic setup

You can run the automatic setup script to create the .env file, test the setup and push the database schema.

pnpm setup

Environment variables

Copy the .env.example file to .env and fill in the missing values.

cp .env.example .env

Starting the services

You will need to start the database before starting the backend.

pnpm dev:services

Pushing the database schema

If you start from scratch, you will need to push the database schema to the database.

pnpm prisma db push

Also, after each change to the schema in prisma/schema.prisma, you will need to run the above command again.

Starting the API

pnpm dev:api

Starting the web ui

pnpm dev:web

Starting the SDK generator

pnpm dev:sdk

Extending the application

You can use the following commands to generate new models, API features, web features and SDK types.

Adding a new model

The following command will generate a new model in prisma/schema.prisma.

You will need to run pnpm prisma db push to push the schema to the database.

pnpm nx g prisma-model company

Output:

> NX Generating @pubkey-program-sandbox/tools:prisma-model

UPDATE prisma/schema.prisma

Adding a new API feature

The following command will generate a new API feature in libs/api/company/*.

You will need to restart the API server to make sure it picks up the new libraries.

pnpm nx g api-feature company

Output:

> NX Generating @pubkey-program-sandbox/tools:api-feature

CREATE libs/api/company/data-access/...
CREATE libs/api/company/feature/...
UPDATE libs/api/core/feature/src/lib/api-core-feature.module.ts
CREATE libs/sdk/src/graphql/feature-company.graphql
CREATE apps/api-e2e/src/api/api-company-feature.spec.ts

Adding a new web feature

The following command will generate a new web feature in libs/web/company/*.

You will need to restart the web server to make sure it picks up the new libraries.

pnpm nx g web-feature company

Output:

> NX Generating @pubkey-program-sandbox/tools:web-feature

CREATE libs/web/company/data-access/...
CREATE libs/web/company/feature/...
CREATE libs/web/company/ui/...
UPDATE libs/web/shell/feature/src/lib/shell-admin-routes.tsx
UPDATE tsconfig.base.json