hookify

Open-source token launch protocol on Uniswap v4 — monorepo for the dApp, API, and marketing site.

What is Hookify?

Hookify lets anyone launch a token on Ethereum with a single transaction. Under the hood it:

1. Deploys a new ERC-20 token
2. Creates a Uniswap v4 pool with a custom hook
3. Configures buy/sell fees that flow to the creator's vault
4. Locks initial liquidity permanently

The protocol is fully non-custodial — creators claim their trading revenue directly from the on-chain vault.

Monorepo Structure

hookify/
├── artifacts/
│   ├── app/              # dApp — launch, trade, dashboard, explorer (React + Vite)
│   ├── api-server/       # Indexer + REST API (Express + Drizzle)
│   └── hookify-web/      # Marketing site (React + Vite)
├── hookify-contracts/    # Solidity contracts (see hookify-contracts repo)
├── lib/
│   ├── db/               # Database schema and migrations
│   ├── api-spec/         # OpenAPI specification
│   ├── api-zod/          # Generated Zod validators
│   └── api-client-react/ # Generated React Query hooks
└── scripts/              # Build and deployment utilities

Related Repositories

Repo	Description
hookify-contracts	Solidity smart contracts
hookify-shared	Shared TypeScript libraries

Prerequisites

• Node.js >= 20
• pnpm >= 9
• PostgreSQL >= 15

Local Development

# 1. Clone
git clone https://github.com/hookify-protocol/hookify
cd hookify

# 2. Install dependencies
pnpm install

# 3. Configure environment
cp .env.example .env
# Edit .env with your values (see Environment Variables below)

# 4. Set up database
cd lib/db && pnpm db:push && cd ../..

# 5. Start all services
pnpm dev

Services:

• dApp → http://localhost:5173
• API server → http://localhost:3001
• Marketing site → http://localhost:5174

Environment Variables

Copy .env.example and fill in the values:

cp .env.example .env

See .env.example for all required and optional variables.

Deployment

The app is designed to run on any Node.js host. The API server requires a PostgreSQL database.

# Build all packages
pnpm build

# Start production API server
pnpm --filter @hookify/api-server start

Architecture

User → dApp (React/Vite)
         ↓ REST API calls
       API Server (Express)
         ↓ reads/writes
       PostgreSQL (Drizzle ORM)
         ↑ indexes events from
       On-chain Indexers (3 workers)
         ↑ listens to
       Ethereum Mainnet (via RPC)

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

Security

Found a vulnerability? Please email security@hookify.xyz rather than opening a public issue.

License

MIT