> ## Documentation Index
> Fetch the complete documentation index at: https://docs.molq.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Local development

> Run MolQ applications, contracts, indexer, and Mintlify documentation locally.

## Requirements

* Node.js 20.17 or newer.
* pnpm 10.
* Foundry.
* PostgreSQL for Ponder.

## Install

```bash theme={null}
git clone https://github.com/aliens101/molq.git
cd molq
pnpm install
cp apps/api/.env.example apps/api/.env
cp apps/indexer/.env.example apps/indexer/.env.local
```

Never commit private keys or API credentials.

## Run services

```bash theme={null}
pnpm dev:all
```

Run the landing page or docs separately:

```bash theme={null}
pnpm landing
pnpm docs
```

| Service | Default URL              |
| ------- | ------------------------ |
| Dapp    | `http://localhost:5173`  |
| Landing | `http://localhost:5174`  |
| API     | `http://localhost:8787`  |
| Ponder  | `http://localhost:42069` |
| Docs    | `http://localhost:3000`  |

## Validate

```bash theme={null}
pnpm build
pnpm test
pnpm docs:check
pnpm format:check
```

Contract-only validation:

```bash theme={null}
pnpm contracts:build
pnpm contracts:test
pnpm contracts:fmt
```