hatk.dev
AppView in a box as a Vite plugin thing
hatk.dev
chadtmiller.com
1---
2title: Development
3description: Run and manage your Hatk server during development.
4---
5
6## `hatk dev`
7
8The primary development command. Starts the full development environment:
9
10```bash
11hatk dev
12```
13
14This runs three steps in sequence:
15
161. **Starts the local PDS** via Docker Compose (if `docker-compose.yml` exists)
172. **Seeds test data** by running `seeds/seed.ts`
183. **Starts the Hatk server** with file watching for hot reload
19
20The 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.
21
22## `hatk start`
23
24Start the Hatk server without the PDS or seeding. Use this in production.
25
26```bash
27hatk start
28```
29
30Loads `hatk.config.ts`, connects to the configured relay, and begins serving XRPC endpoints.
31
32## `hatk seed`
33
34Run your seed script against the local PDS.
35
36```bash
37hatk seed
38```
39
40Executes `seeds/seed.ts` to create test data. The PDS must be running first.
41
42## `hatk reset`
43
44Wipe the database and PDS for a clean development slate.
45
46```bash
47hatk reset
48```
49
50This removes the SQLite database file and resets the local PDS container, giving you a fresh start.
51