Hey.xyz

Hey is a decentralized and permissionless social media application built with Lens Protocol.

Open Source Snapshot Notice

This repository represents the last publicly available open-source version of Hey.xyz before May 15, 2026.

Development and changes made to Hey.xyz after May 15, 2026 are currently not open source and are not included in this repository.

This repository is therefore preserved as a historical open-source snapshot of the Hey.xyz codebase as it existed before that date.

Hey is a decentralized social network built on top of the Lens Protocol.

The application provides a social experience where users can create profiles, publish content, interact with other users, and participate in a permissionless social network powered by blockchain technology.

This repository contains the source code for the open-source version of Hey that was available before May 15, 2026.

This repository should be considered a historical snapshot, rather than the current production source code of Hey.xyz.

The production version of Hey.xyz may contain features, architectural changes, infrastructure changes, security improvements, and other modifications that are not present in this repository.

The purpose of this repository is to preserve and provide access to the codebase that was publicly available prior to the transition.

No claim is made that this repository represents the current implementation running on Hey.xyz.

This version of Hey is built using modern web and Web3 technologies, including:

• TypeScript
• React
• Next.js
• Tailwind CSS
• GraphQL
• Lens Protocol
• Wagmi
• Viem
• PostgreSQL
• pnpm
• Node.js

The repository is structured as a monorepo and contains the application source code and supporting development tooling.

Before running the project locally, make sure you have the following installed:

• Node.js v22 or later
• pnpm
• PostgreSQL
• Git

Using NVM is recommended for managing Node.js versions.

git clone https://github.com/slymnoyann/hey.xyz.git
cd hey.xyz

If you are using a fork or another copy of this repository, replace the URL accordingly.

If the repository contains an .nvmrc file, you can use:

nvm install
nvm use

Verify your Node.js version:

node -v

If pnpm is not already installed:

npm install -g pnpm

Verify the installation:

pnpm -v

From the repository root:

pnpm install

The application requires environment variables for local development and certain services.

Where .env.example files are provided, copy them to .env before starting the application.

For example:

cp .env.example .env

Depending on the package or application being used, additional environment configuration may be required.

Typical configuration may include:

• Lens configuration
• Database connection
• Redis configuration
• API authentication
• Wallet/private key configuration
• Storage configuration
• Application configuration

Never commit private keys, API secrets, database credentials, or other sensitive values to Git.

Use local .env files for development and properly managed secrets for production environments.

Start the development environment with:

pnpm dev

Once the development server is running, open the local URL displayed in the terminal.

To create a production build:

pnpm build

Run TypeScript type checking with:

pnpm typecheck

Check the codebase for formatting and linting issues:

pnpm biome:check

Automatically fix supported formatting and linting issues:

pnpm biome:fix

The repository follows a monorepo-style structure.

Some of the main directories and files include:

.
├── .github/
├── .husky/
├── .vscode/
├── public/
├── script/
├── src/
├── .gitignore
├── .nvmrc
├── biome.json
├── ecosystem.config.cjs
├── generated.ts
├── index.html
├── package.json
├── pnpm-lock.yaml
├── possible-types.ts
├── tsconfig.json
└── vite.config.mjs

The exact structure may vary between historical commits and branches.

The repository includes several scripts for development and maintenance.

node script/clean.mjs

This can be used to clean generated files and installed dependencies.

node script/update-dependencies.mjs

node script/sort-package-json.mjs

This repository contains a historical version of Hey and may require adjustments to run against currently available third-party infrastructure.

In particular, external services and protocols may have changed since this version was published, including:

• Lens Protocol APIs
• GraphQL endpoints
• RPC endpoints
• Third-party APIs
• Database schemas
• Authentication systems
• Storage providers
• Blockchain networks
• Wallet infrastructure

As a result, a successful local build does not necessarily mean that the application can be deployed to production without modification.

Contributions to this historical snapshot are welcome through forks and pull requests where appropriate.

However, please keep in mind that this repository represents a historical open-source version of Hey and does not represent the current private development codebase of Hey.xyz.

This repository is provided for archival, educational, research, and development purposes.

It represents the open-source Hey.xyz codebase available before May 15, 2026.

Features and development introduced after May 15, 2026 are currently not included because the corresponding source code is not publicly available.

The current Hey.xyz application may differ substantially from the code contained in this repository.

This project is released under the GNU Affero General Public License v3.0 (AGPL-3.0).

See the LICENSE file for the complete license text.

Hey was created as a decentralized and permissionless social network built with Lens Protocol.

This repository preserves an important point in the project's development history: the final open-source state of the application before May 15, 2026.

If you are studying the architecture, experimenting with Lens-based social applications, or interested in the evolution of decentralized social networks, this repository can serve as a reference implementation for that period.

Hey.xyz

A historical open-source snapshot of Hey before May 15, 2026. 🌿