title: Development description: Run and manage your Hatk server during development.#

hatk dev#

The primary development command. Starts the full development environment:

hatk dev

This runs three steps in sequence:

1. Starts the local PDS via Docker Compose (if docker-compose.yml exists)
2. Seeds test data by running seeds/seed.ts
3. Starts the Hatk server with file watching for hot reload

The PDS health is checked at http://127.0.0.1:2583/xrpc/_health before proceeding. If it doesn't start within 30 seconds, the command exits.

hatk start#

Start the Hatk server without the PDS or seeding. Use this in production.

hatk start

Loads hatk.config.ts, connects to the configured relay, and begins serving XRPC endpoints.

hatk seed#

Run your seed script against the local PDS.

hatk seed

Executes seeds/seed.ts to create test data. The PDS must be running first.

hatk reset#

Wipe the database and PDS for a clean development slate.

hatk reset

This removes the SQLite database file and resets the local PDS container, giving you a fresh start.