Rework the Unit testing page for Strapi 5

[pwizla]

This PR merges content from 2 blog posts published on Unit testing and tries to update them for Strapi 5

TODO:

• integrate blog posts content
• refine content
• fix why example tests are failing
• rework content with the fixed test examples

Direct preview link 👉 here

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
documentation	Ready	Preview	Comment	Oct 3, 2025 2:48pm

[ancashoria]

Hey, it's great you're updating the testing page.
I'm trying to setup a Strapi testing environment using sqlite and I'd like to mention one thing I have stumbled upon because it seems it's still present in the updated article.

This section: https://documentation-git-cms-testing-reworked-strapijs.vercel.app/cms/testing#set-up-a-testing-environment

When I have two different files for the database config, only one of them ends up in dist/config/database.js and since my test setup uses the dist folder, my test setup breaks if I run yarn dev setup.

const app = await createStrapi({
      appDir: "./",
      distDir: "./dist",
    }).load();

Basically if I run yarn test after yarn dev, my testing fails.

Hopefuly this helps somehow.

[ancashoria]

Is there a way to bootstrap the sqlite db based on a template? My API tests expect some data already configured.

[pwizla]

Hi @ancashoria, thanks for your interest and kind words regarding this PR :)

To be honest, I only have basic experience with testing, but as a technical writer for Strapi, I’m doing my best, with the help of AI-based tools, to update this page. I’m afraid your feedback points to issues that are a bit beyond my current skill set, but I’ll try to get help from Strapi engineers to improve the PR (it still needs their review, anyway 👀).

I’ll keep you posted!