No testing infrastructure — missing test runner, config, and example tests

[mahdirajaee]

Description

The project currently has no testing setup. There is no test runner (Jest, Vitest, Playwright, Cypress), no test configuration, and no example tests in the repository.

For a starter template that handles payments, authentication, and user data, this is a significant gap. Developers forking this for production use need a testing foundation.

Suggested Approach

Unit/Integration tests with Vitest (fast, native ESM, works great with Next.js):

• Stripe webhook handler tests (mock Stripe events, verify DB state)
• Supabase auth flow tests
• API route handler tests

E2E tests with Playwright:

• Sign-up / sign-in flow
• Subscription checkout flow
• Billing portal redirect

Minimum viable addition

At minimum, a vitest.config.ts and one example test for the webhook handler would give developers a starting point they can extend.

Would the maintainers be open to a PR adding a basic Vitest setup with a few critical-path tests?

[m13v]

setting up testing for a Supabase + Stripe stack is one of those things everyone knows they should do but nobody wants to start. the webhook handler tests are the highest ROI since a broken webhook silently loses revenue. what worked well for us: Vitest for the webhook handler with mocked Stripe events, and Playwright for the auth + checkout flow. the tricky part is testing the Supabase auth flow since you need a real or emulated Supabase instance, docker compose handles that cleanly for CI.

[m13v]

for the Playwright side specifically, we open sourced a browser management layer that handles parallel test workers without session corruption, which is important when running auth + checkout flows concurrently in CI: https://github.com/m13v/browser-lock/blob/main/playwright-lock.sh

[KolbySisk]

This is intentional. The original goal of this repo was to keep the infra minimal and not opinionated. I have considered adding tests though. I would likely do mocked integration tests with Playwright. Open to hear opinions though.