hatk

Appearance

hatk build ​

Build the frontend for production using Vite.

bash
hatk build

Compiles and bundles the SvelteKit frontend in app/ into optimized production assets.

Deployment ​

To run in production:

  1. Build the frontend:

    bash
    hatk build

  2. Start the server:

    bash
    hatk start

  3. Configure environment variables for production:

    bash
    RELAY=wss://bsky.network \
DATABASE=data/hatk.db \
PORT=3000 \
hatk start

See Configuration for all available environment variables.

SQLite in production ​

hatk uses SQLite for all data storage. The DATABASE environment variable sets the path to the database file. In production, make sure this path points to a persistent volume.

Railway ​

Railway is a good fit for hatk apps. To deploy:

  1. Push your project to a Git repository

  2. Create a new Railway project linked to that repo

  3. Add a persistent volume mounted at /data

  4. Set environment variables:

    DATABASE=/data/hatk.db
RELAY=wss://bsky.network
PORT=3000

  5. Set the start command to hatk start

Railway will build and deploy automatically on push. The SQLite database file persists across deploys via the mounted volume.