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.