Prerequisites

Everything you need installed and access to before running TestoQA locally.

Required toolchain

• Node.js v22 or higher
• PNPM v10 or higher
• PostgreSQL v15 or higher
• Docker (optional, for Docker-based setup)

Required software

Node.js

Use Node LTS unless the repo specifies otherwise.

• Recommended: Node 22 LTS
• If your team pins versions, use the repo’s .nvmrc / .node-version.

Verify:

node -v

Package manager

We recommend pnpm for speed and workspace support.

• Recommended: pnpm v10

Verify:

pnpm -v

Prefer not to use npm/yarn to ensure lockfile remain consistent with your team’s and CI/CD workflow.

Git

Verify:

git --version

Docker

We use Docker for local dependencies like Postgres/Redis (and sometimes services). Verify:

docker --version
docker compose version

PostgreSQL

PostgreSQL is used as the primary database.

• Recommended version: PostgreSQL 15 or newer
• Deployment options: Local installation or Docker container

Local Installation

Download and install PostgreSQL from the official website: 👉 PostgreSQL Downloads 

Verify the installation:

psql --version

Docker Setup

If running PostgreSQL in Docker, confirm the container is running:

docker ps

Make sure you have the required connection details: host, port, username, password, and database name.

Access you may need

• Source repo access (GitHub/GitLab)
• Access to the shared .env values

Ask your team if you need help with access.

Optional but recommended

DB tools

you can use prisma studio or similar tools, but having a dedicated Postgres client is helpful for complex queries and data inspection.

• psql for Postgres or a GUI client for browsing data quickly
• pgAdmin  or TablePlus 

IDE setup

Suggested VS Code extensions (optional):

• ESLint
• Prettier
• Tailwind CSS IntelliSense (if Tailwind is used)
• Prisma (if Prisma is used)
• Docker extension