1. Getting Started with Qualityfolio

Qualityfolio is a code-first quality management platform built on Test Management as Code (TMaC). It allows you to organize and version all your test artifacts, including test cases, suites, and projects, within a single, centralized system that uses a Markdown-based structure for consistency and clarity.

The platform integrates seamlessly with Surveilr to facilitate structured ingestion and tracking of test results. It supports both manual and automated test execution, giving teams the flexibility to adopt testing strategies that best fit their workflows.

Through its web-based dashboards, Qualityfolio provides complete visibility into test execution, defect metrics, and compliance tracking. Its built-in analytics capabilities also let you generate actionable insights using custom filters, charts, and trend analyses.

Watch the quick start video and learn how to get started.

2. Qualityfolio Requirements

2.1 Installing Surveilr – Method 1

Installation on macOS:

bash
brew tap surveilr/tap && brew install surveilr

Installation on Linux (Choose one of the three methods below):

2.1.1 Global installation:

bash
curl -sL https://raw.githubusercontent.com/opsfolio/releases.opsfolio.com/main/surveilr/install.sh | SURVEILR_HOME="$HOME/bin" bash

2.1.2 Installation in the current directory:

bash
curl -sL https://raw.githubusercontent.com/opsfolio/releases.opsfolio.com/main/surveilr/install.sh | bash

2.1.3 Installation in a custom directory:

bash
curl -sL https://raw.githubusercontent.com/opsfolio/releases.opsfolio.com/main/surveilr/install.sh | SURVEILR_HOME="/path/to/directory" bash

For more information, refer to the official Surveilr Installation Guide .

2.2 Installing Surveilr – Method 2

2.2.1 Open the terminal in Visual Studio Code and run the following commands one by one to install Surveilr:

bash
1. wget https://github.com/surveilr/packages/releases/download/3.5.0/surveilr_3.5.0_x86_64-unknown-linux-gnu.tar.gz

2. tar -xzf surveilr_3.5.0_x86_64-unknown-linux-gnu.tar.gz

3. sudo mv surveilr /usr/local/bin/

4. surveilr --version

5. sudo surveilr upgrade --yes

3. Installing Qualityfolio

Aside from installing Surveilr, no separate installation is required for Qualityfolio. Once Surveilr is set up, you can execute all Qualityfolio operations using the following commands from the integrated terminal.

3.1 Ingest project, test plan, test suite, or test cases:

bash
surveilr ingest files

3.2 Load the Qualityfolio package:

bash
surveilr shell https://www.surveilr.com/lib/service/qualityfolio/package.sql

3.3 Launch the web UI on localhost:3010

3.3.1 For macOS:

bash
SQLPAGE_SITE_PREFIX="/qualityfolio" surveilr web-ui -d "resource-surveillance.sqlite.db" --port 3010 --host $(ipconfig getifaddr en0)

3.3.2 For Linux:

bash
SQLPAGE_SITE_PREFIX="/qualityfolio" surveilr web-ui -d "resource-surveillance.sqlite.db" --port 3010 --host localhost

Once launched, Qualityfolio will be accessible at: 👉 http://127.0.0.1:3010/qualityfolio

Sample Test Artifacts

To quickly get started with Qualityfolio, download the Qualityfolio Sample Artifacts .