saucebase-dev/saucebase/saucebase-testing

Saucebase Testing

Write the failing test first, then the code that makes it pass.

Which suite

Vitest runs in a Node environment with no Vite plugins, so it can't render components; Playwright covers those.

Commands

php artisan test --compact tests/Feature/SomeTest.php
php -d memory_limit=2048M artisan test --testsuite=Modules --filter='^Modules\\Auth\\Tests'
npm run test:unit
npx playwright test --project="@auth*"     # one module; core specs are "@Core*"

Run module suites with a 2048 MB memory limit, as CONTRIBUTING.md does.

playwright.config.ts gets every project from core's saucebaseProjects(): database.setup, the modules' setups, then the app's own and one per installed module, each per device. Project names are @<module> [<device>], so filter with a trailing *. Every project depends on database.setup. A module tunes its project from its own playwright.config.ts, which exports playwright, an object typed satisfies ModulePlaywrightOptions (import type { ModulePlaywrightOptions } from '@saucebase/core/modules'):

PHPUnit base class

Tests\TestCase seeds the database ($seed = true) and forces Vite to the build manifest, so a missing manifest entry fails locally as it does in CI. createUser() returns a user with the user role.

Playwright

Specs import test and expect from @e2e/fixtures; see .ai/rules/e2e-tests.md. Helpers in tests/e2e/helpers: loginAs, expectAuthenticated, expectGuest (auth.ts), isModuleInstalled (modules.ts), expectSSREnabled, expectSSRDisabled, expectInertiaPageDataEmbedded (ssr.ts).

tests/Support is the PHP side of those helpers: Playwright calls AuthHelper, TestFixtures, and ModuleSupport through laravel.callFunction(). TestFixtures::seedSharedAccounts() runs once in database.setup, because seeding per test races between parallel workers; credentials() creates fresh admin and user accounts for each test.

Isolating tests that touch files

A test that runs commands writing to the application root (Boost, installers) must point setBasePath() at a temporary directory, chdir() into it, and bind a fake ModuleRegistry, so the real vendor/, boost.json, and CLAUDE.md are never touched. tests/Feature/ModuleBoostIntegrationTest.php is the reference.

Before finishing

vendor/bin/pint --dirty --format agent
composer analyse
npm run lint