Support

The starter should be easy to debug.

A base project only stays valuable if the next person can understand it quickly. These support notes define the places to look first when something breaks.

Start With NextBase Read the Docs

Environment Problems

Start with env validation and verify auth, database, upload, and email variables are set to coherent values.

This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.

Auth Issues

Check Better Auth session behavior, callback URLs, and whether Mailpit or Resend is configured for the current environment.

This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.

Database Problems

Verify schema generation and push steps have run and that the configured Postgres instance is reachable.

This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.

Verification Failures

Run lint, typecheck, build, component tests, and Playwright before assuming the issue is runtime-only.

This page is intentionally lightweight so the starter demonstrates complete routing, metadata, and layout coverage without pretending to ship an entire marketing site.