To start working with the Hey monorepo, ensure the following tools are installed:

• Node.js (v22 or higher) - the JavaScript runtime used in this project.
• pnpm - the package manager used throughout this repository.
• Postgres App - the Postgres database used in development.

This repository uses pnpm workspaces to manage multiple packages within a monorepo structure.

git clone git@github.com:bigint/hey.git

On macOS, you can install both with Homebrew:

brew install nvm pnpm

Use nvm to install the required Node.js version:

nvm install

From the repository root, install dependencies with pnpm:

pnpm install

Copy the .env.example file to .env for each package or application that requires configuration:

cp .env.example .env

Repeat this process for all relevant packages and applications in the monorepo.

The example environment files define the following variables:

• PRIVATE_KEY - Private key used to sign Lens requests.
• SHARED_SECRET - Token for internal API authorization.

To run the application in development mode:

pnpm dev

Compile the application:

pnpm build

Validate the codebase with the TypeScript type checker:

pnpm typecheck

Check code quality and formatting with Biome:

pnpm biome:check

Automatically fix linting and formatting issues:

pnpm biome:fix

Convenient Node.js helpers are in the script directory:

• node script/clean.mjs removes all node_modules, .next directories, pnpm-lock.yaml, and tsconfig.tsbuildinfo files.
• node script/update-dependencies.mjs updates packages across the monorepo, removes old installs and commits the changes in a new branch.
• node script/sort-package-json.mjs sorts all package.json files in the repository.

This project is released under the GNU AGPL-3.0 license. See the LICENSE file for details

🌸