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

• Node.js (v18 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 [email protected]:heyverse/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:

• NEXT_PUBLIC_LENS_NETWORK – Lens network to use (mainnet, testnet, or staging).
• DATABASE_URL – Connection string for the main Postgres database.
• LENS_DATABASE_URL – Read-only Postgres connection for Lens data.
• REDIS_URL – Redis connection string for caching.
• PRIVATE_KEY – Private key used to sign Lens requests.
• EVER_ACCESS_KEY – Access key for 4EVERLAND storage.
• EVER_ACCESS_SECRET – Secret key for 4EVERLAND storage.
• SHARED_SECRET – Token for internal API authorization.
• OPENROUTER_API_KEY – API key for OpenRouter AI services.

• VITE_IS_PRODUCTION – Boolean flag indicating production mode for Vite.
• NEXT_PUBLIC_LENS_NETWORK – Lens network used by the web app.

To run the application in development mode:

pnpm dev

Generate Prisma clients and GraphQL types across all workspaces:

pnpm codegen

Compile the application:

pnpm build

Validate the codebase with the TypeScript type checker:

pnpm typecheck

Execute unit tests across all workspaces:

pnpm test

Each workspace provides its own vitest.config.ts, so test behavior is scoped to that package. Vitest prints a summary for each workspace showing how many files and tests passed along with the execution time.

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.

🌸