Contributing

July 29, 2026 ยท View on GitHub

Thank you for helping improve Talivia.

Development setup

  1. Install Node.js 22 LTS or 24 LTS, pnpm 10+, and PostgreSQL.
  2. Copy .env.example to .env and set DATABASE_URL and a random APP_SECRET.
  3. Use a new, empty database.
  4. Run pnpm install --frozen-lockfile.
  5. Run pnpm exec prisma migrate deploy.
  6. Start the app with pnpm dev.

Before submitting a change, run:

pnpm lint
pnpm test
pnpm build

Add focused tests for behavior changes. Keep hosted-service billing, email or social login, commercial pages, and external insight-monitoring integrations out of the Open Source edition. Do not commit .env files, database dumps, build output, credentials, or customer data.

Database changes

Create forward-only Prisma migrations for schema changes. Do not rewrite an already released migration. Test migrations against a new PostgreSQL database and against a database from the previous Open Source release.

By contributing, you agree that your contribution is licensed under the MIT License.